获取套餐机票

2025-06-10

使用 Microsoft Store 提交 API 的此方法来获取注册在您的合作伙伴中心帐户中的应用程序包飞行的数据。

先决条件

若要使用此方法，首先需要执行以下操作：

如果尚未这样做，请完成Microsoft应用商店提交 API 的所有先决条件。
获取 Azure AD 访问令牌，以供在此方法的请求标头中使用。获取访问令牌后，在它到期前，你有 60 分钟的使用时间。令牌过期后，可以获取一个新令牌。

请求

此方法具有以下语法。有关标头和请求正文的使用示例和说明，请参阅以下部分。

方法	请求 URI
获取	`https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}`

请求标头

标题	类型	DESCRIPTION
授权	字符串	必填。 Azure AD 访问令牌，形式为Bearer<token>。

请求参数

名称	类型	DESCRIPTION
应用ID	字符串	必填。包含要获取的软件包航班的应用的商店 ID。应用的商店 ID 可在合作伙伴中心获取。
航班编号	字符串	必填。要获取的软件包飞行的 ID。此 ID 可用于响应数据中，用于请求创建软件包航班以及请求获取应用的软件包航班。对于在合作伙伴中心创建的航班，此 ID 也可在合作伙伴中心航班页面的 URL 中找到。

请求主体

请勿为此方法提供请求主体。

请求示例

以下示例演示如何检索商店 ID 值为 9WZDNCRD91MD 的应用中，包航班 ID 为 43e448df-97c9-4a43-a0bc-2a445e736bcd 的信息。

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd HTTP/1.1
Authorization: Bearer <your access token>

响应

以下示例演示了成功调用此方法的 JSON 响应正文。有关响应正文中的值的更多详细信息，请参阅以下部分。

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

响应体

价值	类型	DESCRIPTION
航班编号	字符串	包裹航班的 ID。此值由合作伙伴中心提供。
友好名称	字符串	由开发人员指定的软件包航班的名称。
最新发布的航班提交	物体	一个对象，该对象提供有关软件包外部测试版上次发布的提交的信息。有关详细信息，请参阅下面的提交对象部分。
待提交的航班	物体	一个对象，该对象提供有关软件包外部测试版的当前挂起提交的信息。有关详细信息，请参阅下面的提交对象部分。
组 ID	数组	一个字符串数组，其中包含与软件包航班关联的航班组ID。有关航班组的详细信息，请参阅打包航班。
rankHigherThan	字符串	当前套餐飞行之下一级的套餐飞行的友好名称。有关排名航班组的详细信息，请参阅航班套餐。

提交对象

响应正文中的 lastPublishedFlightSubmission 和 pendingFlightSubmission 值包含的对象提供了关于提交包航班的资源信息。这些对象具有以下值。

价值	类型	DESCRIPTION
id	字符串	提交的ID。
resourceLocation	字符串	用于检索提交完整数据的相对路径，可以追加到基础 `https://manage.devcenter.microsoft.com/v1.0/my/` 请求 URI。

错误代码

如果请求无法成功完成，响应将包含以下 HTTP 错误代码之一。

错误代码	DESCRIPTION
400	请求无效。
404	找不到指定的软件包飞行。
409	应用使用的是合作伙伴中心的一项功能，该功能当前不受 Microsoft 应用商店提交 API的支持。