Créer une clé d’API
Il faut être administrateur de l’entreprise, avec l’accès Lecture & Edition. Dans Puncto, ouvrez Intégrations › API :
- Cliquez sur Créer une clé, nommez-la d’après l’outil qui l’utilisera et choisissez son accès : Lecture Seule ou Lecture & Edition.
- Copiez la clé affichée, car elle ne sera plus visible ensuite.
- La clé donne accès aux données de toute l’entreprise, dans la limite de l’accès choisi.
- Gardez-la côté serveur, jamais dans une application web ou mobile.
- Créez une clé par outil. Vous pouvez révoquer chaque clé depuis la même page sans affecter les autres. Les requêtes qui utilisent une clé révoquée échouent immédiatement.
Envoyer la clé
Passez la clé dans l’en-tête Authorization de chaque requête :
curl https://api.puncto.fr/public/v1/collaborators \
-H "Authorization: Bearer $PUNCTO_TOKEN"Environnements
| Environnement | URL de base |
|---|---|
| Production | https://api.puncto.fr |
| Staging | https://staging.api.puncto.fr |
Chaque environnement a ses propres clés. Validez votre intégration en staging avant de passer en production.
Erreurs
| Statut | Cause |
|---|---|
401 |
Clé absente, invalide ou révoquée |
403 |
Opération hors de l’accès de la clé, par exemple une écriture avec une clé en lecture seule |