Partager via

Obtenir des versions d’évaluation du package pour une application

  • Article

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour répertorier les versions d’évaluation de package d’une application inscrite dans votre compte Espace partenaires. Pour plus d’informations sur les versions d’évaluation de package, consultez Versions d’évaluation du package.

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.

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/applications/{applicationId}/listflights

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 Obligatoire
applicationId string ID Store de l’application pour laquelle vous souhaitez récupérer les versions d’évaluation du package. Pour plus d’informations sur l’ID store, consultez Afficher les détails de l’identité de l’application. Oui
haut int Nombre d’éléments à retourner dans la demande (autrement dit, le nombre de versions d’évaluation du package à retourner). Si votre compte comporte plus de versions d’évaluation de package que la valeur que vous spécifiez dans la requête, le corps de la réponse inclut un chemin d’URI relatif que vous pouvez ajouter à l’URI de méthode pour demander la page suivante des données. Non
skip int Nombre d’éléments à contourner dans la requête avant de renvoyer les éléments restants. Utilisez ce paramètre pour parcourir des jeux de données. Par exemple, top=10 et skip=0 récupère les éléments 1 à 10, top=10 et skip=10 récupère les éléments 11 à 20, et ainsi de suite. Non

Corps de la demande

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

Exemples de requête

L’exemple suivant montre comment répertorier toutes les versions d’évaluation de package pour une application.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights HTTP/1.1
Authorization: Bearer <your access token>

L’exemple suivant montre comment répertorier la première version d’évaluation de package pour une application.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights?top=1 HTTP/1.1
Authorization: Bearer <your access token>

Response

L’exemple suivant illustre le corps de la réponse JSON retourné par une demande réussie pour la première version d’évaluation du package pour une application avec trois versions d’évaluation totales du package. Pour plus d’informations sur les valeurs dans le corps de la réponse, consultez la section suivante.

{
  "value": [
    {
      "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
      "friendlyName": "myflight",
      "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
      },
      "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
      },
      "groupIds": [
        "1152921504606962205"
      ],
      "rankHigherThan": "Non-flighted submission"
    }
  ],
  "totalCount": 3
}

Response body

Valeur Type Description
@nextLink string S’il existe des pages de données supplémentaires, cette chaîne contient un chemin d’accès relatif que vous pouvez ajouter à l’URI de demande de base https://manage.devcenter.microsoft.com/v1.0/my/ pour demander la page suivante des données. Par exemple, si le paramètre supérieur du corps de la demande initiale est défini sur 2, mais qu’il existe 4 versions d’évaluation du package pour l’application, le corps de applications/{applicationid}/listflights/?skip=2&top=2la réponse inclut une @nextLink valeur , ce qui indique que vous pouvez appeler https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 pour demander les 2 versions d’évaluation de package suivantes.
value tableau Tableau d’objets qui fournissent des informations sur les versions d’évaluation de package pour l’application spécifiée. Pour plus d’informations sur les données de chaque objet, consultez ressource Flight.
totalCount int Nombre total de lignes dans le résultat des données de la requête (autrement dit, nombre total de versions d’évaluation du package pour l’application spécifiée).

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 Aucun vol de package n’a été trouvé.
409 L’application utilise une fonctionnalité de l’Espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission au Microsoft Store.