Valider une soumission d’extension

  • Article

Utilisez cette méthode dans l’API de soumission au Microsoft Store pour valider la soumission d’un module complémentaire nouveau ou mis à jour (également appelé produit in-app ou IAP) dans l’Espace partenaires. L’action de validation avertit l’Espace partenaires que les données de soumission ont été chargées (y compris les icônes associées). En réponse, l’Espace partenaires valide les modifications apportées aux données de soumission pour l’ingestion et la publication. Une fois l’opération de validation réussie, les modifications apportées à l’envoi sont affichées dans l’Espace partenaires.

Pour plus d’informations sur la façon dont l’opération de validation s’intègre dans le processus d’envoi d’un module complémentaire à l’aide de l’API de soumission au Microsoft Store, consultez Gérer les soumissions de modules complémentaires.

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 d’extension, puis mettez à jour cette soumission avec les éventuelles modifications nécessaires apportées aux données de soumission.

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
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/commit

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
inAppProductId string Obligatoire. ID Windows Store de l’extension qui contient la soumission à valider. L’ID store est disponible dans l’Espace partenaires, et il est inclus dans les données de réponse pour les demandes d’obtention de tous les modules complémentaires et de création d’un module complémentaire.
submissionId string Obligatoire. ID de la soumission à valider. Cet ID est disponible dans les données de réponse pour les demandes de création d’une soumission de module complémentaire. 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 valider une soumission d’extension.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/commit 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. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, voir les sections suivantes.

{
  "status": "CommitStarted"
}

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

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
400 Les paramètres de la requête ne sont pas valides.
404 La soumission spécifiée est introuvable.
409 La soumission spécifiée a été trouvée, mais elle n’a pas pu être validée dans son état actuel, ou 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.