> For the complete documentation index, see [llms.txt](https://docs.dydu.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dydu.ai/developpeurs/reference-api/authentification.md).

# Authentification

La plupart des API de la solution Dydu demandent une authentification : un jeton à placer dans l'en-tête `Authorization` de vos requêtes (champ **Authorization** dans l'interface Swagger).

Deux types de jeton sont acceptés :

* **Basic** : construit à partir de votre login et de votre mot de passe ;
* **Bearer** : un jeton temporaire fourni par l'API d'authentification.

## Authentification Basic

Pour construire le jeton :

1. Concaténez votre login, le caractère « : » et votre mot de passe (attention à la casse).
2. Encodez cette chaîne en base64.
3. Ajoutez « Basic » suivi d'un espace devant le résultat.

> Exemple : &#x20;
>
> 1\. « <demo@dydu.ai>:MyPassword »
>
> 2\. « ZGVtb0BkeWR1LmFpOk15UGFzc3dvcmQ= »&#x20;
>
> 3\. « Basic ZGVtb0BkeWR1LmFpOk15UGFzc3dvcmQ= »

Vous pouvez aussi générer ce jeton depuis la page `https://<serveur>/servlet/authentication.html` : saisissez votre login et votre mot de passe, puis cliquez sur **Generate**. Le jeton est calculé dans votre navigateur.

{% hint style="info" %}
Remplacez `<serveur>` par l'adresse de votre plateforme.
{% endhint %}

## Authentification Bearer

Vous pouvez obtenir un jeton temporaire avec l'API **POST /authentication/token** (catégorie **Account** de l'interface Swagger). Ce jeton est valable 8 heures.

| Paramètre  | Description         | Obligatoire |
| ---------- | ------------------- | ----------- |
| `login`    | Votre login.        | Oui         |
| `password` | Votre mot de passe. | Oui         |

Requête curl :

```
curl -X POST "https://<serveur>/servlet/api/authentication/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "login=demo@dydu.ai&password=MyPassword"
```

La réponse est un texte qui contient directement la valeur à placer dans l'en-tête `Authorization` :

```
Bearer eyJhbGciOi...
```

Si le login ou le mot de passe est incorrect, l'API renvoie une erreur **401** « Invalid authentication ».

## Utiliser le jeton

Placez le jeton complet, avec « Basic » ou « Bearer », dans l'en-tête `Authorization` :

```
curl -X GET "https://<serveur>/servlet/api/..." -H "Authorization: Basic ZGVtb0BkeWR1LmFpOk15UGFzc3dvcmQ="
```

{% hint style="warning" %}
Si une API renvoie une erreur **401**, vérifiez votre login et votre mot de passe, et que vous n'avez pas oublié « Basic » ou « Bearer » devant le jeton.
{% endhint %}
