Sendbird/joinAChannel

暂不支持在线调用 · 原因见下方

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 参数

JoinAChannelRequest

字段: 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": {}
}