Aller au contenu

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.

GET /api/v1/storage/files?offset=0&limit=50
GET /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.

GET /api/v1/storage/files/{file_id}/content
POST /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.

GET /api/v1/storage/files/{file_id}/permissions
POST /api/v1/storage/files/{file_id}/permissions
DELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/links
POST /api/v1/storage/files/{file_id}/links
DELETE /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.

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

Les 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.