Hämta alla appar

Använd den här metoden i Microsoft Store-api:et för överföring för att hämta data för de appar som är registrerade på ditt Partnercenter-konto.

Förutsättningar

Om du vill använda den här metoden måste du först göra följande:

  • Om du inte redan har gjort det, slutför alla krav för inlämning till Microsoft Store-API:et.
  • Hämta en Azure AD-åtkomsttoken som ska användas i begärandehuvudet för den här metoden. När du har fått en åtkomsttoken har du 60 minuter på dig att använda den innan den upphör att gälla. När token har upphört att gälla kan du skaffa en ny.

Begäran

Den här metoden har följande syntax. Se följande avsnitt för användningsexempel och beskrivningar av rubriken och begärandetexten.

Metod Begäran om URI
FÅ https://manage.devcenter.microsoft.com/v1.0/my/applications

Förfrågningshuvudrad

Rubrik Typ Beskrivning
Auktorisering snöre Obligatoriskt. Azure AD-åtkomsttokenet i formen Bearer<token>.

Parametrar för begäran

Alla parametrar för begäran är valfria för den här metoden. Om du anropar den här metoden utan parametrar innehåller svaret data för de första 10 apparna som är registrerade på ditt konto.

Parameter Typ Beskrivning Krävs
topp Int Antalet objekt som ska returneras i begäran (det vill: antalet appar som ska returneras). Om ditt konto har fler appar än det värde som du anger i frågan innehåller svarstexten en relativ URI-sökväg som du kan lägga till i metod-URI:n för att begära nästa sida med data. Nej
hoppa över Int Antalet objekt som ska kringgås i frågan innan de återstående objekten returneras. Använd den här parametern för att bläddra igenom datauppsättningar. Till exempel hämtar top=10 och skip=0 objekten 1 till och med 10, top=10 och skip=10 hämtar objekten 11 till 20 och så vidare. Nej

begäranens innehåll

Ange ingen begärandetext för den här metoden.

Exempel på begäran

I följande exempel visas hur du hämtar de första 10 apparna som är registrerade på ditt konto.

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

I följande exempel visas hur du hämtar information om alla appar som är registrerade på ditt konto. Hämta först de 10 bästa apparna:

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

Anropa sedan rekursivt GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink} tills {@nextlink} det är null eller inte finns i svaret. Till exempel:

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>

Om du redan känner till det totala antalet appar som du har i ditt konto kan du helt enkelt skicka det numret i den översta parametern för att få information om alla dina appar.

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

Svar

I följande exempel visas JSON-svarstexten som returneras av en lyckad begäran för de första 10 apparna som är registrerade på ett utvecklarkonto med totalt 21 appar. I det här exemplet visas bara data för de två första apparna som returneras av begäran. Mer information om värdena i svarstexten finns i följande avsnitt.

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

Svarsdel

Värde Typ Beskrivning
värde samling En matris med objekt som innehåller information om varje app som är registrerad på ditt konto. Mer information om data i varje objekt finns i Programresurs.
@nextLink snöre Om det finns ytterligare sidor med data, innehåller den här strängen en relativ sökväg som du kan lägga till i bas-https://manage.devcenter.microsoft.com/v1.0/my/-förfrågnings-URI:n för att begära nästa sida med data. Om den högsta parametern för den ursprungliga begärandetexten är inställd på 10 men 20 appar är registrerade på ditt konto, innehåller svarstexten ett @nextLink-värde på applications?skip=10&top=10, vilket anger att du kan anropa https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 för att begära nästa 10 apparna.
totalt antal Int Det totala antalet rader i dataresultatet för frågan (d.v.s. det totala antalet appar som är registrerade på ditt konto).

Felkoder

Om begäran inte kan slutföras innehåller svaret någon av följande HTTP-felkoder.

Felkod Beskrivning
404 Inga appar hittades.
409 Apparna använder Partnercenter-funktioner som för närvarande inte stöds av Microsoft Store-api:et för överföring.
  • Last updated on