API esterna: upload e ricerca documenti

API per sistemi esterni

Theka offre un'API REST completa per permettere a sistemi esterni (ERP, CRM, e-commerce) di interagire con il DAM.

Autenticazione

L'autenticazione avviene tramite API key del tenant:

Authorization: Api-Key sk_tenant_abc123...
X-Tenant: mio-tenant

Upload documento

POST /api/v1/dam/external/assets/

Invia il file con i metadati (categoria, tipo, titolo, external_id). Se un documento con lo stesso external_id esiste gia', viene creata una nuova versione automaticamente.

Ricerca

GET /api/v1/dam/external/assets/?q=...&category=...&status=...

Cerca documenti per testo, categoria, stato, tag, entita', progetto. Supporta anche filtri sui campi personalizzati:

?custom_data.controparte=Rossi
?custom_data.valore__gte=50000
?custom_data.data_scadenza__lt=2026-06-01

Dettaglio

GET /api/v1/dam/external/assets/{id}/ — dettaglio completo con versioni, metadati, AI, varianti immagine.

GET /api/v1/dam/external/assets/by-external-id/{codice}/ — lookup per codice esterno.

Impersonamento permessi

Per default l'API key ha accesso admin. Per restringere:

X-Dam-User-Id: 42     # permessi dell'utente 42
X-Dam-Role-Slug: viewer  # permessi del ruolo viewer