Partager via

Obtenir toutes les applications

  • Article

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour récupérer des données pour les applications inscrites dans votre compte Espace partenaires.

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

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

Tous les paramètres de requête sont facultatifs pour cette méthode. Si vous appelez cette méthode sans paramètres, la réponse contient des données pour les 10 premières applications inscrites dans votre compte.

Paramètre Type Description Obligatoire
haut int Nombre d’éléments à retourner dans la demande (autrement dit, le nombre d’applications à renvoyer). Si votre compte a plus d’applications 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écupérer les 10 premières applications inscrites dans votre compte.

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

L’exemple suivant montre comment récupérer des informations sur toutes les applications inscrites dans votre compte. Tout d’abord, obtenez les 10 meilleures applications :

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

Appelez ensuite de manière GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink} récursive jusqu’à ce qu’il {@nextlink} soit null ou qu’il n’existe pas dans la réponse. Par exemple :

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=20&top=10 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=30&top=10 HTTP/1.1
Authorization: Bearer <your access token>

Si vous connaissez déjà le nombre total d’applications que vous avez dans votre compte, vous pouvez simplement passer ce nombre dans le paramètre supérieur pour obtenir des informations sur toutes vos applications.

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

Response

L’exemple suivant illustre le corps de réponse JSON retourné par une demande réussie pour les 10 premières applications inscrites dans un compte de développeur avec 21 applications totales. Par souci de concision, cet exemple affiche uniquement les données des deux premières applications retournées par la demande. Pour plus d’informations sur les valeurs dans le corps de la réponse, consultez la section suivante.

{
  "@nextLink": "applications?skip=10&top=10",
  "value": [
    {
      "id": "9NBLGGH4R315",
      "primaryName": "Contoso sample app",
      "packageFamilyName": "5224ContosoDeveloper.ContosoSampleApp_ng6try80pwt52",
      "packageIdentityName": "5224ContosoDeveloper.ContosoSampleApp",
      "publisherName": "CN=…",
      "firstPublishedDate": "2016-03-11T01:32:11.0747851Z",
      "pendingApplicationSubmission": {
        "id": "1152921504621134883",
        "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621134883"
      }
    },
    {
      "id": "9NBLGGH29DM8",
      "primaryName": "Contoso sample app 2",
      "packageFamilyName": "5224ContosoDeveloper.ContosoSampleApp2_ng6try80pwt52",
      "packageIdentityName": "5224ContosoDeveloper.ContosoSampleApp2",
      "publisherName": "CN=…",
      "firstPublishedDate": "2016-03-12T01:49:11.0747851Z",
      "lastPublishedApplicationSubmission": {
        "id": "1152921504621225621",
        "resourceLocation": "applications/9NBLGGH29DM8/submissions/1152921504621225621"
      }
      // Next 8 apps are omitted for brevity ...
    }
  ],
  "totalCount": 21
}

Response body

Valeur Type Description
valeur tableau Tableau d’objets qui contiennent des informations sur chaque application inscrite dans votre compte. Pour plus d’informations sur les données de chaque objet, consultez la ressource Application.
@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 10, mais qu’il existe 20 applications inscrites sur votre compte, le corps de la réponse inclut une @nextLink valeur de applications?skip=10&top=10, ce qui indique que vous pouvez appeler https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 pour demander les 10 applications suivantes.
totalCount int Nombre total de lignes dans le résultat des données de la requête (autrement dit, le nombre total d’applications inscrites dans votre compte).

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 Aucune application n’a été trouvée.
409 Les applications utilisent les fonctionnalités de l’Espace partenaires qui ne sont actuellement pas prises en charge par l’API de soumission au Microsoft Store.