Skip to content

Authentification

Créer une clé d’API et l’utiliser dans vos requêtes.

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 :

  1. 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.
  2. 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

Type to search…

↑↓ navigate↵ selectEsc close