コミュニティの名刺カードの写真をアップロード（管理者用）

POST/manage/communities/:id/card-photo

コミュニティの名刺カードの背景に使う写真を multipart/form-data（フィールド名 cardPhoto）でアップロードし、保存された URL を返します。写真は向きを直し、長辺 1600px までに縮めて WebP にします。この呼び出しではコミュニティは変わりません。返った URL を PUT /manage/communities/:id の cardPhoto.url に渡すと保存されます。ADMIN のみ実行できます。

認証	要ログイン

パスパラメータ

idstring必須

コミュニティ ID。

リクエストボディ

cardPhotofile必須

画像ファイル（multipart/form-data）

補足

画像は multipart/form-data で送信します。対応形式は JPEG / PNG / GIF、最大 5MB です。制限を超えると 400（errorCode 10042）を返します。

コミュニティの管理者でなければ 403、コミュニティが無ければ 404 を返します。

レスポンス

フィールド	型	説明
`cardPhotoUrl`	string	アップロードした写真の URL。

リクエスト

curl https://api.4s.link/manage/communities/ID/card-photo \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -F "file=@image.png"

レスポンス例

{
  "cardPhotoUrl": "https://.../communities/c1a2b3c4-.../card-photo/1759500000000-abc123.webp"
}