チャットルーム一覧

GET/chat-rooms

認証中ユーザーが参加しているチャットルームの一覧を返します。未読件数と直近のメッセージを含みます。

認証要ログイン

クエリパラメータ

pagenumber

ページ番号(1 始まり)。デフォルト 1。

perPagenumber

1 ページあたりの件数。デフォルト 20。

communityIdstring

コミュニティ ID で絞り込む。

qstring

ルーム名・メンバー名の部分一致。

レスポンス

フィールド説明
chatRoomsChatRoom[]チャットルームの配列。
pageInfoobjectページ情報。
リクエスト
curl https://api.4s.link/chat-rooms \
-H "Authorization: Bearer 4s_at_..."
レスポンス例
{
"chatRooms": [
{
"id": "r1a2b3c4-...",
"type": "GROUP",
"name": "Project Team",
"members": [
{
"id": "rm1a2b3-...",
"status": "JOINED",
"user": { "id": "a1b2c3d4-...", "slug": "taro", "firstName": "太郎", "lastName": "山田", "avatarUrl": "https://.../avatar.png" }
}
],
"lastMessage": { "id": "m1a2b3c4-...", "content": "よろしくお願いします", "createdAt": "2026-08-18T00:00:00.000Z" },
"unreadCount": 0
}
],
"pageInfo": { "totalCount": 100, "totalPages": 5, "page": 1, "perPage": 20 }
}