Usando la SDK ufficiale di Misskey, o librerie di terze parti, puoi fruire della API in modo più conveniente. Per esempio semplificando alcuni dei passi descritti in questa pagina.
:::
Tanto per cominciare, ti occorre ottenere il **token di accesso** associato all'account che intendi usare per fruire delle API.
Questa pagina ti spiega passo passo come ottenerlo e le basi per fruire delle API.
## Ottenere un token di accesso
Le API, in generale, richiedono l'accesso autenticato da un token. Si tratta di un set di credenziali associate ad un profilo, che lo identificano e controllano quali operazioni sia autorizzato a svolgere quello specifico token.
Tra il profilo e i token c'è la relazione uno-a-molti, significa che per ogni profilo si possono creare più token (anche con diversi livelli di privilegi)
:::
Ci sono due modi per ottenere il token:
- [Richiederlo per se stessi](#richiedere-un-token-di-accesso-manualmente)
- [Richiederlo per un altro profilo che userà l'applicazione](#richiedere-l-emissione-di-un-token-di-accesso)
### Richiedere un token di accesso manualmente
Per ottenere un token per il proprio profilo, è sufficiente aprire il proprio profilo in Misskey e, nelle impostazioni, scegliere il menu API. Da lì, seguire le indicazioni.
L'**ID Sessione** dovrebbe essere generato ogni volta e mai riutilizzato.
:::
#### Passo 2
Nel browser della persona utilizzatrice dovrebbe comparire il modulo di autenticazione. Il modulo di autenticazione può essere aperto usando una URL simile a questa:
```:no-line-numbers
https://{host}/miauth/{session}
```
-`{host}` è il nome dell'istanza (di solito lo ha digitato la persona stessa)
-`{session}` è il valore **ID Sessione**
Si possono anche aggiungere alcune opzioni, come parametri GET nella URL:
Dopo che la persona ha autorizzato l'accesso alla tua applicazione, una richiesta HTTP, di tipo `POST` alla seguente risorsa restituirà il **token di accesso** come risposta.
```:no-line-numbers
https://{host}/api/miauth/{session}/check
```
-`{host}` è il nome dell'istanza della persona utilizzatrice (di solito lo ha digitato egli stessa)
-`{session}` è il valore **ID Sessione**
Le proprietà incluse nella risposta sono le seguenti:
| Parametro | Descrizione |
| --------- | ------------------------ |
| `token` | token di accesso |
| `user` | informazioni sul profilo |
## Fruire delle API
Una volta che hai ottenuto il **token di accesso** puoi usare le API inviando richieste HTTP alle varie risorse.
Il **token di accesso** deve essere incluso nel corpo nella richiesta, in un parametro chiamato `i`. Per avere maggiori informazioni sulle API, vedere il catalogo.
In aggiunta alle API HTTP, Misskey mette a disposizione anche le [Streaming API](./streaming/).
