获取应用
在 Microsoft Store 提交 API 中使用此方法,可检索注册到合作伙伴中心帐户的特定应用的相关信息。
必备条件
若要使用此方法,首先需要执行以下操作:
- 如果尚未开始操作,请先完成 Microsoft Store 提交 API 的所有先决条件。
- 获取 Azure AD 访问令牌,以供在此方法的请求标头中使用。 获取访问令牌后,在它到期前,你有 60 分钟的使用时间。 该令牌到期后,可以获取新的令牌。
请求
此方法具有以下语法。 请参阅以下部分,获取标头和请求正文的使用示例和描述。
方法 | 请求 URI |
---|---|
GET | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} |
请求头
标头 | 类型 | 说明 |
---|---|---|
授权 | 字符串 | 必需。 Azure AD 访问令牌的格式为 Bearertoken<>。 |
请求参数
名称 | Type | 说明 |
---|---|---|
applicationId | 字符串 | 必需。 要检索的应用的应用商店 ID。 有关应用商店 ID 的详细信息,请参阅查看应用标识详细信息。 |
请求正文
请勿为此方法提供请求正文。
请求示例
以下示例演示如何检索 Store ID 值为 9NBLGGH4R315 的应用的相关信息。
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315 HTTP/1.1
Authorization: Bearer <your access token>
响应
以下示例演示了成功调用此方法的 JSON 响应正文。 有关响应正文中这些值的更多详细信息,请参阅应用程序资源。
{
"id": "9NBLGGH4R315",
"primaryName": "ApiTestApp",
"packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
"packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
"publisherName": "CN=…",
"firstPublishedDate": "1601-01-01T00:00:00Z",
"lastPublishedApplicationSubmission": {
"id": "1152921504621086517",
"resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
},
"pendingApplicationSubmission": {
"id": "1152921504621243487",
"resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
},
"hasAdvancedListingPermission": false
}
错误代码
如果无法成功完成请求,该响应中会包含以下 HTTP 错误代码之一。
错误代码 | 说明 |
---|---|
404 | 找不到指定的应用。 |
409 | 应用使用的合作伙伴中心功能当前不受 Microsoft Store 提交 API 支持。 |