ファイル一覧

GET https://api.inoneapi.com/v1/files

現在の API キーのメタデータをページ単位で取得します。作成日時の降順、同一日時では ID の降順です。ファイル内容や署名 URL は返しません。

Authorization: Bearer $INONEAPI_API_KEY を指定し、リクエスト本文は送信しません。アップロードしたキーのみ操作できます。同じユーザーやプロジェクトの別キーでもアクセスできません。推論料金や残高は不要ですが、キーのレート・同時実行制限とプロジェクトの状態は適用されます。

リクエスト項目

パラメーター型必須説明
limitintegerいいえ既定 20、範囲 1–100。
afterstringいいえ前ページの last_id。最初は省略。現在のキーに属する既存 ID が必要。

offset、並び順、種類や状態によるフィルターは提供しません。ページ取得が完了する前に現在のカーソルのメタデータを削除しないでください。

リクエスト例

JavaScript は Node.js 20+ のサーバーで INONEAPI_API_KEY を設定して実行します。

curl  --get https://api.inoneapi.com/v1/files \
  -H "Authorization: Bearer $INONEAPI_API_KEY" \
  --data-urlencode limit=20

応答内容

{
  "object": "list",
  "data": [
    {
      "id": "file_ioa_0123456789abcdef0123456789abcdef",
      "object": "file",
      "filename": "sample.pdf",
      "mime_type": "application/pdf",
      "media_type": "document",
      "bytes": 1024,
      "status": "ready",
      "created_at": 1789430400,
      "purpose": "user_data"
    }
  ],
  "has_more": false,
  "first_id": "file_ioa_0123456789abcdef0123456789abcdef",
  "last_id": "file_ioa_0123456789abcdef0123456789abcdef"
}

object は list、data はアップロード応答と同じ形式の配列、has_more は次ページの有無、first_id と last_id はページの先頭と末尾の ID です。空の場合は data: []、has_more: false、両 ID は空文字列です。終了判定には件数の推測ではなく has_more を使います。

エラーと制約

limit の範囲や型、after の形式が不正な場合は 400 INVALID_FILE_REQUEST。カーソルが存在しない、または別キーの場合は 404 FILE_NOT_FOUND。DB 障害は 503 FILE_STORAGE_UNAVAILABLE。キーの制限で 429 が返る場合は Retry-After があれば従ってください。

ready と uploading の両方を含みます。COS の自動削除はメタデータを削除しないため、古い ready は読み取り可能性を保証しません。固定スナップショットではなく、並行アップロードが取得済みページに追加されることはありません。最新の一覧が必要なら最初から取得してください。

ファイルガイド · POST /v1/files · エラーコード

ファイル一覧 · ドキュメント · InOneAPI