Condividi tramite


Ottenere un'app

Usa questo metodo nell'API di invio a Microsoft Store per recuperare informazioni su un'app specifica registrata nel tuo account del Centro per i partner.

Prerequisiti

Per usare questo metodo, è prima necessario eseguire le operazioni seguenti:

  • Se non l'hai già fatto, completa tutti i prerequisiti per l'API di invio al Microsoft Store.
  • Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, si hanno 60 minuti per usarlo prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.

Richiesta

Questo metodo ha la sintassi seguente. Vedere le sezioni seguenti per esempi di utilizzo e descrizioni dell'intestazione e del corpo della richiesta.

Metodo URI della richiesta
OTTIENI https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}

Header di richiesta

Intestazione TIPO Descrizione
Autorizzazione corda Obbligatorio. Token di accesso di Azure AD nel formato Bearer<token>.

Parametri della richiesta

Nome TIPO Descrizione
ID dell'applicazione corda Obbligatorio. ID dello Store per recuperare l'app. Per altre informazioni sull'ID dello Store, vedere Visualizzare i dettagli dell'identità dell'app.

Testo della richiesta

Non bisogna fornire il corpo della richiesta per questo metodo.

Esempio di richiesta

L'esempio seguente illustra come recuperare informazioni su un'app con il valore id dello Store 9NBLGGH4R315.

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

Risposta

L'esempio seguente illustra il corpo della risposta JSON per una chiamata riuscita a questo metodo. Per altri dettagli sui valori nel corpo della risposta, vedere Risorsa applicazione.

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": false
}

Codici di errore

Se la richiesta non può essere completata correttamente, la risposta conterrà uno dei codici di errore HTTP seguenti.

Codice di errore Descrizione
404 Impossibile trovare l'app specificata.
409 L'app usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio a Microsoft Store.