Een pakketreis boeken

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

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
TOEVOEGEN https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

Header van het verzoek

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

Aanvraagparameters

Naam Typologie Beschrijving
applicationId touw Verplicht. De Store-id van de app die de pakketvlucht bevat die u wilt ophalen. De Store-id voor de app is beschikbaar in partnercentrum.
vlucht-ID touw Verplicht. De ID van de pakketvlucht die moet worden opgehaald. Deze id is beschikbaar in de antwoordgegevens voor aanvragen voor het maken van een pakketvlucht en het ophalen van pakketvluchten voor een app. Voor een vlucht die is gemaakt in Partnercentrum, is deze id ook beschikbaar in de URL voor de vluchtpagina in Partnercentrum.

Inhoud van het verzoek

Geef geen aanvraagbody op voor deze methode.

Vraag om voorbeeld

In het volgende voorbeeld ziet u hoe u informatie over een pakketvlucht ophaalt met de id 43e448df-97c9-4a43-a0bc-2a445e736bcd voor een app met de Store-id-waarde 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>

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",
  "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"
}

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 door de ontwikkelaar.
laatstGepubliceerdeVluchtInzending Voorwerp Een object dat informatie biedt over de laatst gepubliceerde inzending voor de pakketvlucht. Zie de sectie Indieningsobject hieronder voor meer informatie.
wachtende vluchtaanmelding Voorwerp Een object dat informatie biedt over de huidige inzending die in behandeling is voor de pakketvlucht. Zie de sectie Indieningsobject hieronder voor meer informatie.
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.
rangHogerDan touw De vriendelijke naam van de pakketvlucht die direct onder de huidige pakketvlucht is gerangschikt. Zie Pakketvluchtenvoor meer informatie over classificatievluchtgroepen.

Object van inzending

De lastPublishedFlightSubmission en pendingFlightSubmission waarden in de hoofdtekst van het antwoord bevatten objecten die resourcegegevens bevatten over een verzending voor de pakketvlucht. Deze objecten hebben de volgende waarden.

Waarde Typologie Beschrijving
identiteitskaart touw De id van de inzending.
hulpbronLocatie touw Een relatief pad dat u kunt toevoegen aan de basis-https://manage.devcenter.microsoft.com/v1.0/my/ aanvraag-URI om de volledige gegevens voor de inzending op te halen.

Foutcodes

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

Foutcode Beschrijving
400 De aanvraag is ongeldig.
404 Kan de opgegeven pakketvlucht niet vinden.
409 De app maakt gebruik van een partnercentrumfunctie die momenteel niet wordt ondersteund door de Microsoft Store-inzendings-API.
  • Last updated on