Scaricare tutte le app
Usare questo metodo nell'API di invio di Microsoft Store per recuperare dati per le app registrate nel proprio account del Centro per i partner.
Prerequisiti
Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:
- Se non lo si ha ancora fatto, completare i prerequisiti per l'API di invio di 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, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
Richiedi
Questo metodo ha la sintassi seguente. Vedere le sezioni seguenti per esempi di uso e descrizioni dell'intestazione e del corpo della richiesta.
| metodo | URI della richiesta |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/applications |
Intestazione della richiesta
| Intestazione | Type | Descrizione |
|---|---|---|
| Autorizzazione | stringa | Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>. |
Parametri della richiesta
Tutti i parametri della richiesta sono facoltativi per questo metodo. Se si chiama questo metodo senza parametri, la risposta conterrà i dati per le prime 10 app registrate nel proprio account.
| Parametro | Tipo | Descrizione | Richiesto |
|---|---|---|---|
| migliori | int | Numero di elementi da restituire nella richiesta (ossia il numero di app da restituire). Se nel proprio account è presente un numero di app maggiore del valore specificato nella query, il corpo della risposta includerà un percorso URI relativo che è possibile aggiungere all'URI del metodo per richiedere la pagina di dati successiva. | No |
| skip | int | Numero di elementi da ignorare nella query prima di restituire gli elementi rimanenti. Usare questo parametro per scorrere i set di dati. Ad esempio, top=10 e skip=0 recupera gli elementi da 1 a 10, top=10 e skip=10 recupera gli elementi da 11 a 20 e così via. | No |
Corpo della richiesta
Non fornire un corpo della richiesta per questo metodo.
Esempi di richiesta
L'esempio seguente illustra come recuperare le prime 10 app registrate nel proprio account.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications HTTP/1.1
Authorization: Bearer <your access token>
L'esempio seguente illustra come recuperare tutti informazioni su tutte le app registrate nel proprio account. Per prima cosa, ottenere le prime 10 app:
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?top=10 HTTP/1.1
Authorization: Bearer <your access token>
Quindi chiamare in modo ricorsivo GET https://manage.devcenter.microsoft.com/v1.0/my/{@nextLink} finché {@nextlink} non è null o assente nella risposta. Ad esempio:
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>
Se si conosce già il numero totale di app presenti nell'account, è sufficiente passare tale numero nel parametro top per ottenere informazioni su tutte le app.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications?top=23 HTTP/1.1
Authorization: Bearer <your access token>
Response
L'esempio seguente illustra il corpo della risposta JSON restituito da una richiesta riuscita delle prime 10 app registrate in un account sviluppatore con 21 app totali. Per brevità, questo esempio mostra solo i dati per le prime due app restituite dalla richiesta. Per ulteriori dettagli sui valori nel corpo della risposta, vedere la sezione seguente.
{
"@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
}
Corpo della risposta
| Valore | Tipo | Descrizione |
|---|---|---|
| valore | matrice | Matrice di oggetti che contengono informazioni su ogni app registrata nel proprio account. Per ulteriori informazioni sui dati in ogni oggetto, vedere Risorsa dell'applicazione. |
| @nextLink | string | Se sono presenti pagine aggiuntive di dati, questa stringa contiene un percorso relativo che è possibile aggiungere all'URI della richiesta https://manage.devcenter.microsoft.com/v1.0/my/ di base per richiedere la pagina di dati successiva. Ad esempio, se il parametro top del corpo della richiesta iniziale è impostato su 10 ma vi sono 20 app registrate nel proprio account, il corpo della risposta includerà un valore @nextLink applications?skip=10&top=10 che indica che è possibile chiamare https://manage.devcenter.microsoft.com/v1.0/my/applications?skip=10&top=10 per richiedere le successive 10 app. |
| totalCount | int | Numero totale di righe nel risultato dei dati per la query (ossia il numero totale di app registrate nel proprio account). |
Codici di errore
Se la richiesta non può essere completata, la risposta conterrà uno dei codici di errore HTTP seguenti.
| Codice errore | Descrizione |
|---|---|
| 404 | Non sono state trovate app. |
| 409 | Le app usano funzionalità del Centro per i partner attualmente non supportate dall'API di invio di Microsoft Store. |