getChatMember

获取聊天中某个成员的信息。

请求

POST /:token/getchatmember

参数

参数	类型	必填	描述
chat_id	Integer/String	是	目标聊天的唯一标识符或用户名
user_id	Integer	是	目标用户的唯一标识符

响应

返回 ChatMember 对象。

{
  "ok": true,
  "result": {
    "user": {
      "id": 123456789,
      "is_bot": false,
      "first_name": "张三",
      "username": "zhangsan"
    },
    "status": "administrator",
    "custom_title": "技术负责人",
    "is_anonymous": false,
    "can_manage_chat": true,
    "can_post_messages": true,
    "can_edit_messages": true,
    "can_delete_messages": true,
    "can_manage_video_chats": true,
    "can_restrict_members": true,
    "can_promote_members": false,
    "can_change_info": true,
    "can_invite_users": true,
    "can_pin_messages": true
  }
}

返回字段说明

字段	类型	描述
user	User	成员的用户信息对象
status	String	成员状态，可选值：creator、administrator、member、restricted、left、kicked
custom_title	String	管理员的自定义头衔
is_anonymous	Boolean	管理员是否匿名
can_manage_chat	Boolean	是否可以管理聊天
can_post_messages	Boolean	是否可以发布消息（仅频道）
can_edit_messages	Boolean	是否可以编辑消息（仅频道）
can_delete_messages	Boolean	是否可以删除消息
can_manage_video_chats	Boolean	是否可以管理视频聊天
can_restrict_members	Boolean	是否可以限制成员
can_promote_members	Boolean	是否可以提升成员为管理员
can_change_info	Boolean	是否可以修改聊天信息
can_invite_users	Boolean	是否可以邀请用户
can_pin_messages	Boolean	是否可以置顶消息

错误码

错误码	描述
400	请求参数错误，如缺少 chat_id 或 user_id
401	Token 无效或已过期
403	Bot 不是该聊天的成员，无权获取信息
404	聊天或用户不存在
500	服务器内部错误

示例

cURL

curl -X POST "https://api.example.com/<token>/getchatmember" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": -1001234567890,
    "user_id": 123456789
  }'