Bibliothèque de fichiers
La bibliothèque de fichiers affiche les fichiers source, les résultats des tâches et les fichiers d’application auxquels le compte actuel a accès. Chaque élément possède un identifiant stable file_id et renvoie les actions que l’appelant peut effectuer à l’heure actuelle.
Les documents utilisés comme entrée de traduction disposent également des points de terminaison /api/v1/documents pour la liste, le détail, la mise à jour et la suppression. document_id sert à créer des travaux de traitement ; file_id concerne les autorisations et les téléchargements à l’échelle de la bibliothèque. Ne supposez pas que ces deux identifiants sont interchangeables.
Lister et détailler
Section intitulée « Lister et détailler »GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Liste des réponses :
{ "items": [ { "id": "x7m4q2k9n6c1v8pa", "name": "report.docx", "content_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "size_bytes": 45678, "status": "ready", "publication_status": "draft", "origin": { "product_code": "omnidoc-main", "display_name": "OmniDoc" }, "capabilities": { "can_view": true, "can_download": true, "can_update": true, "can_delete": true, "can_share": true }, "created_at": "2026-10-01T12:00:00Z", "updated_at": "2026-10-01T12:00:00Z" } ], "has_more": true, "next_offset": 50}Pour obtenir la page suivante, passez next_offset en tant que offset ; arrêtez-vous lorsque has_more est false.
Utilisez toujours le capabilities de chaque élément pour déterminer s’il peut être téléchargé, partagé ou accordé à une application ; ne déduisez pas les autorisations à partir des champs d’origine.
Télécharger
Section intitulée « Télécharger »GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content redirige (302) vers une adresse de téléchargement éphémère ; n’envoyez pas la clé API lors de cette redirection. Il est recommandé de demander un download-ticket au préalable. Demandez une nouvelle adresse après l’expiration de l’ancienne ; ne la stockez pas.
Autorisations et liens
Section intitulée « Autorisations et liens »GET /api/v1/storage/files/{file_id}/permissionsPOST /api/v1/storage/files/{file_id}/permissionsDELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/linksPOST /api/v1/storage/files/{file_id}/linksDELETE /api/v1/storage/files/{file_id}/links/{link_id}Les modifications d’autorisations et les liens publics sont des fonctionnalités distinctes. Lorsque vous créez un lien, définissez explicitement son audience, les autorisations de téléchargement, la date d’expiration ainsi qu’un nombre maximal de téléchargements optionnel ; révoquez-le dès qu’il n’est plus nécessaire.
Vues de l’espace de travail
Section intitulée « Vues de l’espace de travail »GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsLes points de terminaison d’espace de travail conviennent à un centre de fichiers ; /storage/files s’applique aux actions d’autorisation et de téléchargement sur un fichier unique.