Copy

パス

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

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

パラメーター	型	必須	説明
`file_id`	string	はい	File ID to download.

パラメーター	型	必須	説明
`identity_id`	string	いいえ	Identity に属するリソースを操作する場合にのみ使用します。PAT ではクエリパラメーターとして明示的に指定でき、省略すると管理者 Scope になります。SAT の帰属は認証情報によって決まります。Admin SAT を含むすべての SAT でこのパラメーターを明示的に指定すると、空値でも HTTP 400 が返されます。詳細は Identity の帰属を参照してください。

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

{
  "url": "https://example.com/signed-url",
  "expires_at": "2026-07-23T12:00:00Z"
}

該当しません。このエンドポイントはリストを返しません。

フィールド	型	説明
`url`	string	一時ダウンロード URL。
`expires_at`	string	ダウンロード URL の有効期限。

HTTP	Type	発生条件
400	`invalid_request_error`	クエリパラメーターが不正です。SAT でクエリパラメーター `identity_id` を明示的に指定した場合（空値を含む）も該当します。
401	`authentication_error`	認証トークンがないか、無効です。
403	`permission_error`	管理者 Scope で Owner mismatch が発生したか、下流サービスがアクセスを拒否しました。
404	`not_found_error`	File が存在しないか、現在の Identity Scope から参照できません。PAT で指定した Identity が無効、無効化済み、削除済み、または権限範囲外の場合も該当します。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。