Freigeben über

Alle Apps anzeigen

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um Daten für die Apps abzurufen, die für Ihr Partner Center-Konto registriert sind.

Voraussetzungen

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes ausführen:

  • Wenn Sie dies noch nicht getan haben, erledigen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API.
  • Holen Sie sich ein Azure AD-Zugriffstoken, um es im Header der Anfrage für diese Methode zu verwenden. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.

Anfrage

Diese Methode weist die folgende Syntax auf. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen der Kopfzeile und des Anforderungstexts.

Methode Anforderungs-URI
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v1.0/my/applications

Anforderungs-Kopfzeile

Kopfzeile Typ BESCHREIBUNG
Autorisierung Schnur Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>.

Anforderungsparameter

Alle Anforderungsparameter sind für diese Methode optional. Wenn Sie diese Methode ohne Parameter aufrufen, enthält die Antwort Daten für die ersten 10 Apps, die für Ihr Konto registriert sind.

Parameter Typ BESCHREIBUNG Erforderlich
Nach oben INT Die Anzahl der Elemente, die in der Anforderung zurückgegeben werden sollen (d. r. die Anzahl der zurückzugebenden Apps). Wenn Ihr Konto über mehr Apps als den Wert verfügt, den Sie in der Abfrage angeben, enthält der Antworttext einen relativen URI-Pfad, den Sie an den Methoden-URI anfügen können, um die nächste Seite mit Daten anzufordern. Nein
hüpfen INT Die Anzahl der Elemente, die in der Abfrage umgangen werden sollen, bevor die verbleibenden Elemente zurückgegeben werden. Verwenden Sie diesen Parameter, um durch Datensätze zu blättern. Beispielsweise ruft top=10 und skip=0 Elemente 1 bis 10 ab, top=10 und skip=10 ruft Elemente 11 bis 20 ab usw. Nein

Anfragekörper

Geben Sie keinen Request-Body für diese Methode an.

Beispiele anfordern

Im folgenden Beispiel wird veranschaulicht, wie die ersten 10 Apps abgerufen werden, die für Ihr Konto registriert sind.

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

Im folgenden Beispiel wird veranschaulicht, wie Sie Informationen zu allen Apps abrufen, die für Ihr Konto registriert sind. Holen Sie sich zuerst die 10 besten Apps:

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

Rufen Sie dann rekursiv GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink} auf, bis {@nextlink} null ist oder in der Antwort nicht vorhanden ist. Beispiel:

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>

Wenn Sie bereits die Gesamtzahl der Apps kennen, die Sie in Ihrem Konto haben, können Sie diese Nummer einfach im obersten Parameter übergeben, um Informationen zu allen Apps zu erhalten.

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

Antwort

Im folgenden Beispiel wird der JSON-Antworttext veranschaulicht, der von einer erfolgreichen Anforderung für die ersten 10 Apps zurückgegeben wird, die für ein Entwicklerkonto mit insgesamt 21 Apps registriert sind. Aus Platzgründen zeigt dieses Beispiel nur die Daten für die ersten beiden Apps an, die von der Anforderung zurückgegeben werden. Weitere Informationen zu den Werten im Antworttext finden Sie im folgenden Abschnitt.

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

Antwortkörper

Wert Typ BESCHREIBUNG
Wert Array Ein Array von Objekten, die Informationen zu jeder App enthalten, die für Ihr Konto registriert ist. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unter Application-Ressource.
@nextLink Schnur Wenn zusätzliche Datenseiten vorhanden sind, enthält dieser String einen relativen Pfad, den Sie an den Basis-https://manage.devcenter.microsoft.com/v1.0/my/-Anforderungs-URI anfügen können, um die nächste Seite mit Daten anzufordern. Wenn beispielsweise der top Parameter des anfänglichen Anforderungstexts auf 10 festgelegt ist, aber 20 Apps für Ihr Konto registriert sind, enthält der Antworttext einen @nextLink Wert von applications?skip=10&top=10, der angibt, dass Sie https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 aufrufen können, um die nächsten 10 Apps anzufordern.
Gesamtanzahl INT Die Gesamtzahl der Zeilen im Datenergebnis für die Abfrage (d. r. die Gesamtanzahl der Apps, die für Ihr Konto registriert sind).

Fehlercodes

Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.

Fehlercode BESCHREIBUNG
404 Es wurden keine Apps gefunden.
409 Die Apps verwenden Partner Center-Features, die derzeit von der Microsoft Store-Übermittlungs-APInicht unterstützt werden.
  • Last updated on