Telegram 号码校验与资料查询 — 打开交互式演示
引导式在线测试。想要原始接口文档？ 查看接口文档 & 测试 →
接口列表
每次调用都会自动附带你的 API Key。
GET
/api/project/telegram/check-exists 检测 Telegram 账号是否存在
说明
解析 peer 并返回它是否注册在 Telegram 上——最便宜的查询，适合在 About/头像查询前预校验号码或用户名。当 exists=true 时，响应还会包含 Telegram 数字用户 ID、用户名（若有）、显示昵称，以及一个 userHash，需将其传给 About/头像接口以授权更重的查询。peer 支持完整国际号码、用户名或数字用户 ID。
| 参数 | 位置 | 值 |
|---|---|---|
| path |
curl -X GET 'https://api.opendata-api.com/api/project/telegram/check-exists?key=<API_KEY>&peer=<peer>'
GET
/api/project/telegram/get-about 获取 About / 简介
说明
获取 Telegram 用户的公开 About（简介）文本，以及数字用户 ID 与用户名。两步流程：先调用「检测 Telegram 账号是否存在」获取目标 peer 的 userHash，再将其传到此处。无有效（或已过期/未知）userHash 的调用会被拒绝。简介未设置或被隐私隐藏时返回空。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
curl -X GET 'https://api.opendata-api.com/api/project/telegram/get-about?key=<API_KEY>&userHash=<userHash>'
GET
/api/project/telegram/get-picture 获取头像（资料照片）
说明
获取 Telegram 用户的头像（资料照片），以 base64 编码返回（Telegram 头像无公开 URL）。两步流程：先调用「检测 Telegram 账号是否存在」获取目标 peer 的 userHash，再将其传到此处。无有效（或已过期/未知）userHash 的调用会被拒绝。peer 由 userHash 在服务端解析，不接受号码参数。未设置头像或因隐私隐藏时 pictureSet=false。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
curl -X GET 'https://api.opendata-api.com/api/project/telegram/get-picture?key=<API_KEY>&userHash=<userHash>'