API REST

L’API REST interne sert la SPA Vue et les scripts opérateur automatisant diagnostic ou clonage.

Base et versioning

• Chemin : /custom/knotmigration/api/
• Pas de préfixe /v1/ dans l’URL
• Header obligatoire : Knot-Migration-API-Version: 2026-05-01

Authentification

• Cookie session Dolibarr valide
• Token CSRF X-Dolibarr-CSRF sur POST/PUT/PATCH/DELETE
• Capabilities : knotmigration.use, knotmigration.clone, knotmigration.admin

Enveloppe succès

{
  "data": { },
  "meta": { "request_id": "req_abc123", "generated_at": "2026-05-17T10:42:00Z" }
}

Enveloppe erreur

{
  "error": "human-readable explanation",
  "code": "KM_API_*",
  "request_id": "req_abc123"
}

Les endpoints sensibles passent par api/_license_guard_bootstrap.php.

Suite

Licence Garde-fou license_not_usable.