Hämta ett paketflyg

Använd den här metoden i Microsoft Store-api:et för att hämta data för en paketflygning för en 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}/flights/{flightId}

Förfrågningshuvudrad

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

Parametrar för begäran

Namn Typ Beskrivning
applicationId snöre Obligatoriskt. Store-ID:t för appen som innehåller den paketflygning som du vill få. Store-ID:t för appen är tillgängligt i Partnercenter.
flightId snöre Obligatoriskt. ID:t för paketflyget som ska hämtas. Det här ID:t är tillgängligt i svarsdata för begäranden om att skapa en paketflygning och hämta paketflygningar för en app. För en flygning som har skapats i Partnercenter är det här ID:t också tillgängligt i URL:en för flygsidan 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 hämtar information om en paketflygning med ID:t 43e448df-97c9-4a43-a0bc-2a445e736bcd för en app med Store ID-värdet 9WZDNCRD91MD.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd 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 följande avsnitt.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Svarsdel

Värde Typ Beskrivning
flightId snöre ID:t för paketresan. Det här värdet anges av Partnercenter.
användarvänligt namn snöre Namnet på flygpaketet som specificerats av utvecklaren.
senastPubliceradeFlyginsändning objekt Ett objekt som innehåller information om den senast publicerade sändningen för paketflygningen. Mer information finns i avsnittet Föremål för inlämning nedan.
väntande flyginlämning objekt Ett objekt som innehåller information om den aktuella väntande sändningen för paketflygningen. Mer information finns i avsnittet Föremål för inlämning nedan.
grupp-ID:n samling En matris med strängar som innehåller ID:t för de flyggrupper som är associerade med paketflygningen. Mer information om flyggrupper finns i Paketflyg.
rankas högre än snöre Det vänliga namnet på det flygpaket som rangordnas omedelbart lägre än det aktuella flygpaketet. Mer information om rangordning av flyggrupper finns i Paketflyg.

Inlämningsobjekt

lastPublishedFlightSubmission och pendingFlightSubmission värden i svarstexten innehåller objekt som ger resursinformation om en överföring för paketflygningen. Dessa objekt har följande värden.

Värde Typ Beskrivning
Id-nummer snöre ID:t för insändningen.
resursplats snöre En relativ sökväg som du kan lägga till i bas-https://manage.devcenter.microsoft.com/v1.0/my/-förfrågnings-URI för att hämta fullständiga data för inskickandet.

Felkoder

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

Felkod Beskrivning
400 Begäran är ogiltig.
404 Det gick inte att hitta den angivna paketresan.
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.
  • Last updated on