API & Développeurs4 min de lecture

Utiliser l'API CometReach

Générer une clé API et interroger l'API publique depuis vos outils.

Générer une clé API

  1. Allez dans Compte > API & Développeurs.
  2. Cliquez sur "Générer une clé API".
  3. Copiez la clé immédiatement — elle ne sera plus affichée en clair.
  4. Stockez-la de manière sécurisée (gestionnaire de secrets, variable d'environnement).
⚠️ Attention : Ne partagez jamais votre clé API publiquement. Si vous pensez qu'elle est compromise, révoquez-la immédiatement et régénérez-en une nouvelle.

Authentification

Toutes les requêtes à l'API doivent inclure votre clé dans le header Authorization :

  • Authorization: Bearer cmr_votreclé
💡 Conseil : Les clés API CometReach commencent toujours par "cmr_".

Documentation interactive

La documentation complète de l'API est disponible dans Compte > API & Développeurs > Documentation. Elle est interactive : vous pouvez tester chaque endpoint directement depuis le navigateur en renseignant votre clé.

La spec OpenAPI est disponible à GET /api/v1/public/openapi.json pour l'importer dans Postman, Insomnia ou tout autre client.