Migration v2 (breaking changes)
API DIMARC - Documentation
Authentification
Agents
Documents
Agent Documentaliste
Agent Extracteur
Classification
Webhooks
Usage
Codes d'erreur
Migration v2
Section intitulée « Migration v2 »Authentification
Section intitulée « Authentification »- Prérequis
- Créer une clé d’API
- Récupération du token
- Utilisation du token
- Bonnes pratiques de sécurité
- Dépannage
Agent Documentaliste
Section intitulée « Agent Documentaliste »- Prérequis
- Récupération de l’ID d’agent
- Communication avec l’agent
- Gestion de l’historique
- Limites et considérations
Agent Extracteur
Section intitulée « Agent Extracteur »- Prérequis
- Deux approches d’extraction
- Modes de traitement
- Extraction synchrone
- Codes d’erreur
- Extraction asynchrone
- Structure des paramètres
- Limites et considérations
Webhooks
Section intitulée « Webhooks »- Événements
- Enveloppe des événements
- Configurer un webhook
- Vérification de la signature
- Politique de retries
Codes d’erreur
Section intitulée « Codes d’erreur »Toute erreur des endpoints /v2 sort dans la même enveloppe :
{ "status": "error", "code": "agent_not_found", "error": "Agent not found", "detail": { } }code est un identifiant machine stable, error un message humain qui peut évoluer sans préavis, detail un objet optionnel. L’API compatible OpenAI a son propre format d’erreur — voir API compatible OpenAI.
L’ensemble des codes que l’API peut renvoyer :
| Code | Signification |
|---|---|
agent_not_found |
Agent introuvable, mauvais type, privé, ou organisation invalide |
thread_not_found |
thread_id fourni introuvable pour cet agent |
infected_file |
Fichier rejeté par l’antivirus |
antivirus_unavailable |
Service antivirus indisponible |
agent_unavailable |
Agent temporairement indisponible (file de traitement) |
agent_timeout |
Timeout de la réponse agent |
extraction_failed |
Échec du traitement (extraction ou réponse knowledge) |
no_data_extracted |
Le document ne contient aucune donnée exploitable |
classification_failed |
Échec du traitement de classification |
invalid_request |
Requête invalide (validation du body ou de l’URL) |
internal_error |
Erreur interne inattendue |
unsupported_file_type |
Type de fichier non supporté |
file_too_large |
Fichier dépassant la taille maximale autorisée |
document_already_exists |
Document déjà existant |
document_not_found |
Document introuvable |
document_synced |
Document synchronisé depuis un dossier de drive |
quota_exceeded |
Quota d’utilisation dépassé |
spending_limit_reached |
Plafond de dépense de l’organisation atteint |
rate_limit_exceeded |
Débit dépassé ; Retry-After porte les secondes avant la prochaine fenêtre |
concurrent_limit_exceeded |
Trop de traitements simultanés pour l’organisation ; Retry-After porte les secondes avant de réessayer |
queue_saturated |
Moteur de traitement saturé ; Retry-After porte les secondes avant de réessayer |
turn_not_found |
GET /v2/turns/{turn_id} : identifiant inconnu, expiré, ou d’une autre organisation |
maintenance |
Service temporairement fermé aux nouvelles requêtes (503) ; la lecture des résultats (GET /v2/turns/{turn_id}) reste disponible, réessayez dans quelques minutes |
invalid_agent_type |
Type d’agent invalide pour cet endpoint |
invalid_config |
Configuration d’agent invalide |
webhook_not_found |
Aucun webhook configuré pour cet événement |
organization_not_found |
Organisation introuvable |
unauthorized |
Authentification manquante ou invalide |
invalid_client |
Identifiants client invalides (/v2/token) |
forbidden |
Accès API désactivé pour l’organisation |
Support et Assistance
Section intitulée « Support et Assistance »Pour toute question concernant l’API DIMARC, contactez notre équipe de support technique à l’adresse contact@dimarc.fr