プロジェクト、タグ、および共有
ファイルライブラリはリソースの信頼できる情報源であり、プロジェクト、タグ、検索はそれらを整理するビューです。ファイルまたはドキュメントのIDは保持し、安定した識別子の代わりに名前を使用しないでください。
プロジェクト
Section titled “プロジェクト”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}ドキュメントをプロジェクトに追加しても、変更されるのは整理方法だけであり、ファイルはコピーされず、所有者も変わりません。
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}タグ名は表示用であり、削除、切り離し、クエリの際にはタグIDを使用します。
GET /api/v1/search?q={query}&limit=20検索では、現在のアカウントが読み取り可能なドキュメントおよびジョブのみが返されます。検索は読み取り操作であり、クレジットは消費されません。
リンクを共有
Section titled “リンクを共有”GET /api/v1/sharesPOST /api/v1/sharesGET /api/v1/shares/{token}GET /api/v1/shares/{token}/downloadDELETE /api/v1/shares/{token}POST /sharesは翻訳結果への読み取り専用リンクを作成します。本文には artifact_id と、オプションで expires_in_days(1~365日;指定しない場合、リンクは無期限)が含まれます。リンクを取得したユーザーは誰でもダウンロードできるため、ログや分析パラメータに含めないようにし、不要になったら削除してください。
アプリのワークスペース
Section titled “アプリのワークスペース”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsこれらのエンドポイントは、OmniDoc アカウント向けの統合ワークスペースを構築するためのものです。クライアントはレスポンスに記載されたエントリーや機能に従い、アプリ URL を自ら作成しないでください。