Få status för en appinlämning

Använd den här metoden i Microsoft Store-api:et för insändning för att hämta statusen för en appöverföring. Mer information om processen för att skapa en appöverföring med hjälp av Microsoft Store-api:et för insändning finns i Hantera appöverföringar.

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 förutsättningar för Microsoft Store-överlämnings-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}/submissions/{submissionId}/status

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 innehåller den sändning som du vill få status för. Mer information om Store-ID finns i Visa information om appidentitet.
insändningsID snöre Obligatoriskt. ID:t för den sändning som du vill få status för. Det här ID:t är tillgängligt i svarsdata för begäranden om att skapa en appinlämning. För en inlämning som har skapats i Partnercenter är detta ID också tillgängligt i URL:en för insändningssidan i Partnercenter.

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 får status för en appinlämning.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243610/status 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. Svarstexten innehåller information om den angivna sändningen. Mer information om värdena i svarstexten finns i följande avsnitt.

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Svarsdel

Värde Typ Beskrivning
tillstånd snöre Status för insändningen. Detta kan vara något av följande värden:
  • Ingen
  • Annullerad
  • Väntande åtagande
  • CommitSattIgång
  • Åtagande misslyckades
  • Väntar på publicering
  • Förlagsverksamhet
  • Publicerad
  • Publicering misslyckades
  • Förbehandling
  • FörbehandlingMisslyckades
  • Certifiering
  • Certifiering misslyckades
  • Lansering
  • Utgivning misslyckades
statusdetaljer objekt Innehåller ytterligare information om status för insändningen, inklusive information om eventuella fel. Mer information finns i resursen Statusinformation.

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 insändningen.
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.