Hämta en app

Använd den här metoden i Microsoft Store-api:et för överföring för att hämta information om en specifik app som är registrerad på ditt Partnercenter-konto.

Förutsättningar

Om du vill använda den här metoden måste du först göra följande:

  • Om du inte redan har gjort det, slutför alla krav för inlämning till Microsoft Store-API:et.
  • Hämta en Azure AD-åtkomsttoken som ska användas i begärandehuvudet för den här metoden. När du har fått en åtkomsttoken har du 60 minuter på dig att använda den innan den upphör att gälla. När token har upphört att gälla kan du skaffa en ny.

Begäran

Den här metoden har följande syntax. Se följande avsnitt för användningsexempel och beskrivningar av rubriken och begärandetexten.

Metod Begäran om URI
HÄMTA https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}

Förfrågningshuvudrad

Rubrik Typ Beskrivning
Auktorisering snöre Obligatoriskt. Azure AD-åtkomsttoken i formatet Bearer-token<>.

Parametrar för begäran

Namn Typ Beskrivning
applicationId snöre Obligatoriskt. Store-ID:t för appen som ska hämtas. Mer information om Store-ID finns i Visa information om appidentitet.

begäranens innehåll

Ange ingen begärandetext för den här metoden.

Exempel på begäran

I följande exempel visas hur du hämtar information om en app med store-ID-värdet 9NBLGGH4R315.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315 HTTP/1.1
Authorization: Bearer <your access token>

Svar

I följande exempel visas JSON-svarstexten för ett lyckat anrop till den här metoden. Mer information om värdena i svarstexten finns i Programresurs.

{
  "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
}

Felkoder

Om begäran inte kan slutföras innehåller svaret någon av följande HTTP-felkoder.

Felkod Beskrivning
404 Det gick inte att hitta den angivna appen.
409 Appen använder en Partner Center-funktion som för närvarande inte stöds av Microsoft Store-api:et för överföring.