Créer un vol de colis

Utilisez cette méthode dans l'API de soumission du Microsoft Store pour créer un vol de package pour une application enregistrée dans votre compte du Centre de partenaires.

Remarque

Cette méthode crée un vol de package sans soumission. Si vous souhaitez créer une soumission de la version d’évaluation du package, consultez les méthodes dans Gérer les soumissions de versions d’évaluation 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.

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

En-tête de requête

En-tête de page Catégorie Descriptif
Autorisation ficelle Obligatoire. Jeton d’accès Azure AD au format Jeton du<porteur>.

Paramètres de la demande

Nom Catégorie Descriptif
applicationId ficelle Obligatoire. ID Store de l’application pour laquelle vous souhaitez créer un vol de package. Pour plus d’informations sur l’ID store, consultez Afficher les détails de l’identité de l’application.

Corps de la requête

Le corps de la requête a les paramètres suivants.

Paramètre Catégorie Descriptif Obligatoire
nom convivial ficelle Nom du vol du package, tel que spécifié par le développeur. Non
identifiants de groupe tableau Tableau de chaînes contenant les ID des groupes de vol associés au vol du package. Pour plus d’informations sur les groupes de vols, consultez vols de package. Non
rangPlusHautQue ficelle Nom d'usage du package de vol qui est classé immédiatement plus bas que le package de vol actuel. Si vous ne définissez pas ce paramètre, le nouveau vol de package aura le rang le plus élevé de tous les vols de package. Pour plus d'informations sur le classement des groupes de vols, consultez Vols du package. Non

Exemple de requête

L’exemple suivant montre comment créer un nouveau package flight pour une application qui a l’ID Store 9WZDNCRD911W.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

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.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Corps de réponse

Valeur Catégorie Descriptif
flightId ficelle Identifiant pour le vol du package. Cette valeur est fournie par l’Espace partenaires.
nom convivial ficelle Nom du vol de package, tel que spécifié dans la demande.
identifiants de groupe tableau Ensemble de chaînes de caractères contenant les ID des groupes de vols associés au vol du package, comme spécifié dans la requête. Pour plus d’informations sur les groupes de vols, consultez vols de package.
rangPlusHautQue ficelle Le nom usuel du package de vol qui est classé immédiatement inférieur au package de vol actuel, tel que spécifié dans la demande. Pour plus d'informations sur le classement des groupes de vols, consultez Vols du package.

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 La requête n’est pas valide.
409 La version d’évaluation du package n’a pas pu être créée en raison de 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 de Microsoft Store.
  • Last updated on