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

# Authentification

> Une clé de centre d'appels, ou un jeton d'API, dans l'en-tête Authorization.

Toute requête porte un jeton :

```http theme={"system"}
Authorization: Bearer <jeton>
```

`Bearer` se lit sans égard à la casse. Un jeton absent, inconnu ou révoqué reçoit un **401**, sans en dire plus.

## La clé d'un centre d'appels

* **Où la créer** : menu du compte › Clés et jetons (ou Appels › Configuration › Centres d'appels), dans l'agence choisie en haut de l'écran.
* **Qui la crée** : un administrateur de l'organisation ou de l'agence. Les autres comptes voient les clés sans pouvoir en créer ni en révoquer.
* **Sa forme** : `arq_` suivi de 32 caractères.
* **Affichée une seule fois** : Arquos n'en garde que l'empreinte. Une clé perdue se révoque et se recrée.
* **Elle n'expire pas**, et se révoque depuis le même écran. Les appels qu'elle a ouverts la citent toujours.

## Le jeton d'API

* **Où le créer** : menu du compte › Clés et jetons, rubrique Jetons d'API. Nommez le jeton d'après l'outil qui le recevra (« Claude Code du bureau », « notre ERP »), puis créez-le.
* **Sa forme** : `arq_agent_` suivi de 32 caractères. Il n'est affiché qu'à sa création.
* **Il ouvre l'API REST** (`/api/v2`) **et le serveur MCP** (`/api/mcp`) : ni le web, ni l'application myArquos.
* **Il agit au nom de votre compte**, avec vos droits : ce que vous ne pouvez pas faire dans Arquos, le jeton ne le peut pas non plus.
* **Il n'expire pas**. Il se révoque un par un, depuis la page Clés et jetons ; changer votre mot de passe les révoque tous.

<Warning>
  Un jeton d'API agit en votre nom. Ne le collez que dans un outil de confiance, et jamais dans un fichier partagé.
</Warning>

## Essayer

```bash theme={"system"}
curl -i https://api.arquos.eu/api/partners/calls/REF-INCONNUE \
  -H "Authorization: Bearer arq_VOTRE_CLE"
```

Une clé valide répond `404` (la référence n'existe pas), une clé fausse `401`.

Et avec un jeton d'API, l'API REST dit à qui il appartient et dans quelles agences il travaille :

```bash theme={"system"}
curl https://api.arquos.eu/api/v2/me \
  -H "Authorization: Bearer arq_agent_VOTRE_JETON"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.