Partager via

Obtient une version d’évaluation du package

  • Article

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour obtenir des données pour une version d’évaluation de package pour une application inscrite dans votre compte Espace partenaires.

Prérequis

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 au Microsoft Store.
  • Obtenir 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 demande
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

En-tête de requête

En-tête Type Description
Autorisation string Obligatoire. Jeton d’accès Azure AD au format porteur<jeton>.

Paramètres de la demande

Nom Type Description
applicationId string Obligatoire. ID Store de l’application qui contient la version d’évaluation du package que vous souhaitez obtenir. L’ID Store de l’application est disponible dans l’Espace partenaires.
flightId string Obligatoire. ID de la version d’évaluation du package à obtenir. Cet ID est disponible dans les données de réponse pour les demandes de création d’une version d’évaluation de package et obtenir des versions d’évaluation de package pour une application. Pour une version d’évaluation créée dans l’Espace partenaires, cet ID est également disponible dans l’URL de la page de version d’évaluation dans l’Espace partenaires.

Corps de la demande

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 une version d’évaluation de package avec l’ID 43e448df-97c9-4a43-a0bc-2a445e736bcd pour une application avec la valeur d’ID store 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>

Response

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

Response body

Valeur Type Description
flightId string ID de la version d’évaluation du package. Cette valeur est fournie par l’Espace partenaires.
friendlyName string Nom de la version d’évaluation du package, tel que spécifié par le développeur.
lastPublishedFlightSubmission object Objet qui fournit des informations sur la dernière soumission publiée pour la version d’évaluation du package. Pour plus d’informations, consultez la section Objet Soumission ci-dessous.
pendingFlightSubmission object Objet qui fournit des informations sur la soumission en attente actuelle pour la version d’évaluation du package. Pour plus d’informations, consultez la section Objet Soumission ci-dessous.
groupIds tableau Tableau de chaînes qui contiennent les ID des groupes de versions d’évaluation associés à la version d’évaluation du package. Pour plus d’informations sur les groupes de versions d’évaluation, consultez Packages flight flight.
rankHigherThan string Nom convivial de la version d’évaluation du package classée immédiatement plus bas que la version d’évaluation actuelle du package. Pour plus d’informations sur le classement des groupes de versions d’évaluation, consultez Versions d’évaluation du package.

Objet De soumission

Les valeurs lastPublishedFlightSubmission et pendingFlightSubmission dans le corps de la réponse contiennent des objets qui fournissent des informations de ressource sur une soumission pour la version d’évaluation du package. Ces objets ont les valeurs suivantes.

Valeur Type Description
id string L’ID de la soumission.
resourceLocation string 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 Description
400 La requête n’est pas valide.
404 Le fichier de la version d’évaluation de package spécifié est introuvable.
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.