Skip to main content
Files

File の取得

Forward API リファレンス。

Description

Retrieves metadata for a single File by its ID.

パス

GET /api/v1/forward/files/{file_id}

リクエストヘッダー

ヘッダー必須説明
AuthorizationはいBearer <PAT または SAT>

パス参数

パラメーター必須説明
file_idstringはいFile ID to retrieve.

リクエスト例

curl -X GET "https://api.qoder.com/api/v1/forward/files/file_xxx" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK
{
  "id": "file_xxx",
  "type": "file",
  "filename": "report.pdf",
  "size_bytes": 1024,
  "mime_type": "application/pdf",
  "created_at": "2026-07-23T10:00:00Z",
  "updated_at": "2026-07-23T10:00:00Z",
  "downloadable": true,
  "scope": null,
  "metadata": {"source": "console"},
  "identity_id": null
}

レスポンスフィールド

The response is a File object.

エラー

HTTPType発生条件
400invalid_request_errorリクエストボディ、パスパラメーター、またはクエリパラメーターが不正です。
401authentication_error認証トークンがないか、無効です。
403permission_error呼び出し元にはこのリソースへのアクセス権限がありません。
404not_found_errorリソースが存在しないか、参照できません。
500/502/503api_errorForward または依存サービスでエラーが発生しました。
File の取得 - Qoder