取得所有應用程式
在 Microsoft Store 提交 API 中使用此方法，擷取向合作夥伴中心帳戶註冊之所有應用程式的資料。
必要條件
要使用此方法，您需要先執行以下操作：
- 如果您尚未執行此操作，請完成 Microsoft Store 提交 API 的所有必要條件 。
- 取得 Azure AD 存取權杖以便在此方法的要求標頭中使用 。 取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。 權杖到期之後，您可以取得新的權杖。
Request
此方法具有下列語法。 如需標頭和要求本文的使用範例和描述，請參閱下列各節。
| 方法 | 要求 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/applications |
要求標頭
| 標題 | 類型 | 描述 |
|---|---|---|
| 授權 | 字串 | 必要。 持有人<權杖>形式的 Azure AD 存取權杖。 |
要求參數
此方法的所有要求參數都是選擇性的。 如果您呼叫此方法時沒有使用參數，回應會包含已註冊至您的帳戶之前 10 個應用程式的資料。
| 參數 | 類型 | 描述 | 必要 |
|---|---|---|---|
| 熱門 | int | 要求中要傳回的項目數 (也就是要傳回的應用程式數目)。 如果您的帳戶擁有的應用程式多於您在查詢中指定的值，回應本文會包含相對 URI 路徑，讓您附加至方法 URI 以要求下一頁資料。 | 否 |
| skip | int | 傳回其餘項目之前，查詢中要略過的項目數。 使用此參數逐頁瀏覽資料集。 例如，top=10 和 skip=0 會擷取項目 1 到 10，top=10 和 skip=10 會擷取項目 11 到 20，依此類推。 | 否 |
要求本文
請勿提供此方法的要求本文。
要求範例
下列範例示範如何擷取已註冊至您的帳戶的前 10 個應用程式。
GET https://manage.devcenter.microsoft.com/v1.0/my/applications HTTP/1.1
Authorization: Bearer <your access token>
下列範例示範如何擷取已註冊至您帳戶之所有應用程式的相關資訊。 首先，取得前 10 個應用程式：
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?top=10 HTTP/1.1
Authorization: Bearer <your access token>
然後以遞迴方式呼叫 GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink}，直到 {@nextlink} 是 null 或不存在於回應中為止。 例如：
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=20&top=10 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=30&top=10 HTTP/1.1
Authorization: Bearer <your access token>
如果您已經知道帳戶中擁有的應用程式總數，您可以直接在 top 參數中傳遞該數字，以取得所有應用程式的相關資訊。
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?top=23 HTTP/1.1
Authorization: Bearer <your access token>
回應
下列範例示範向註冊至共有 21 個應用程式的開發人員帳戶成功要求前 10 個應用程式所傳回的 JSON 回應本文。 為了簡潔起見，此範例只顯示要求所傳回的前兩個應用程式的資料。 如需回應本文中的值的詳細資訊，請參閱下一節。
{
"@nextLink": "applications?skip=10&top=10",
"value": [
{
"id": "9NBLGGH4R315",
"primaryName": "Contoso sample app",
"packageFamilyName": "5224ContosoDeveloper.ContosoSampleApp_ng6try80pwt52",
"packageIdentityName": "5224ContosoDeveloper.ContosoSampleApp",
"publisherName": "CN=…",
"firstPublishedDate": "2016-03-11T01:32:11.0747851Z",
"pendingApplicationSubmission": {
"id": "1152921504621134883",
"resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621134883"
}
},
{
"id": "9NBLGGH29DM8",
"primaryName": "Contoso sample app 2",
"packageFamilyName": "5224ContosoDeveloper.ContosoSampleApp2_ng6try80pwt52",
"packageIdentityName": "5224ContosoDeveloper.ContosoSampleApp2",
"publisherName": "CN=…",
"firstPublishedDate": "2016-03-12T01:49:11.0747851Z",
"lastPublishedApplicationSubmission": {
"id": "1152921504621225621",
"resourceLocation": "applications/9NBLGGH29DM8/submissions/1152921504621225621"
}
// Next 8 apps are omitted for brevity ...
}
],
"totalCount": 21
}
回應本文
| 值 | 類型 | 描述 |
|---|---|---|
| 值 | 陣列 | 物件的陣列，其中包含已註冊至您的帳戶之每個應用程式的相關資訊。 如需每個物件中的資料的詳細資訊，請參閱應用程式資源。 |
| @nextLink | 字串 | 如果有額外的資料頁，此字串會包含相對路徑，讓您附加至基底 https://manage.devcenter.microsoft.com/v1.0/my/ 要求 URI，以要求下一頁的資料。 例如，如果初始要求本文的 top 參數設定為 10，但有 20 個應用程式註冊至您的帳戶，回應本文會包含 applications?skip=10&top=10 的 @nextLink 值，這表示您可以呼叫 https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 來要求接下來的 10 個應用程式。 |
| totalCount | int | 查詢資料結果中的資料列總數 (也就是已註冊至您的帳戶的應用程式總數)。 |
錯誤碼
如果要求無法成功完成，回應將會包含下列其中一個 HTTP 錯誤碼。
| 錯誤碼 | 描述 |
|---|---|
| 404 | 找不到任何應用程式。 |
| 409 | 應用程式使用 Microsoft Store 提交 API 目前不支援的合作夥伴中心功能。 |