Authentification

Chaque requête à l’API DIMARC porte une clé d’API de votre organisation.

Prérequis

• Un compte DIMARC actif, avec l’option API activée sur l’abonnement.
• Être administrateur de votre organisation.

Créer une clé d’API

1. Dans votre tableau de bord, cliquez en haut à droite sur l’icône de votre profil puis accédez à Organisation > API.
2. Cliquez sur Nouvelle clé, donnez-lui le nom de l’outil qui l’utilisera (par exemple « n8n production »).
3. Copiez la clé affichée : elle commence par dk_ et ne sera plus jamais affichée.

Attention

Une clé donne accès à vos services et à vos quotas. Ne la partagez pas, ne la mettez pas dans une URL. Si elle fuit, révoquez-la depuis la même page et créez-en une autre : la révocation est effective en moins de deux minutes.

Utiliser la clé

Envoyez-la dans le header Authorization (forme standard) ou x-api-key :

curl 'https://api.dimarc.ai/v2/agents' \
  --header 'Authorization: Bearer dk_votre_cle'

Les deux formes sont équivalentes sur toute l’API /v2 et sur l’API compatible OpenAI.

Intégrations existantes : token d’authentification

Les intégrations construites avant les clés d’API s’authentifient avec un ClientId et un ClientSecret, échangés contre un token d’une heure. Ce flux reste servi ; il n’est plus proposé aux nouvelles intégrations. Vos identifiants ne sont plus affichés dans l’application : contactez-nous si vous en avez besoin.

Récupérer votre Token d’Authentification

POST /v2/token

Une fois que vous disposez de votre ClientId et de votre ClientSecret, vous pouvez générer un token d’authentification en suivant ces étapes :

1. Faites une requête POST à notre endpoint d’authentification https://api.dimarc.ai/v2/token avec vos identifiants dans le corps JSON
2. Récupérez le token JWT retourné

Requête

curl --location 'https://api.dimarc.ai/v2/token' \
  --header 'Content-Type: application/json' \
  --data '{"client_id": "votre-client-id", "client_secret": "votre-client-secret"}'

Attention

L’ancienne forme GET /v2/token?client_id=…&client_secret=… est dépréciée : elle fait transiter votre secret dans l’URL. Elle reste servie jusqu’au 30 novembre 2026 (en-têtes Deprecation et Sunset), migrez vers la requête POST avant cette date.

Réponse

{
    "access_token": "**************",
    "token_type": "x-api-key",
    "expires_in": "3600"
}

Note

Le token a une durée de validité limitée. Assurez-vous de mettre en place un mécanisme de rafraîchissement automatique.

Astuce

Bonnes pratiques de sécurité

• Ne stockez jamais vos identifiants API dans du code exposé publiquement
• Utilisez des variables d’environnement pour stocker vos clés API
• Surveillez l’utilisation de vos clés et contactez immédiatement Dimarc en cas de suspicion de compromission

Utiliser le token d’authentification

Pour utiliser le token d’authentification dans vos requêtes API, incluez-le dans le header x-api-key de la requête :

curl --request GET \
  --url https://api.dimarc.ai/v2/endpoint \
  --header 'x-api-key: **************'

Dépannage

Si vous rencontrez des problèmes d’authentification, vérifiez les points suivants :

1. Vos identifiants (ClientId et ClientSecret) sont correctement saisis
2. Votre token n’est pas expiré
3. Votre compte a les permissions nécessaires pour l’opération demandée

Pour toute assistance supplémentaire, contactez notre support technique à l’adresse: contact@dimarc.fr