Créer une clé API

Lecture ou écriture ; le secret ne s'affiche qu'une seule fois.

Rôle : GestionnaireDurée : 2 minSur : Web

Sur cette page

Avant de commencer

5 étapes, environ 2 min

1
Ouvrez Développeurs
10 s
Dans l’Administration, Réglages, puis Développeurs : l’onglet Clés API s’ouvre.
Administration/Réglages/Développeurs
Ouvrir cet écran dans Callizy
2
Nommez la clé
20 s
Cliquez Nouvelle clé. Dans Nom de la clé, dites à quoi elle sert, par exemple « Intégration CRM ».
3
Choisissez l’accès
20 s
Lecture : lire les appels, textos, contacts et statistiques. Lecture et écriture, choisi au départ : en plus, appeler, texter et créer des contacts. Ne donnez que ce dont l’outil a besoin, puis cliquez Générer.
4
Copiez la clé et le secret
30 s
« Clé créée. Copiez-la maintenant. » : copiez la Clé publique et le Secret avec leurs boutons, puis cliquez C’est noté. Le secret ne sera plus jamais affiché.
5
Appelez l’API
30 s
Chaque requête porte deux en-têtes : X-API-Key, la clé, qui commence par clz_, et X-API-Secret. Cette requête renvoie la fiche de votre entreprise.
curl https://api.callizy.ca/api/v1/company/ -H "X-API-Key: clz_…" -H "X-API-Secret: …"

Le secret ne s’affiche qu’une fois : gardez-le sur votre serveur.
Une clé en Lecture reçoit une erreur 403 sur toute écriture.
Désactiver une clé se défait ; la supprimer arrête les intégrations qui l’utilisent.