引导式在线测试。想要原始接口文档? 查看接口文档 & 测试 →
粘贴控制台中的 API Key,即可解锁下方所有接口。Key 仅保存在你的浏览器中。
请先粘贴 API Key。
每次调用都会自动附带你的 API Key。
/api/project/telegram/check-exists 检测 Telegram 账号是否存在
解析 peer 并返回它是否注册在 Telegram 上——最便宜的查询,适合在 About/头像查询前预校验号码或用户名。当 exists=true 时,响应还会包含 Telegram 数字用户 ID、用户名(若有)、显示昵称,以及一个 userHash,需将其传给 About/头像接口以授权更重的查询。peer 支持完整国际号码、用户名或数字用户 ID。
| Parameter | In | Value |
|---|---|---|
peer* | path |
/api/project/telegram/get-about 获取 About / 简介
获取 Telegram 用户的公开 About(简介)文本,以及数字用户 ID 与用户名。两步流程:先调用「检测 Telegram 账号是否存在」获取目标 peer 的 userHash,再将其传到此处。无有效(或已过期/未知)userHash 的调用会被拒绝。简介未设置或被隐私隐藏时返回空。
| Parameter | In | Value |
|---|---|---|
userHash* | query |
/api/project/telegram/get-picture 获取头像(资料照片)
获取 Telegram 用户的头像(资料照片),以 base64 编码返回(Telegram 头像无公开 URL)。两步流程:先调用「检测 Telegram 账号是否存在」获取目标 peer 的 userHash,再将其传到此处。无有效(或已过期/未知)userHash 的调用会被拒绝。peer 由 userHash 在服务端解析,不接受号码参数。未设置头像或因隐私隐藏时 pictureSet=false。
| Parameter | In | Value |
|---|---|---|
userHash* | query |