Valider une soumission de version d’évaluation de package

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour approuver un envoi d’étape de package, qu’il soit nouveau ou mis à jour, dans le Centre des partenaires. L’action de validation avertit l’Espace partenaires que les données de soumission ont été chargées (y compris les packages associés). En réponse, Partner Center enregistre les modifications apportées aux données de soumission pour l'intégration 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’intègre dans le processus de création d’une soumission de vol de package à l’aide de l’API de soumission du Microsoft Store, consultez Gérer les soumissions de vols de package.

Conditions préalables

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 du Microsoft Store.
  • Obtenez 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éer une soumission de vol de paquet, puis mettre à jour la soumission avec les modifications nécessaires apportées aux données de soumission.

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 la requête
PUBLIER https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit

En-tête de requête

En-tête de page Catégorie Descriptif
Autorisation ficelle Obligatoire. Le jeton d’accès Azure AD sous la forme Bearer<token>.

Paramètres de la demande

Nom Catégorie Descriptif
applicationId ficelle Obligatoire. Identifiant de Store de l’application qui contient la soumission de vol du package que vous voulez valider. L’ID Store de l’application est disponible dans l’Espace partenaires.
flightId ficelle Obligatoire. ID du vol du package qui contient la soumission à engager. Cet ID est disponible dans les données de réponse pour les demandes visant à créer un vol de package et à obtenir des vols de package pour une application. Pour un vol créé dans l’Espace partenaires, cet ID est également disponible dans l’URL de la page de vol dans l’Espace partenaires.
ID de soumission ficelle 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 vol 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 requête

Ne fournissez pas de corps de requête pour cette méthode.

Exemple de requête

L’exemple suivant montre comment envoyer un package flight.

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

Réponse

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"
}

Corps de réponse

Valeur Catégorie Descriptif
statut ficelle État de la soumission. Il peut s’agir de l’une des valeurs suivantes :
  • Aucun
  • Annulé
  • Engagement en attente
  • CommitStarted
  • EngagementÉchoué
  • En attente de publication
  • Édition
  • Publié
  • Échec de publication
  • Prétraitement
  • Échec du prétraitement
  • Certification
  • Échec de la certification
  • Libération
  • Échec de la mise en production

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 Descriptif
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 l’application utilise une fonctionnalité de l’Espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission du Microsoft Store.