创建航班套餐

2025-06-20

在 Microsoft Store 提交 API 中使用此方法为注册到您的合作伙伴中心帐户的应用创建包测试活动。

注释

此方法在无提交的情况下创建一个包飞行。要为软件包外部测试版创建提交，请参阅管理软件包外部测试版提交中的方法。

先决条件

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

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

请求

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

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

请求标头

标题	类型	DESCRIPTION
授权	字符串	必填。 Azure AD 访问令牌的格式为持有者令牌<>。

请求参数

名称	类型	DESCRIPTION
应用ID	字符串	必填。你想为其创建包测试飞行的应用商店 ID。有关应用商店 ID 的详细信息，请参阅 “查看应用标识详细信息”。

请求主体

请求正文具有以下参数。

参数	类型	DESCRIPTION	必选
友好名称	字符串	由开发人员指定的软件包航班的名称。	否
组 ID	数组	一个字符串数组，其中包含与软件包航班关联的航班组ID。有关外部测试版组的详细信息，请参阅软件包外部测试版。	否
rankHigherThan	字符串	当前套餐飞行之下一级的套餐飞行的友好名称。如果未设置此参数，新的软件包飞行将具有所有软件包飞行中的最高等级。有关排名航班组的详细信息，请参阅航班套餐。	否

请求示例

以下示例演示如何为商店 ID 为 9WZDNCRD911W 的应用创建新的软件包航班。

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

响应

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

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

响应体

价值	类型	DESCRIPTION
航班编号	字符串	包裹航班的 ID。此值由合作伙伴中心提供。
友好名称	字符串	请求中指定的软件包航班的名称。
组 ID	数组	包含在请求中指定的与软件包航班关联的航班组 ID 的字符串数组。有关外部测试版组的详细信息，请参阅软件包外部测试版。
rankHigherThan	字符串	在请求中指定的比当前包测试版本等级稍低的包测试版本的友好名称。有关排名航班组的详细信息，请参阅航班套餐。

错误代码

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

错误代码	DESCRIPTION
400	请求无效。
409	由于软件包飞行的当前状态，无法创建软件包飞行，或者应用使用了微软应用商店提交 API当前不支持的合作伙伴中心功能。

通过