> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxanaut.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentification

> S'authentifier auprès de l'API Oxanaut : clés API personnelles et permissions.

L'API Oxanaut est servie sur `https://api.oxanaut.com`. Toutes les routes sont préfixées par `/v1`.

## Clés API

Créez une clé depuis le panel : **Intégrations → API Oxanaut → Activer / Configurer**. La clé commence par `oxn_` et n'est affichée qu'une fois à la création.

```bash Authorization theme={null}
Authorization: Bearer oxn_votre_cle
```

```bash Exemple theme={null}
curl https://api.oxanaut.com/v1/services \
  -H "Authorization: Bearer oxn_votre_cle"
```

## Permissions

| Permission   | Accès                                                           |
| ------------ | --------------------------------------------------------------- |
| `read`       | Requêtes `GET`/`HEAD` uniquement. Toute écriture renvoie `403`. |
| `read-write` | Toutes les routes autorisées pour votre compte.                 |

La permission est vérifiée côté serveur à chaque requête ; une clé `read` ne peut jamais modifier une ressource.

<Warning>
  Une clé API donne accès aux données de votre compte au même titre qu'une session. Nommez chaque clé selon son usage, donnez-lui une date d'expiration quand c'est possible, et révoquez les clés inutilisées.
</Warning>

## Conventions

* **Format** : JSON sur toutes les routes (`Content-Type: application/json`).
* **Erreurs** : format RFC 7807 simplifié — `statusCode`, `message`, éventuellement `error`.
* **Dates** : ISO 8601 (UTC).
* **Montants** : en centimes (`totalCents: 363` = 3,63 €).

## Périmètre des routes

La [Référence API](/api-reference/get-v1-services) documente l'ensemble des routes par domaine : compte, services, facturation, boutique et panier, intégrations, notifications, affiliation, statut. Les routes `/v1/admin/*` et `/v1/bot/*` nécessitent des droits serveur ou un token bot et sont regroupées en fin de référence.


## Related topics

- [Update a user (admin)](/api-reference/auth-&-users/update-a-user-admin.md)
- [Delete a user (admin)](/api-reference/auth-&-users/delete-a-user-admin.md)
- [Get the authenticated user profile](/api-reference/auth-&-users/get-the-authenticated-user-profile.md)
- [List a user's credits (admin)](/api-reference/auth-&-users/list-a-users-credits-admin.md)
- [List a user's invoices (admin)](/api-reference/auth-&-users/list-a-users-invoices-admin.md)