共用方式為


取得所有應用程式

在 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 目前不支援的合作夥伴中心功能。