Documentazione dell'API di App Center

"Specifica OpenAPI dell'App Center (Swagger)"

App Center offre un set completo di endpoint API. È possibile esplorare l'API di App Center tramite la specifica OpenAPI di App Center.

La specifica OpenAPI di App Center consente di eseguire l'autenticazione usando il token API. Dopo aver eseguito l'autenticazione, è possibile chiamare le API di App Center per ottenere informazioni sull'API e visualizzare i dati restituiti.

Tipi di token: token utente e token dell'app

App Center espone due tipi di token API: token utente e token dell'app.

I token API utente hanno gli stessi diritti che si hanno come utente di App Center. I token API utente funzionano in tutte le organizzazioni e le app a cui si è associati.

I token API dell'app hanno diritti di Amministratore o Osservatore, ma solo per un'app.

Ogni account di App Center può creare fino a 5000 token API.

Creazione di un token dell'API app di App Center

1. Passare a https://appcenter.ms e accedere usando le credenziali dell'account.

2. Selezionare l'app per cui si vuole creare un token API.

3. Sul lato sinistro scegliere Impostazioni.

4. Nel pannello centrale, selezionare Token API delle app dall'elenco dei menu.

5. Nell'angolo superiore destro fare clic su Nuovo token API.

6. Nel campo di testo immettere un nome descrittivo per il token.

7. Selezionare il tipo di accesso per il token dell'API dell'app:

   Accesso completo: Un token API app di accesso completo ha l'equivalente delle autorizzazioni di Manager per tale app. Solo i manager possono creare token api app di accesso completo.

   Sola lettura: Un token API dell'app di sola lettura ha l'equivalente delle autorizzazioni di accesso al Visualizzatore per tale app. I manager e gli sviluppatori possono creare token API di app di sola lettura.

8. Nella parte inferiore del pannello fare clic su Aggiungi nuovo token API.

9. Verrà aperta una finestra popup con il token dell'API dell'app. Copiare e archiviarlo in una posizione sicura per usarlo in un secondo momento. Per motivi di sicurezza, non è possibile visualizzare o generare di nuovo lo stesso token dopo aver fatto clic sul pulsante Chiudi .

10. Fare clic sul pulsante Chiudi .

Creazione di un token API utente di App Center

1. Passare a https://appcenter.ms e accedere usando le credenziali dell'account.

2. Nell'angolo in alto a destra del portale di App Center fare clic sull'avatar dell'account e quindi selezionare Impostazioni account.

3. Nel pannello centrale selezionare User API Tokens (Token API utente ) nell'elenco dei menu.

4. Nell'angolo superiore destro fare clic su Nuovo token API.

5. Nel campo di testo immettere un nome descrittivo per il token.

6. Selezionare il tipo di accesso per il token API utente:

   Accesso completo: Un token API utente con accesso completo ha tutte le autorizzazioni disponibili per l'account o l'organizzazione corrente. Ad esempio, se non si hanno autorizzazioni di gestione o sviluppatore per un'app, l'utente non può eseguire un test, anche se si usa un token API utente con accesso completo.

   Sola lettura: Un token API utente di sola lettura dispone dell'autorizzazione di accesso visualizzatore per l'account o l'organizzazione corrente. Ad esempio, con un token API utente di sola lettura, è possibile leggere i dati dai crash, dalle analisi e ottenere informazioni di base sull'app. I token API utente di sola lettura non possono modificare le impostazioni dell'app, creare una configurazione di esportazione e così via.

7. Nella parte inferiore del pannello fare clic su Aggiungi nuovo token API.

8. Verrà aperta una finestra popup con il token API utente. Copiare e archiviarlo in una posizione sicura per usarlo in un secondo momento. Per motivi di sicurezza, non è possibile visualizzare o generare di nuovo lo stesso token dopo aver fatto clic sul pulsante Chiudi .

9. Fare clic sul pulsante Chiudi .

Uso di un token API in una richiesta API

Quando si inviano richieste API ad App Center da un'applicazione, è necessario includere il token API nell'intestazione di ogni richiesta inviata ad App Center.

