revokeChatInviteLink
撤销群组邀请链接。
请求
POST /:token/revokechatinvitelink
参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| chat_id | Integer/String | 是 | 目标聊天的唯一标识符或用户名 |
| invite_link | String | 是 | 要撤销的邀请链接 |
响应
返回被撤销的 ChatInviteLink 对象。
json
{
"ok": true,
"result": {
"invite_link": "https://t.me/+abc123def456",
"creator": {
"id": 123456789,
"is_bot": true,
"first_name": "MyBot",
"username": "my_bot"
},
"creates_join_request": false,
"is_primary": false,
"is_revoked": true,
"name": "推广链接",
"expire_date": 1700000000,
"member_limit": 100,
"pending_join_request_count": 0
}
}返回字段说明
| 字段 | 类型 | 描述 |
|---|---|---|
| invite_link | String | 邀请链接 URL |
| creator | User | 创建该链接的用户对象 |
| creates_join_request | Boolean | 是否需要管理员审批 |
| is_primary | Boolean | 是否为主邀请链接 |
| is_revoked | Boolean | 是否已被撤销,撤销后为 true |
| name | String | 链接名称 |
| expire_date | Integer | 过期时间,Unix 时间戳 |
| member_limit | Integer | 最大成员数限制 |
| pending_join_request_count | Integer | 待审批的加群请求数量 |
错误码
| 错误码 | 描述 |
|---|---|
| 400 | 请求参数错误,如 invite_link 格式无效 |
| 401 | Token 无效或已过期 |
| 403 | Bot 无权撤销该邀请链接 |
| 404 | 聊天或邀请链接不存在 |
| 500 | 服务器内部错误 |
