イベント
ミーティングをリクエスト
POST
/events/:eventId/meetingsイベントの他の参加者にミーティングをリクエストします。相手とのダイレクトチャットルームが無ければ作成し、最初のメッセージとして本文を投稿します。作成直後のステータスは REQUESTED で、場所と時間は未定です。
| 認証 | 要ログイン |
|---|
パスパラメータ
eventIdstring必須イベント ID。
リクエストボディ
toUserIdstring必須リクエストする相手のユーザー ID。
messagestring必須最初のメッセージ本文。
補足
イベントの enabledMeetings が false の場合は 400(errorCode 40001)を返します。自分自身へのリクエストは 40002、双方いずれかがイベントに参加していない場合は 40003 / 40004、相手が受付を切っている場合は 40015 です。
同じ相手とのミーティングは、キャンセル済み・拒否済みを含めて一度でも作成されていれば再リクエストできません(errorCode 40005)。イベントごとのリクエスト作成上限に達している場合は 40014 を返します。
レスポンス
| フィールド | 型 | 説明 |
|---|---|---|
meeting | Meeting | 作成されたミーティング。event / chatRoom / fromUser / toUser / spot を含みます。 |
リクエスト
curl https://api.4s.link/events/EVENT_ID/meetings \-X POST \-H "Authorization: Bearer 4s_at_..." \-H "Content-Type: application/json" \-d '{"toUserId": "u9f8e7d6-...","message": "お話しさせていただけませんか?"}'
レスポンス例
{"meeting": {"id": "mt1a2b3c-...","eventId": "ev1a2b3c-...","chatRoomId": "cr1a2b3c-...","fromUserId": "u1a2b3c4-...","toUserId": "u9f8e7d6-...","status": "REQUESTED","spotId": null,"startAt": null,"endAt": null,"createdAt": "2026-06-01T09:00:00.000Z"}}