ファイルをアップロード

curl --request POST \ --url https://{api_base_url}/files/upload \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: multipart/form-data' \ --form file='@example-file' \ --form 'user=<string>'

{ "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "name": "product-photo.png", "size": 204800, "extension": "png", "mime_type": "image/png", "created_by": "f1e2d3c4-b5a6-7890-abcd-ef1234567890", "created_at": 1705407629, "preview_url": null, "source_url": null, "original_url": null, "user_id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890", "tenant_id": "11223344-5566-7788-99aa-bbccddeeff00", "conversation_id": null, "file_key": "uploads/product-photo.png" }

Authorizations

Authorization

string

header

required

API Key 認証です。すべての API リクエストにおいて、Authorization HTTP ヘッダーに Bearer プレフィックスを付けた API Key を含めてください。例：Authorization: Bearer {API_KEY}。API Key はサーバーサイドに保存し、クライアントサイドで共有・保存しないことを強く推奨します。API Key の漏洩は深刻な結果につながる可能性があります。

Body

multipart/form-data

ファイルアップロードリクエスト。multipart/form-data 形式が必要です。

file

required

アップロードするファイル。サポートされるタイプには画像、ドキュメント、音声、動画が含まれます。

user

string

required

ユーザー識別子。開発者のルールで定義され、アプリケーション内で一意である必要があります。Service API と WebApp のユーザー ID は独立しており、値が同じでも同じユーザーを指しません。

Response

ファイルが正常にアップロードされました。

string<uuid>

一意のファイル ID。

name

string

ファイル名。

size

integer

ファイルサイズ（バイト）。

extension

string | null

ファイル拡張子。

mime_type

string | null

ファイルの MIME タイプ。

created_by

string<uuid> | null

ファイルをアップロードしたユーザーの ID。

created_at

integer<int64>

アップロードタイムスタンプ（Unix エポック秒）。

preview_url

string | null

ファイルのプレビュー URL。

source_url

string | null

ファイルのソース URL。

original_url

string | null

ファイルの元の URL。

user_id

string<uuid> | null

関連付けられたユーザーの ID。

tenant_id

string<uuid> | null

関連付けられたテナントの ID。

conversation_id

string<uuid> | null