Obtenir l’état d’une soumission de version d’évaluation de package

  • Article

Utilisez cette méthode dans l’API de soumission au Microsoft Store pour obtenir la status d’une soumission de version d’évaluation de package. Pour plus d’informations sur le processus de création d’une soumission de version d’évaluation de package à l’aide de l’API de soumission au Microsoft Store, consultez Gérer les soumissions de version d’évaluation de package.

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 tous les prérequis pour l’API de soumission au Microsoft Store.
  • Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de 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 arrivé à expiration, vous pouvez en obtenir un nouveau.
  • Créez une soumission de version d’évaluation de package pour l’une de vos applications. Vous pouvez le faire dans l’Espace partenaires, ou vous pouvez le faire à l’aide de la méthode créer une soumission de version d’évaluation de package .

Requête

Cette méthode présente la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et une description de l’en-tête et du corps de la requête.

Méthode URI de demande
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/status

En-tête de requête

En-tête Type Description
Autorisation string Obligatoire. Jeton d’accès Azure AD sous la formeJeton> du porteur<.

Paramètres de la demande

Nom Type Description
applicationId string Obligatoire. ID Windows Store de l’application qui contient la soumission de version d’évaluation du package dont vous voulez obtenir l’état. Pour plus d’informations sur l’ID Windows Store, voir Visualiser les informations d’identité des applications.
flightId string Obligatoire. ID de la version d’évaluation du package qui contient la soumission dont vous voulez obtenir l’état. 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 d’obtention de 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 de l’Espace partenaires.
submissionId string Obligatoire. ID de la soumission dont vous voulez obtenir l’état. Cet ID est disponible dans les données de réponse pour les demandes de création d’une soumission de version d’évaluation de package. Pour une soumission créée dans l’Espace partenaires, cet ID est également disponible dans l’URL de la page de soumission 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 obtenir l’état d’une soumission de version d’évaluation du package.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/status HTTP/1.1
Authorization: Bearer <your access token>

response

L’exemple suivant illustre le corps de réponse JSON d’un appel réussi à cette méthode. Le corps de la réponse contient des informations sur la soumission spécifiée. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, voir la section suivante.

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Response body

Valeur Type Description
status string État de la soumission. Il peut s’agir de l’une des valeurs suivantes :
  • None
  • Opération annulée
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • Publication
  • Publié
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • Certification
  • CertificationFailed
  • Libérer
  • ReleaseFailed
statusDetails object Contient des détails supplémentaires sur l’état de la soumission, notamment des informations sur les éventuelles erreurs. Pour plus d’informations, voir Ressource des détails d’état.

Codes d’erreur

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

Code d'erreur Description
404 La soumission 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.