Skapa en paketflygning

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

Anmärkning

Den här metoden skapar en paketflygning utan några inlämningar. Information om hur du skapar en överföring för paketflygning finns i metoderna i Hantera paketflyktsö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 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
Posten https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

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 du vill skapa en paketflygning för. Mer information om Store-ID finns i Visa information om appidentitet.

begäranens innehåll

Begärandetexten har följande parametrar.

Parameter Typ Beskrivning Krävs
användarvänligt namn snöre Namnet på flygpaketet som specificerats av utvecklaren. Nej
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. Nej
rankas högre än snöre Det vänliga namnet på det flygpaket som rangordnas omedelbart lägre än det aktuella flygpaketet. Om du inte anger den här parametern har den nya paketflygningen den högsta rangordningen för alla paketflygningar. Mer information om rangordning av flyggrupper finns i Paketflyg. Nej

Exempel på begäran

I följande exempel visas hur du skapar en ny paketflygning för en app som har Store ID 9WZDNCRD911W.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

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",
  "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å paketflygningen enligt beskrivningen i begäran.
grupp-ID:n samling En matris med strängar som innehåller ID:t för de flyggrupper som är associerade med paketflygningen, enligt beskrivningen i begäran. Mer information om flyggrupper finns i Paketflyg.
rankas högre än snöre Det vänliga namnet på den paketflygning som rangordnas omedelbart lägre än den aktuella paketflygningen, enligt begäran. Mer information om rangordning av flyggrupper finns i Paketflyg.

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.
409 Det gick inte att skapa paketflygningen på grund av dess aktuella tillstånd, eller så använder appen en Partner Center-funktion som för närvarande inte stöds av Microsoft Store-api:et för överföring.
  • Last updated on