Passa il token API nella proprietà di intestazione della X-API-Token richiesta.

Trova il nome dell'app App Center e del relativo proprietario

Alcune delle funzioni API e delle richieste dell'interfaccia della riga di comando di App Center richiedono un nome dell'app o un nome di proprietario come parametri.

Ad esempio, la chiamata API per rimuovere l'utente dall'app richiede entrambi: DELETE /v0.1/apps/{owner_name}/{app_name}/users/{user_email}.

È possibile trovare il nome dell'app e il nome del proprietario da un URL di App Center o usare l'interfaccia della riga di comando di App Center.

Trova owner_name e app_name dall'URL di App Center

1. Navigare verso https://appcenter.ms.
2. Vai alla tua app.
3. Quando si esamina l'URL dell'app, esso è nel formato https://appcenter.ms/users/{owner-name}/apps/{app-name}.

Il proprietario può essere un utente o un'organizzazione. Per esempio:

Trovare owner_name e app_name dall'interfaccia della riga di comando di App Center

Se l'interfaccia della riga di comando di App Center non è ancora stata installata, le istruzioni di installazione e utilizzo sono disponibili nella documentazione dell'interfaccia della riga di comando di App Center.

Dopo l'installazione, recuperare l'elenco delle app a cui si ha accesso eseguendo:

appcenter apps list

L'interfaccia della riga di comando di App Center visualizzerà un elenco di app, con il formato {owner-name}/{app-name}.

Per un elenco completo delle funzioni della riga di comando, vedere la documentazione dell'interfaccia della riga di comando di App Center .

Uso di un token API con la specifica OpenAPI di App Center

La specifica OpenAPI di App Center gestisce automaticamente l'autenticazione api, quindi non è necessario incollare il token API in intestazioni per le richieste. Per testare le API di App Center con il token API:

1. Navigare alla specifica OpenAPI di App Center per esplorare le nostre API.

2. Nell'angolo in alto a destra fare clic sul pulsante Autorizza .

3. Nella sezione APIToken incollare il token API in Valore e fare clic su Autorizza.

   

4. Se viene visualizzato "Autorizzato" e un pulsante Disconnessione, l'autorizzazione ha avuto esito positivo. Nell'angolo superiore destro del popup fare clic sulla "X" per uscire dal popup.

Esecuzione della prima chiamata API con OpenAPI (Swagger)

Questa sezione illustra come usare la pagina OpenAPI di App Center usando la chiamata GET /v0.1/userAPI . Questa chiamata API restituisce i dati del profilo dell'utente.

1. Creare un token API seguendo le istruzioni riportate sopra.
2. Autorizzare la pagina Specifica OpenAPI a usare il token API seguendo le istruzioni riportate nella sezione precedente.
3. In Account fare clic su GET /v0.1/user.
4. Nell'angolo sinistro fare clic sul pulsante Prova .
5. Fare clic sul pulsante Esegui nella sezione Parametri .
6. Fantastico! È ora possibile visualizzare la risposta nella sezione Risposte .

Revoca del token API

Nel caso in cui si verifichi una perdita di token API, è consigliabile revocarla immediatamente per impedire l'accesso non autorizzato all'account di App Center.

Revoca di un token API utente

1. Navigare verso https://appcenter.ms.
2. Nell'angolo in alto a destra del portale di App Center fare clic sull'avatar dell'account e quindi selezionare Impostazioni account.
3. Nel pannello centrale selezionare User API Tokens (Token API utente ) dal menu.
4. Selezionare la casella accanto al token da revocare e fare clic sul pulsante Elimina nell'angolo in alto a destra.

Revoca di un token dell'API dell'app

1. Navigare verso https://appcenter.ms.
2. Selezionare l'app per cui si vuole revocare un token API.
3. Sul lato sinistro scegliere Impostazioni.
4. Nel pannello centrale, selezionare Token app API dal menu.
5. Selezionare la casella accanto al token da revocare e fare clic sul pulsante Elimina nell'angolo in alto a destra.