Partager via

Obtenir l’état d’une soumission d’extension

  • Article

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour obtenir l’état d’une soumission de module complémentaire (également appelée produit in-app ou IAP). Pour plus d’informations sur le processus de création d’une soumission d’extension à l’aide de l’API de soumission du Microsoft Store, consultez Gérer les soumissions d’extensions.

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.
  • Créez une soumission d’extension 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 d’extension.

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/inappproducts/{inAppProductId}/submissions/{submissionId}/status

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
inAppProductId string Obligatoire. ID store du module complémentaire qui contient la soumission pour laquelle vous souhaitez obtenir l’état. L’ID store est disponible dans l’Espace partenaires.
submissionId string Obligatoire. ID de la soumission pour laquelle vous souhaitez obtenir l’état. Cet ID est disponible dans les données de réponse pour les demandes de création d’une soumission d’extension. 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 d’extension.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621243680/status 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. Le corps de la réponse contient des informations sur la soumission spécifiée. Pour plus d’informations sur les valeurs dans le corps de la réponse, consultez les sections suivantes.

{
  "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 :
  • Aucune
  • Annulée
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • Publication
  • Publiée
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • Certification
  • CertificationFailed
  • Version release
  • ReleaseFailed
statusDetails object Contient des détails supplémentaires sur l’état de la soumission, y compris des informations sur les erreurs. Pour plus d’informations, consultez la ressource Détails de l’état.

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
404 Impossible de trouver la soumission.
409 Le module complémentaire utilise une fonctionnalité de l’Espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission au Microsoft Store.