Réservez un vol en forfait

Utilisez cette méthode dans l'API de soumission du Microsoft Store pour obtenir des données sur une diffusion de package pour une application enregistrée dans votre compte Espace partenaires.

Conditions préalables

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :

  • Si vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour l’API de soumission du Microsoft Store.
  • Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête pour cette méthode. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.

Requête

Cette méthode a la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et des descriptions du corps de l’en-tête et de la demande.

Méthode URI de la requête
OBTENIR https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

En-tête de requête

En-tête de page Catégorie Descriptif
Autorisation ficelle Obligatoire. Jeton d’accès Azure AD sous la forme Bearer<token>.

Paramètres de la demande

Nom Catégorie Descriptif
applicationId ficelle Obligatoire. L'ID de la boutique de l’application qui contient le package flight que vous souhaitez obtenir. L’ID Store de l’application est disponible dans l’Espace partenaires.
flightId ficelle Obligatoire. L'ID du vol de paquet à obtenir. Cet ID est disponible dans les données de réponse pour les demandes visant à créer un vol de package et à obtenir des vols de package pour une application. Pour un vol créé dans l’Espace partenaires, cet ID est également disponible dans l’URL de la page de vol dans l’Espace partenaires.

Corps de la requête

Ne fournissez pas de corps de requête pour cette méthode.

Exemple de requête

L’exemple suivant montre comment récupérer des informations sur un déploiement de package avec l’ID 43e448df-97c9-4a43-a0bc-2a445e736bcd pour une application avec la valeur de l’ID de magasin 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>

Réponse

L’exemple suivant illustre le corps de la réponse JSON pour un appel réussi à cette méthode. Pour plus d’informations sur les valeurs dans le corps de la réponse, consultez les sections suivantes.

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

Corps de réponse

Valeur Catégorie Descriptif
flightId ficelle Identifiant pour le vol du package. Cette valeur est fournie par l’Espace partenaires.
nom convivial ficelle Nom du vol du package, tel que spécifié par le développeur.
dernièreSoumissionDeVolPubliée objet Objet fournissant des informations sur la dernière soumission publiée pour le vol de paquet. Pour plus d’informations, consultez la section sur l'objet Submission ci-dessous.
pendingFlightSubmission objet Objet qui fournit des informations sur la soumission actuellement en attente pour le vol de paquet. Pour plus d’informations, consultez la section sur l'objet Submission ci-dessous.
identifiants de groupe tableau Tableau de chaînes contenant les ID des groupes de vol associés au vol du package. Pour plus d'informations sur les groupes de vols, consultez vols de forfait.
rangPlusHautQue ficelle Nom d'usage du package de vol qui est classé immédiatement plus bas que le package de vol actuel. Pour plus d’informations sur le classement des groupes de vols, consultez vols de packages.

Objet de soumission

Les valeurs lastPublishedFlightSubmission et pendingFlightSubmission dans le corps de la réponse contiennent des objets qui fournissent des informations sur les ressources concernant une soumission pour le vol du package. Ces objets ont les valeurs suivantes.

Valeur Catégorie Descriptif
pièce d'identité ficelle Identifiant de la soumission.
emplacement de la ressource ficelle Chemin d’accès relatif que vous pouvez ajouter à l’URI de demande de base https://manage.devcenter.microsoft.com/v1.0/my/ pour récupérer les données complètes de la soumission.

Codes d’erreur

Si la requête ne peut pas être terminée, la réponse contient l’un des codes d’erreur HTTP suivants.

Code d’erreur Descriptif
400 La requête n’est pas valide.
404 Impossible de trouver le vol du package spécifié.
409 L’application utilise une fonctionnalité de l’Espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission au Microsoft Store.
  • Last updated on