Transmettez votre clé dans Authorization: Bearer ou X-API-Key. Ne la placez jamais dans une URL ni dans le code public d’un site.
Authorization: Bearer ke_live_REPLACE_WITH_YOUR_KEYUne clé ke_live_ est rattachée à une seule organisation. Les permissions de lecture, d’écriture et d’envoi sont distinctes. Chaque opération indique les permissions acceptées.
Comprendre une erreur
401 MISSING_API_KEY ou INVALID_API_KEY : vérifiez la clé, l’en-tête et l’environnement. 403 INSUFFICIENT_SCOPE : vérifiez les permissions requises par l’opération.
Les autres erreurs métier sont décrites par opération. Conservez le code HTTP et le champ error pour diagnostiquer un échec.
Après un délai d’attente sur une écriture ou un envoi, vérifiez le résultat avant de réessayer : toutes les opérations ne sont pas idempotentes.