Valider une soumission d’extension
Utilisez cette méthode dans l’API de soumission du Microsoft Store pour valider une soumission d’extension nouvelle ou mise à jour (également appelée produit in-app ou IAP) à 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 à la soumission sont affichées dans l’Espace partenaires.
Pour plus d’informations sur la façon dont l’opération de validation s’adapte au processus d’envoi d’un module complémentaire à l’aide de l’API de soumission du Microsoft Store, consultez Gérer les soumissions de modules complémentaires.
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 de module complémentaire, puis mettez à jour la soumission avec toutes les modifications nécessaires apportées aux données de soumission.
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 |
---|---|
POST | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/commit |
En-tête | Type | Description |
---|---|---|
Autorisation | string | Obligatoire. Jeton d’accès Azure AD au format porteur<jeton>. |
Nom | Type | Description |
---|---|---|
inAppProductId | string | Obligatoire. ID store du module complémentaire qui contient la soumission que vous souhaitez valider. L’ID store est disponible dans l’Espace partenaires, et il est inclus dans les données de réponse pour obtenir tous les modules complémentaires et créer 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 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. |
Ne fournissez pas de corps de requête pour cette méthode.
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>
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.
{
"status": "CommitStarted"
}
Valeur | Type | Description |
---|---|---|
status | string | État de la soumission. Il peut s’agir de l’une des valeurs suivantes :
|
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 | Les paramètres de requête ne sont pas valides. |
404 | Impossible de trouver la soumission spécifiée. |
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 du Microsoft Store. |