Référence de l'API

Documentation provisoire : l'API n'est pas encore en service. Adresses et champs peuvent changer.

Authentification

Les clés API arriveront bientôt dans votre espace client. Une fois créée, envoyez la clé dans l'en-tête Authorization: Bearer de chaque requête.

Lancer un traitement

Envoyez le fichier, le nom de l'outil (son adresse sur le site, par exemple vectoriser-logo) et ses réglages. Le coût en crédits est débité au lancement.

POST /v1/jobs
Authorization: Bearer VOTRE_CLE_API
Content-Type: multipart/form-data

tool=convertir-cmjn
options[profil]=Coated FOGRA39
human_check=false
file=@visuel.jpg

{
  "id": "job_8f2c41",
  "status": "processing",
  "tool": "convertir-cmjn",
  "cost_gn": 5,
  "created_at": "2026-10-15T14:02:11Z"
}

Suivre un traitement

GET /v1/jobs/{id} renvoie l'état : queued, processing, human_review, completed ou failed.

Webhooks

Indiquez une adresse de rappel dans votre espace : nous l'appelons quand un traitement se termine.

{
  "event": "job.completed",
  "job": {
    "id": "job_8f2c41",
    "status": "completed",
    "result_url": "https://…/visuel-cmjn.pdf",
    "report": { "checks": ["Profil FOGRA39 appliqué", "Résolution 300 DPI"] }
  }
}

Erreurs