イベント

チャットルームのミーティング

GET/chat-rooms/:chatRoomId/meetings

チャットルームに紐づくミーティングを返します。チャット画面にミーティングの操作 UI や一覧を出すために使います。ルームのメンバーでない場合は 403 を返します。

認証要ログイン

パスパラメータ

chatRoomIdstring必須

チャットルーム ID。

クエリパラメータ

includeCanceledstring任意

true を指定するとキャンセル済みも返します。既定では返しません。

補足

2 人のダイレクトチャットは全イベントで共有されるため、同じ相手と別のイベントでもミーティングすると複数返ります(作成の新しい順)。どのイベントのものかは event で見分けてください。

event.hasEnded が true のミーティングは、イベントが終了しているため操作できません(ステータスの変更・場所と時間の設定は 400、errorCode 20001)。

レスポンス

フィールド型説明
meetingsMeeting[]ミーティングの配列(新しい順)。
リクエスト
curl https://api.4s.link/chat-rooms/CHAT_ROOM_ID/meetings \
-H "Authorization: Bearer 4s_at_..."
レスポンス例
{
"meetings": [
{
"id": "mt1a2b3c-...",
"eventId": "ev1a2b3c-...",
"chatRoomId": "cr1a2b3c-...",
"status": "REQUESTED"
}
]
}