Jetons d'API
Créez un jeton dans Jetons d'API, copiez-le immédiatement (il n'est affiché qu'une fois) et transmettez-le dans un en-tête. Révoquez-le aussitôt s'il fuite.
Créez vos jetons dans Jetons d'API. Un jeton commence par clk_. Il n'est affiché qu'une seule fois, à sa création : nous n'en conservons que l'empreinte (hash), donc un jeton perdu ne peut pas être récupéré, seulement remplacé.
Utiliser un jeton
Transmettez-le dans un en-tête, soit Authorization: Bearer clk_…, soit X-API-Token: clk_…. Ne le placez jamais dans une chaîne de requête ni dans du code que d'autres personnes peuvent lire, comme une page web publique.
Garder un jeton en sécurité
- Un jeton par intégration, afin que la révocation de l'un n'empêche pas les autres de fonctionner.
- Donnez-lui une date d'expiration si la tâche est temporaire.
- Limitez-le aux plages d'adresses IP depuis lesquelles il sera appelé.
- Pendant le développement avec l'API REST, utilisez un jeton sandbox : il exécute les vraies calculatrices sans entamer votre quota mensuel, reste soumis à une limite de débit, et ses réponses comportent
X-Sandbox: true.