Proyectos, etiquetas y uso compartido
La biblioteca de archivos es la fuente de verdad para los recursos; los proyectos, las etiquetas y la búsqueda son vistas que los organizan. Mantenga los identificadores de archivo o documento; no utilice nombres en lugar de identificadores estables.
Proyectos
Sección titulada «Proyectos»GET /api/v1/projectsPOST /api/v1/projectsGET /api/v1/projects/{project_id}PATCH /api/v1/projects/{project_id}DELETE /api/v1/projects/{project_id}
POST /api/v1/projects/{project_id}/documentsDELETE /api/v1/projects/{project_id}/documents/{document_id}Agregar un documento a un proyecto solo modifica su organización: el archivo no se copia y su propietario no cambia.
Etiquetas
Sección titulada «Etiquetas»GET /api/v1/tagsPOST /api/v1/tagsDELETE /api/v1/tags/{tag_id}
POST /api/v1/tags/documents/{document_id}DELETE /api/v1/tags/documents/{document_id}/{tag_id}El nombre de la etiqueta es solo para visualización; al eliminar, desvincular y consultar se utiliza el ID de la etiqueta.
GET /api/v1/search?q={query}&limit=20La búsqueda devuelve únicamente los documentos y trabajos que la cuenta actual puede leer. La búsqueda es una operación de lectura y no consume créditos.
Compartir enlaces
Sección titulada «Compartir enlaces»GET /api/v1/sharesPOST /api/v1/sharesGET /api/v1/shares/{token}GET /api/v1/shares/{token}/downloadDELETE /api/v1/shares/{token}POST /shares crea un enlace de solo lectura al resultado de la traducción; el cuerpo contiene artifact_id y un expires_in_days opcional (de 1 a 365; sin él, el enlace no caduca). Cualquier persona que posea el enlace puede descargarlo, así que manténgalo fuera de los registros y de los parámetros de análisis, y elimínelo cuando ya no sea necesario.
Espacio de trabajo de la aplicación
Sección titulada «Espacio de trabajo de la aplicación»GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsEstos puntos finales están diseñados para crear un espacio de trabajo unificado para una cuenta OmniDoc. Los clientes deben seguir las entradas y capacidades incluidas en las respuestas y no generar direcciones URL de aplicaciones por su cuenta.