Obtenir l’état d’une soumission d’applicationGet the status of an app submission

Utilisez cette méthode dans l’API de soumission Microsoft Store pour connaître l’état d’une soumission d’application.Use this method in the Microsoft Store submission API to get the status of an app submission. Pour plus d’informations sur le processus de création d’une soumission d’application à l’aide de l’API Microsoft Store soumission, consultez gérer les envois d’applications.For more information about the process of process of creating an app submission by using the Microsoft Store submission API, see Manage app submissions.

PrérequisPrerequisites

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :To use this method, you need to first do the following:

  • Si vous ne l’avez pas déjà fait, renseignez toutes les conditions préalables pour l’API de soumission Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de cette méthode.Obtain an Azure AD access token to use in the request header for this method. 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.After you obtain an access token, you have 60 minutes to use it before it expires. Une fois le jeton arrivé à expiration, vous pouvez en obtenir un nouveau.After the token expires, you can obtain a new one.

RequêteRequest

Cette méthode présente la syntaxe suivante.This method has the following syntax. 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.See the following sections for usage examples and descriptions of the header and request body.

MéthodeMethod URI de demandeRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status

En-tête de requêteRequest header

En-têteHeader TypeType DescriptionDescription
AutorisationAuthorization stringstring Obligatoire.Required. Jeton d’accès Azure AD sous la forme Bearer <jeton>.The Azure AD access token in the form Bearer <token>.

Paramètres de la demandeRequest parameters

NomName TypeType DescriptionDescription
applicationIdapplicationId stringstring Obligatoire.Required. ID Windows Store de l’application qui contient la soumission dont vous voulez obtenir l’état.The Store ID of the app that contains the submission for which you want to get the status. Pour plus d’informations sur l’ID Windows Store, voir Visualiser les informations d’identité des applications.For more information about the Store ID, see View app identity details.
submissionIdsubmissionId stringstring Obligatoire.Required. ID de la soumission dont vous voulez obtenir l’état.The ID of the submission for which you want to get the status. Cet ID est disponible dans les données de réponse pour les demandes de création d’une soumission d’application.This ID is available in the response data for requests to create an app submission. Pour une soumission qui a été créée dans l’espace partenaires, cet ID est également disponible dans l’URL de la page de soumission dans l’espace partenaires.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Corps de la demandeRequest body

Ne fournissez pas de corps de requête pour cette méthode.Do not provide a request body for this method.

Exemple de requêteRequest example

L’exemple suivant montre comment obtenir l’état d’une soumission d’application.The following example demonstrates how to get the status of an app submission.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243610/status HTTP/1.1
Authorization: Bearer <your access token>

responseResponse

L’exemple suivant illustre le corps de réponse JSON d’un appel réussi à cette méthode.The following example demonstrates the JSON response body for a successful call to this method. Le corps de la réponse contient des informations sur la soumission spécifiée.The response body contains information about the specified submission. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, voir les sections suivantes.For more details about the values in the response body, see the following sections.

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

Response bodyResponse body

ValeurValue TypeType DescriptionDescription
statusstatus stringstring État de la soumission.The status of the submission. Il peut s’agir de l’une des valeurs suivantes :This can be one of the following values:
  • AucuneNone
  • Opération annuléeCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • PublicationPublishing
  • PubliéPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • CertificationCertification
  • CertificationFailedCertificationFailed
  • LibérerRelease
  • ReleaseFailedReleaseFailed
statusDetailsstatusDetails objectobject Contient des détails supplémentaires sur l’état de la soumission, notamment des informations sur les éventuelles erreurs.Contains additional details about the status of the submission, including information about any errors. Pour plus d’informations, voir Ressource des détails d’état.For more information, see the Status details resource.

Codes d’erreurError codes

Si la requête ne peut pas aboutir, la réponse contient l’un des codes d’erreur HTTP suivants.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Code d'erreurError code DescriptionDescription
404404 La soumission est introuvable.The submission could not be found.
409409 L’application utilise une fonctionnalité d’espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission Microsoft Store.The app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.