API Partenaires DocPro

Intégrez la génération intelligente de documents à vos propres systèmes (SIRH, ERP, portails RH…). API REST v1, réponses JSON, authentification par clé. L'accès API est un canal facturé au contrat B2B — contactez notre équipe commerciale pour l'activer en production.

1. Authentification

Chaque requête doit porter votre clé API dans l'en-tête Authorization :

Authorization: Bearer dp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Générez vos clés dans la section « Mes clés API » ci-dessous. La clé claire n'est affichée qu'une seule fois : seule son empreinte SHA-256 est conservée. Limite : 60 appels / minute / clé (au-delà : HTTP 429).

2. Endpoints

GET/api/v1/templates

Liste des modèles de documents disponibles avec leur questionnaire (champs).

curl https://docpro.example.com/api/v1/templates \
  -H "Authorization: Bearer dp_live_xxx"

# 200 OK
{
  "templates": [
    {
      "code": "cv_pro",
      "name": "CV Professionnel",
      "category": "rh_emploi",
      "price": 500,
      "currency": "XOF",
      "fields": [
        { "key": "nom_complet", "label": "Nom complet", "type": "text", "required": true },
        ...
      ]
    }
  ]
}

POST/api/v1/documents

Génère un document : rendu du modèle, score qualité, code de vérification. Le document est rattaché au compte propriétaire de la clé.

curl -X POST https://docpro.example.com/api/v1/documents \
  -H "Authorization: Bearer dp_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "template_code": "cv_pro",
    "language": "fr",
    "answers": {
      "nom_complet": "Aya Koné",
      "email": "aya.kone@example.com"
    }
  }'

# 201 Created
{
  "id": "cmb1x…",
  "verify_code": "cmb1y…",
  "quality_score": 86,
  "html": "<div>…document généré…</div>"
}

GET/api/v1/documents/{id}

Métadonnées + HTML d'un document généré. Accessible uniquement au propriétaire de la clé (sinon 404).

curl https://docpro.example.com/api/v1/documents/cmb1x… \
  -H "Authorization: Bearer dp_live_xxx"

# 200 OK
{
  "id": "cmb1x…",
  "template_code": "cv_pro",
  "title": "CV Professionnel",
  "language": "fr",
  "quality_score": 86,
  "verify_code": "cmb1y…",
  "status": "paye",
  "paid": true,
  "created_at": "2026-07-16T10:30:00.000Z",
  "html": "<div>…</div>"
}

GET/api/v1/verify/{code}

Vérifie l'authenticité d'un document par son code de vérification (QR). Aucune donnée personnelle n'est exposée.

curl https://docpro.example.com/api/v1/verify/cmb1y… \
  -H "Authorization: Bearer dp_live_xxx"

# 200 OK — document authentique
{ "authentic": true, "type": "CV Professionnel", "generated_at": "2026-07-16T10:30:00.000Z" }

# 200 OK — code inconnu
{ "authentic": false, "type": null, "generated_at": null }

3. Codes d'erreur

Toutes les erreurs suivent le même format JSON :

{ "error": { "code": "missing_fields", "message": "Champs obligatoires manquants : nom_complet." } }

HTTP	Code	Signification
401	`missing_key`	En-tête Authorization absent ou malformé
401	`invalid_key`	Clé inconnue ou révoquée
404	`template_not_found`	Code de modèle inexistant ou inactif
404	`document_not_found`	Document inexistant ou appartenant à un autre compte
422	`validation_error`	Corps de requête invalide (template_code, answers…)
422	`missing_fields`	Champs obligatoires du questionnaire manquants
429	`rate_limited`	Plus de 60 appels / minute sur la clé
500	`internal_error`	Erreur interne — réessayez plus tard

4. Mes clés API

Connectez-vous pour générer et gérer vos clés API.

Se connecter