Alle apps downloaden

Gebruik deze methode in de Microsoft Store-indienings-API om gegevens op te halen voor de apps die zijn geregistreerd bij uw Partnercentrum-account.

Vereiste voorwaarden

Als u deze methode wilt gebruiken, moet u eerst het volgende doen:

  • Als u dit nog niet hebt gedaan, moet u alle vereisten voor de Microsoft Store-indienings-API voltooien.
  • Haal een Azure AD-toegangstoken op dat moet worden gebruikt in de aanvraagheader voor deze methode. Nadat u een toegangstoken hebt verkregen, hebt u 60 minuten om het te gebruiken voordat het verloopt. Nadat het token is verlopen, kunt u een nieuw token verkrijgen.

Aanvraag

Deze methode heeft de volgende syntaxis. Zie de volgende secties voor gebruiksvoorbeelden en beschrijvingen van de header en aanvraagtekst.

Methode URI-aanvraag
TOEVOEGEN https://manage.devcenter.microsoft.com/v1.0/my/applications

Header van het verzoek

Koptekst Typologie Beschrijving
Autorisatie touw Verplicht. Het Azure AD-toegangstoken in de vorm van Bearer<token>.

Aanvraagparameters

Alle aanvraagparameters zijn optioneel voor deze methode. Als u deze methode zonder parameters aanroept, bevat het antwoord gegevens voor de eerste 10 apps die zijn geregistreerd bij uw account.

Kenmerk Typologie Beschrijving Verplicht
Bovenaan int (integer) Het aantal items dat moet worden geretourneerd in de aanvraag (dat wil gezegd het aantal apps dat moet worden geretourneerd). Als uw account meer apps heeft dan de waarde die u in de query opgeeft, bevat de hoofdtekst van het antwoord een relatief URI-pad dat u kunt toevoegen aan de methode-URI om de volgende pagina met gegevens aan te vragen. Nee.
overslaan int (integer) Het aantal items dat moet worden overgeslagen in de query voordat de resterende items worden geretourneerd. Gebruik deze parameter om door gegevenssets te bladeren. Met top=10 en skip=0 worden bijvoorbeeld items 1 tot en met 10 opgehaald, top=10 en skip=10 worden items 11 tot en met 20 opgehaald, enzovoort. Nee.

Inhoud van het verzoek

Geef geen aanvraagbody op voor deze methode.

Voorbeelden opvragen

In het volgende voorbeeld ziet u hoe u de eerste 10 apps ophaalt die zijn geregistreerd bij uw account.

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

In het volgende voorbeeld ziet u hoe u informatie ophaalt over alle apps die zijn geregistreerd bij uw account. Haal eerst de tien belangrijkste apps op:

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

Roep vervolgens GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink} recursief aan totdat {@nextlink} null is of niet in de response voorkomt. Voorbeeld:

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>

Als u al weet hoeveel apps u in uw account hebt, kunt u dat nummer doorgeven in de bovenste parameter om informatie over al uw apps op te halen.

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

Reactie

In het volgende voorbeeld ziet u de hoofdtekst van het JSON-antwoord dat is geretourneerd door een geslaagde aanvraag voor de eerste 10 apps die zijn geregistreerd bij een ontwikkelaarsaccount met 21 apps. Ter beknoptheid toont dit voorbeeld alleen de gegevens voor de eerste twee apps die door de aanvraag worden geretourneerd. Zie de volgende sectie voor meer informatie over de waarden in de hoofdtekst van het antwoord.

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

Antwoordlichaam

Waarde Typologie Beschrijving
waarde gegevensreeks Een matrix met objecten die informatie bevatten over elke app die is geregistreerd bij uw account. Zie De toepassingsresource voor meer informatie over de gegevens in elk object.
@nextLink touw Als er extra pagina's met gegevens zijn, bevat deze tekenreeks een relatief pad dat u kunt toevoegen aan de basis-https://manage.devcenter.microsoft.com/v1.0/my/ aanvraag-URI om de volgende pagina met gegevens aan te vragen. Als de belangrijkste parameter van de initiële aanvraagtekst bijvoorbeeld is ingesteld op 10, maar er 20 apps zijn geregistreerd voor uw account, bevat de antwoordtekst een @nextLink waarde van applications?skip=10&top=10, wat aangeeft dat u https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 kunt aanroepen om de volgende tien apps aan te vragen.
totaalaantal int (integer) Het totale aantal rijen in het gegevensresultaat voor de query (dat wil gezegd het totale aantal apps dat is geregistreerd bij uw account).

Foutcodes

Als de aanvraag niet kan worden voltooid, bevat het antwoord een van de volgende HTTP-foutcodes.

Foutcode Beschrijving
404 Er zijn geen apps gevonden.
409 De apps maken gebruik van partnercentrumfuncties die momenteel niet worden ondersteund door de Microsoft Store-indienings-API.
  • Last updated on