En utilisant le SDK officiel Misskey ou une librairie tierce, vous pouvez utiliser l’API de manière à simplifier des étapes décrites dans ce document.
Voir [ici](TODO) pour plus d’informations à propos des librairies.
:::
Pour commencer à utiliser l’API vous aurez besoin une **clé d’accès** associée à un compte.
Ce document vous accompagne dans l’obtention de cette clé et montre comment l’utiliser pour un usage basique.
## Obtenir une clé d’accès
L’API requiert une clé d’accès pour ses requêtes.
Une clé d’accès est un ensemble de données associée à une personne, l’identifiant comme utilisant l’API et contrôlant les opérations qui sont effectuées.
La clé est nominative et ne peut être utilisée que par une personne, plusieurs clés peuvent être possédées par une personne.
:::
Vous pouvez facilement [obtenir votre clé d’accès](#Méthode-manuelle), ou une [clé pour une personne utilisant votre application](#Demander-une-clé-d’accès)..
### Méthode manuelle
Vous pouvez créer votre propre clé d’accès via l’interface Misskey Web dans la section API des paramètres.
Le formulaire d’identification de l’application doit s’afficher dans le navigateur. Cela peut être fait via une URL de format:
```:no-line-numbers
https://{host}/miauth/{session}
```
où
-`{host}` est l’hôte de l’instance, généralement entré manuellement;
-`{session}` est l’ID session.
Vous pouvez également ajouter des options telles que des paramètres dans l’URL:
| nom | description |
| ---- | ---- |
| `name` | nom de l’application |
| `icon` | URL de l’icône de l’application |
| `callback` | L’URL de redirection après identificaton, avec l’ID session en tant que `session`. |
| `permission` | Les permissions requises par l’application. <br>Liste les permissions à demander, séparées par `,`. La liste complète est consultable [ici](TODO). |
