ダウンロード用の署名付き URL を発行

GET/chat-rooms/:roomId/files/:fileId/url

ファイルは非公開のため、都度この API で期限付きの URL を取得します。disposition=inline は PDF など許可された形式のときだけ尊重され、それ以外は必ず attachment になります。URL はファイル名の指定を含むので、そのままリンクとして開けばダウンロードできます。

認証	要ログイン

パスパラメータ

roomIdstring必須

チャットルーム ID。

fileIdstring必須

ファイル ID。

クエリパラメータ

dispositionstring任意

attachment（既定）か inline。

レスポンス

フィールド	型	説明
`url`	string	ファイルの署名付き URL。
`expiresIn`	number	URL の有効秒数。
`expiresAt`	string	URL の有効期限（ISO 8601）。
`fileName / mimeType / size`	mixed	ファイル名・MIME タイプ・バイト数。
`disposition`	'inline' \| 'attachment'	ブラウザでの開き方。PDF や画像は inline。

リクエスト

curl https://api.4s.link/chat-rooms/ROOM_ID/files/FILE_ID/url \
  -H "Authorization: Bearer 4s_at_..."

レスポンス例

{
  "url": "https://.../chat-files/...?X-Amz-Signature=...",
  "expiresIn": 300,
  "expiresAt": "2026-08-29T00:05:00.000Z",
  "fileName": "report.pdf",
  "mimeType": "application/pdf",
  "size": 1234567,
  "disposition": "inline"
}