SendbirdSendbird 聊天平台服务端 API v3
PUT/v3/group_channels/{channel_url}/join
加入公开群组频道
让用户加入公开群组频道,需提供 channel_url;仅 is_public 为 true 的频道可通过该接口加入。单个用户最多可加入 2,000 个群组频道,达到上限后无法再加入新频道。
通过官方 Sendbird Chat Platform API v3 管理用户、群组频道、开放频道、消息、元数据、审核、机器人与公告。完整边界为固定官方生成 SDK revision 重建的 83 个 REST Endpoint;客户端实时协议与 Chat SDK 不在本集合内。应用数据为调用方私有内容,Pontx 不代理、缓存或聚合,调用方使用本地 SDK/CLI 直连。
请求
- operationId
joinAChannel- 服务器
https://api-{app_id}.sendbird.com- 认证
- apiTokenAuth
请求参数
channel_url
pathstring必填
频道 URL
group_channel_123
Body 参数
字段: access_codeuser_id
响应
200
SendbirdGroupChannelDetailapplication/json
请求成功。
字段: channelchannel_urlcover_urlcreated_atcreated_bycustom_typedatadelivery_receiptdisappearing_messagefreezehas_ai_bothas_botidignore_profanity_filteris_access_code_requiredis_broadcastis_discoverableis_distinctis_ephemeralis_publicis_superjoined_member_countlast_messagemax_length_messagemember_countmembersmessage_survival_secondsnameoperatorsread_receiptsms_fallbackunread_mention_countunread_message_count
400
SendbirdApiErrorapplication/json
请求参数无效。
字段: codemessage
401
SendbirdApiErrorapplication/json
未认证或 API 令牌无效。
字段: codemessage
403
SendbirdApiErrorapplication/json
无权限访问该资源。
字段: codemessage
404
SendbirdApiErrorapplication/json
未找到指定资源。
字段: codemessage
429
SendbirdApiErrorapplication/json
请求频率超限,请稍后重试。
字段: codemessage
500
SendbirdApiErrorapplication/json
上游服务内部错误。
字段: codemessage
{
"channel_url": "group_channel_123",
"cover_url": "https://example.com/avatar.png",
"created_at": 1,
"created_by": {
"is_active": true,
"is_blocked_by_me": true,
"nickname": "Alice",
"profile_url": "https://example.com/avatar.png",
"require_auth_for_profile_image": true,
"role": "none",
"user_id": "user_id_123"
},
"custom_type": "default",
"data": "{\"key\":\"value\"}",
"delivery_receipt": {}
}