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.

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.