# Documentation API

### Authentification à l’API

L’accès à l’API `https://api.entreprise.page/v1` nécessite une authentification par clé d’API.

#### Conditions d’accès

L’API est uniquement accessible aux comptes disposant d’un **abonnement supérieur au plan Starter**. Si vous utilisez un compte avec un abonnement Starter, veuillez effectuer une mise à niveau pour bénéficier de l’accès à l’API.

#### Clé d’API

Une fois votre abonnement éligible activé, votre clé d’API est disponible dans votre compte utilisateur.

#### Méthodes d’authentification

Vous pouvez transmettre la clé d’API de deux manières :

**1. Dans les en-têtes HTTP**

C’est la méthode recommandée.

```http
GET /v1/ressource HTTP/1.1
Host: api.entreprise.page
X-API-Key: votre_clef_api
```

**2. En paramètre de la query string**

Vous pouvez également passer la clé dans l’URL (moins sécurisé – à éviter pour des appels côté client ou en production) :

```
https://api.entreprise.page/v1/ressource?api_key=votre_clef_api
```

#### Bonnes pratiques

* **Ne partagez jamais** votre clé d’API publiquement (GitHub, forums, etc.).
* Stockez votre clé de manière sécurisée (variables d’environnement, outils de gestion de secrets).
* En cas de compromission, régénérez immédiatement une nouvelle clé depuis votre espace personnel.

