Salta ai contenuti

Progetti, tag e condivisione

La libreria dei file è la fonte unica di verità per le risorse; progetti, tag e ricerca sono visualizzazioni che le organizzano. Conservare gli ID dei file o dei documenti; non utilizzare i nomi al posto di identificatori stabili.

GET /api/v1/projects
POST /api/v1/projects
GET /api/v1/projects/{project_id}
PATCH /api/v1/projects/{project_id}
DELETE /api/v1/projects/{project_id}
POST /api/v1/projects/{project_id}/documents
DELETE /api/v1/projects/{project_id}/documents/{document_id}

L’aggiunta di un documento a un progetto modifica solo la sua organizzazione: il file non viene copiato e il suo proprietario rimane invariato.

GET /api/v1/tags
POST /api/v1/tags
DELETE /api/v1/tags/{tag_id}
POST /api/v1/tags/documents/{document_id}
DELETE /api/v1/tags/documents/{document_id}/{tag_id}

Il nome del tag è destinato alla visualizzazione; l’eliminazione, il distacco e le query utilizzano l’ID del tag.

GET /api/v1/search?q={query}&limit=20

La ricerca restituisce solo documenti e job che l’account corrente può leggere. La ricerca è un’operazione di lettura e non consuma crediti.

GET /api/v1/shares
POST /api/v1/shares
GET /api/v1/shares/{token}
GET /api/v1/shares/{token}/download
DELETE /api/v1/shares/{token}

POST /shares crea un link di sola lettura verso un risultato di traduzione; il corpo contiene artifact_id e un expires_in_days facoltativo (da 1 a 365; in sua assenza il link non scade). Chiunque disponga del link può effettuare il download, pertanto evitare di includerlo nei log o nei parametri di analisi e eliminarlo quando non è più necessario.

GET /api/v1/workspace/files
GET /api/v1/workspace/entries
GET /api/v1/workspace/apps

Questi endpoint sono destinati alla creazione di un workspace unificato per un account OmniDoc. I client dovrebbero fare riferimento alle voci e alle funzionalità riportate nelle risposte, evitando di generare autonomamente gli URL delle applicazioni.