API REST

L’API REST interna alimenta Vue SPA e gli script dell’operatore automatizzando la diagnostica o la clonazione.

Base e versione

• Percorso: /custom/knotmigration/api/
• Nessun prefisso /v1/ nell’URL
• Intestazione richiesta: “Knot-Migration-API-Versione: 2026-05-01”

Autenticazione

• Cookie di sessione Dolibarr valido
• Token CSRF “X-Dolibarr-CSRF” su POST/PUT/PATCH/Elimina
• Funzionalità: knotmigration.use, knotmigration.clone, knotmigration.admin

Busta di successo

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

Busta di errore

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

Gli endpoint sensibili passano attraverso api/_license_guard_bootstrap.php.

Prossimo

Licenza guardia_licenza_non_utilizzabile.