Sdílet prostřednictvím

Získání stavu odeslání letové verze balíčku

Tuto metodu použijte v rozhraní API pro odeslání Microsoft Storu ke zjištění stavu podání balíčku v rámci flightu. Další informace o procesu vytvoření odeslání testovací verze balíčku pomocí rozhraní API pro odeslání z Microsoft Storu najdete v tématu Správa odeslání testovací verze balíčku.

Požadavky

Pokud chcete použít tuto metodu, musíte nejprve provést následující:

  • Pokud jste to ještě neudělali, splňte všechny nezbytné předpoklady pro API pro odesílání do Microsoft Storu.
  • Získejte přístupový token Azure AD a použijte ho v hlavičce požadavku pro tuto metodu. Po získání přístupového tokenu ho budete mít 60 minut, než vyprší jeho platnost. Po vypršení platnosti tokenu můžete získat nový.
  • Vytvořte odeslání balíčku letu pro jednu z vašich aplikací. Můžete to udělat v Partnerském centru, nebo můžete použít metodu odeslání testovací verze balíčku .

Žádost

Tato metoda má následující syntaxi. Příklady použití a popisy hlavičky a textu požadavku najdete v následujících částech.

Metoda Požadavek na URI
získej https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/status

Hlavička požadavku

Záhlaví Typ Popis
Autorizace řetězec Povinné. Přístupový token Azure AD ve formátu Bearer<token>.

Parametry požadavku

Název Typ Popis
ID aplikace řetězec Povinné. ID obchodu aplikace, která obsahuje odeslání testovací verze balíčku, jehož stav chcete zjistit. Další informace o „Store ID“ najdete v části Zobrazení podrobností o identitě aplikace.
ID letu řetězec Povinné. ID testovací verze balíčku, která obsahuje odeslání, pro které chcete získat stav. Tento identifikátor je k dispozici v datech vrácených odpovědí pro požadavky o vytvoření testovací verze balíčku a získání balíčkových letů pro aplikaci. Pro let vytvořený v Partnerském centru je toto ID k dispozici také v URL adrese stránky letu v Partnerském centru.
ID příspěvku řetězec Povinné. ID podání, pro které chcete zjistit stav. Toto ID je k dispozici v datech odpovědi pro žádosti o vytvoření odeslání testovací verze balíčku. U odeslání vytvořeného v Partnerském centru je toto ID k dispozici také na adrese URL stránky pro odeslání v Partnerském centru.

Obsah požadavku

Pro tuto metodu nezadádejte text požadavku.

Požadavek příkladu

Následující příklad ukazuje, jak získat stav odeslání testovací verze balíčku.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/status HTTP/1.1
Authorization: Bearer <your access token>

Odezva

Následující příklad ukazuje text odpovědi JSON pro úspěšné volání této metody. Tělo odpovědi obsahuje informace o zadaném podání. Další podrobnosti o hodnotách v textu odpovědi najdete v následující části.

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

Obsah odpovědi

Hodnota Typ Popis
stav řetězec Stav odeslání. Může to být jedna z následujících hodnot:
  • Žádné
  • Zrušeno
  • Čekající závazek
  • CommitStarted
  • Nepodařilo se potvrdit
  • Čeká se na zveřejnění
  • Publikování
  • Publikováno
  • Publikování se nezdařilo.
  • Předzpracování
  • Předběžné zpracování se nezdařilo
  • Certifikace
  • Certifikace selhala
  • Vydání
  • Uvolnění se nezdařilo
Podrobnosti o stavu objekt Obsahuje další podrobnosti o stavu odeslání, včetně informací o všech chybách. Další informace najdete v podrobnostech o stavu prostředku .

Kódy chyb

Pokud požadavek nelze úspěšně dokončit, odpověď bude obsahovat jeden z následujících kódů chyb HTTP.

Kód chyby Popis
404 Odeslání nebylo nalezeno.
409 Aplikace používá funkci Partnerského centra, kterou aktuálně rozhraní API pro odesílání z Microsoft Storu nepodporuje.
  • Last updated on