コンテンツにスキップ

ファイルライブラリ

ファイルライブラリには、現在のアカウントがアクセス可能なソースファイル、ジョブ結果、およびアプリファイルが表示されます。各項目には固有の file_id が付与されており、呼び出し元が現在実行可能な操作を返します。

翻訳の入力として使用されるドキュメントにも、/api/v1/documents のリスト、詳細表示、更新、削除エンドポイントがあります。document_id は処理ジョブの作成に使用され、file_id はライブラリ全体の権限およびダウンロードに使用されます。これら2つの ID が互換性があると想定しないでください。

GET /api/v1/storage/files?offset=0&limit=50
GET /api/v1/storage/files/{file_id}

リスト応答:

{
"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
}

次のページを取得するには、offset に next_offset を渡してください。false が has_more になったら停止します。

各アイテムのcapabilitiesを必ず使用して、ダウンロード、共有、またはアプリへの付与が可能かどうかを判断してください。元のフィールドから権限を推測しないでください。

GET /api/v1/storage/files/{file_id}/content
POST /api/v1/storage/files/{file_id}/download-ticket

/content は一時的なダウンロードアドレスへ(302)リダイレクトします。リダイレクト先にアクセスする際は API キーを送信しないでください。まず download-ticket を取得することを推奨します。有効期限が切れた後は新しいアドレスを取得し、保存しないでください。

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}

権限の変更と公開リンクは別々の機能です。リンクを作成する際は、対象者、ダウンロード権限、有効期限、およびオプションでダウンロード回数を明示的に設定し、不要になったら速やかに無効化してください。

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

ワークスペースのエンドポイントはファイルセンターに適しており、/storage/filesは単一ファイルに対する権限およびダウンロード操作に適しています。