apipick-telegram-check

TotalClaw 作者 totalclaw

使用 apipick Telegram Checker API 检查电话号码是否在 Telegram 上注册。返回注册状态、Telegram 用户 ID、用户名、名字/姓氏和数据中心 ID。当用户想要验证电话号码的 Telegram 注册、通过电话号码查找 Telegram 用户名或检查某人是否使用 Telegram 时使用。需要 apipick API 密钥 (x-api-key)。在 https://www.apipick.com 获取免费密钥。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~javainthinking-apipick-telegram-phone-check

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~javainthinking-apipick-telegram-phone-check/file -o javainthinking-apipick-telegram-phone-check.md

# apipick Telegram Phone Checker

Check Telegram registration status for any phone number with international country code.

## Endpoint

```
POST https://www.apipick.com/api/check-phone-telegram
```

**Authentication:** `x-api-key: YOUR_API_KEY` header required.
Get a free API key at https://www.apipick.com/dashboard/api-keys

## Request

```json
{"phone_number": "+1234567890"}
```

Phone number must include international country code (e.g. `+86` for China, `+1` for US).

## Response

```json
{
  "code": 200,
  "registered": true,
  "user_id": 123456789,
  "username": "example_user",
  "first_name": "John",
  "last_name": "Doe",
  "dc_id": 2,
  "message": "User found successfully"
}
```

If `registered` is `false`, `user_id`, `username`, `first_name`, `last_name` will be null/empty.
Only publicly visible Telegram profile information is returned.

## Error Codes

| Code | Meaning |
|------|---------|
| 400 | Invalid phone number format |
| 401 | Missing or invalid API key |
| 402 | Insufficient credits |

**Cost:** 1 credit per request

## Usage Pattern

1. Use `$APIPICK_API_KEY` env var as the `x-api-key` header value; if not set, ask the user for their apipick API key
2. Ensure the phone number includes a country code
3. Make the POST request
4. Report registration status and available profile info

See [references/api_reference.md](references/api_reference.md) for full response field descriptions.

---

## 中文说明

# apipick Telegram 电话号码检查器

检查任意带国际区号的电话号码的 Telegram 注册状态。

## 接口端点

```
POST https://www.apipick.com/api/check-phone-telegram
```

**身份验证：** 需要 `x-api-key: YOUR_API_KEY` 请求头。
在 https://www.apipick.com/dashboard/api-keys 获取免费 API 密钥

## 请求

```json
{"phone_number": "+1234567890"}
```

电话号码必须包含国际区号（例如中国为 `+86`，美国为 `+1`）。

## 响应

```json
{
  "code": 200,
  "registered": true,
  "user_id": 123456789,
  "username": "example_user",
  "first_name": "John",
  "last_name": "Doe",
  "dc_id": 2,
  "message": "User found successfully"
}
```

如果 `registered` 为 `false`，则 `user_id`、`username`、`first_name`、`last_name` 将为 null 或空值。
仅返回公开可见的 Telegram 个人资料信息。

## 错误代码

| 代码 | 含义 |
|------|------|
| 400 | 电话号码格式无效 |
| 401 | API 密钥缺失或无效 |
| 402 | 额度不足 |

**费用：** 每次请求 1 个额度

## 使用模式

1. 使用 `$APIPICK_API_KEY` 环境变量作为 `x-api-key` 请求头的值；如果未设置，则向用户索取其 apipick API 密钥
2. 确保电话号码包含区号
3. 发起 POST 请求
4. 报告注册状态和可用的个人资料信息

完整的响应字段说明请参见 [references/api_reference.md](references/api_reference.md)。