Een pakketvlucht maken

Gebruik deze methode in de Microsoft Store-indienings-API om een pakketvlucht te maken voor een app die is geregistreerd bij uw Partnercentrum-account.

Opmerking

Met deze methode maakt u een pakketvlucht zonder inzendingen. Als u een inzending voor pakketvlucht wilt maken, raadpleegt u de methoden in Verzendingen van pakketvlucht beheren.

Vereiste voorwaarden

Als u deze methode wilt gebruiken, moet u eerst het volgende doen:

  • Als u dit nog niet hebt gedaan, moet u alle vereisten voor de Microsoft Store-indienings-API voltooien.
  • Haal een Azure AD-toegangstoken op dat moet worden gebruikt in de aanvraagheader voor deze methode. Nadat u een toegangstoken hebt verkregen, hebt u 60 minuten om het te gebruiken voordat het verloopt. Nadat het token is verlopen, kunt u een nieuw token verkrijgen.

Aanvraag

Deze methode heeft de volgende syntaxis. Zie de volgende secties voor gebruiksvoorbeelden en beschrijvingen van de header en aanvraagtekst.

Methode URI-aanvraag
BERICHT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

Header van het verzoek

Koptekst Typologie Beschrijving
Autorisatie touw Verplicht. Het Azure AD-toegangstoken in de vorm Bearer<token>.

Aanvraagparameters

Naam Typologie Beschrijving
applicationId touw Verplicht. De Store-id van de app waarvoor u een pakketvlucht wilt maken. Zie App-id-gegevens weergeven voor meer informatie over de Store-id.

Inhoud van het verzoek

De hoofdtekst van de aanvraag heeft de volgende parameters.

Kenmerk Typologie Beschrijving Verplicht
vriendelijke naam touw De naam van de pakketvlucht, zoals opgegeven door de ontwikkelaar. Nee.
groep-ID's gegevensreeks Een matrix met tekenreeksen die de id's van de vluchtgroepen bevatten die zijn gekoppeld aan de pakketvlucht. Zie Pakketvluchten voor meer informatie over vluchtgroepen. Nee.
rangHogerDan touw De vriendelijke naam van de pakketvlucht die direct onder de huidige pakketvlucht is gerangschikt. Als u deze parameter niet instelt, heeft de nieuwe pakketvlucht de hoogste rang van alle pakketvluchten. Zie Pakketvluchten voor meer informatie over classificatievluchtgroepen. Nee.

Vraag om voorbeeld

In het volgende voorbeeld ziet u hoe u een nieuwe pakketvlucht maakt voor een app met de 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
}

Reactie

In het volgende voorbeeld ziet u de hoofdtekst van het JSON-antwoord voor een geslaagde aanroep naar deze methode. Zie de volgende secties voor meer informatie over de waarden in de antwoordtekst.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Antwoordlichaam

Waarde Typologie Beschrijving
vlucht-ID touw De ID voor de pakketvlucht. Deze waarde wordt geleverd door partnercentrum.
vriendelijke naam touw De naam van de pakketvlucht, zoals opgegeven in de aanvraag.
groep-ID's gegevensreeks Een matrix met tekenreeksen die de id's van de vluchtgroepen bevatten die zijn gekoppeld aan de pakketvlucht, zoals opgegeven in de aanvraag. Zie Pakketvluchten voor meer informatie over vluchtgroepen.
rangHogerDan touw De vriendelijke naam van de pakketvlucht die onmiddellijk lager gerangschikt is dan de huidige pakketvlucht, zoals gespecificeerd in het verzoek. Zie Pakketvluchten voor meer informatie over classificatievluchtgroepen.

Foutcodes

Als de aanvraag niet kan worden voltooid, bevat het antwoord een van de volgende HTTP-foutcodes.

Foutcode Beschrijving
400 De aanvraag is ongeldig.
409 De pakketvlucht kan niet worden gemaakt vanwege de huidige status of de app maakt gebruik van een partnercentrumfunctie die momenteel niet wordt ondersteund door de Microsoft Store-indienings-API.