长效号码 API

批量购买手机号码并长期持有，每个号码都有独立的短信查询令牌，可反复接收验证码。典型流程：选项目 → （可选）选前缀 → 购买下单 → 用号码令牌轮询短信。

获取项目分类

GET/api/v1/app/categories

获取项目分类列表，用于按分类筛选项目。

响应示例

{
  "code": 1,
  "msg": "success",
  "data": [
    { "id": 1, "name": "社交" },
    { "id": 2, "name": "电商" }
  ]
}

获取项目列表

GET/api/v1/apps

查询参数

参数	类型	必填	说明
`page`	int	否	页码，默认 1
`limit`	int	否	每页数量，默认 40
`keyword`	string	否	项目名称关键词
`cate_id`	int	否	分类 ID，0 表示全部

请求示例

curl "https://a.yljm.cc/api/v1/apps?keyword=telegram&page=1&limit=20" \
  -H "Authorization: 你的API_KEY"

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": 123,
        "name": "Telegram",
        "icon": "https://a.yljm.cc/uploads/icons/123.png?w=46&h=46",
        "cate_id": 1,
        "price": 0.5,          // 单价（USDT）
        "stock": 20000,        // 库存
        "success_rate": 92.5   // 近期接码成功率 %，无数据为 null
      }
    ],
    "total": 1
  }
}

获取号码前缀

GET/api/v1/apps/{id}/prefixes

查询指定项目可用的号段前缀及数量，购买时可用 prefix 指定号段。

路径与查询参数

参数	类型	必填	说明
`id`	int	是	项目 ID（路径参数）
`type`	int	否	订单类型，固定 1，默认 1
`expiry`	int	否	有效期档位 0-5，默认 0

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "list": [
      { "prefix": "1440", "num": 3500 },
      { "prefix": "1332", "num": 1200 }
    ],
    "total": 4700
  }
}

购买号码

POST/api/v1/orders

批量购买号码，下单即从余额扣款。返回订单信息与号码清单，每个号码带独立短信查询令牌 token。

请求体（JSON）

参数	类型	必填	说明
`app_id`	int	是	项目 ID
`num`	int	是	购买数量 1～50000
`type`	int	否	订单类型，固定 1
`expiry`	int	否	有效期档位 0-5，默认 0
`prefix`	string	否	指定号段前缀
`exclude_prefix`	string	否	排除号段前缀

请求示例

curl -X POST "https://a.yljm.cc/api/v1/orders" \
  -H "Authorization: 你的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app_id": 123, "num": 10, "prefix": "1440"}'

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "order": {
      "order_id": "202607061234567890",
      "app_name": "Telegram",
      "quantity": 10,
      "unit_price": 0.5,
      "total_amount": 5.0,
      "status": 1,
      "export_token": "202607061234567890",
      "created_at": "2026-07-06T12:00:00+08:00"
    },
    "phones": [
      {
        "tel": "14400001234",
        "token": "abc123def456ghi789jkl012mno345pq",
        "proxy_url": "https://yljm.cc/api/sms?token=abc123def456ghi789jkl012mno345pq",
        "end_time": "2026-08-06T12:00:00+08:00"
      }
    ]
  }
}

保存好每个号码的 token，后续用它调用「查询短信」接口接收验证码。

订单列表

GET/api/v1/orders

查询参数

参数	类型	必填	说明
`page` / `limit`	int	否	分页，默认 1 / 20
`order_id`	string	否	订单号精确查询
`app_name`	string	否	项目名称模糊查询

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "list": [
      {
        "order_id": "202607061234567890",
        "app_name": "Telegram",
        "quantity": 10,
        "unit_price": 0.5,
        "total_amount": 5.0,
        "status": 1,
        "created_at": "2026-07-06 12:00:00"
      }
    ],
    "total": 1
  }
}

号码列表

GET/api/v1/phones

查询已购号码及其短信令牌，支持按订单号、项目名、号码筛选。

查询参数

参数	类型	必填	说明
`page` / `limit`	int	否	分页，默认 1 / 20
`order_id`	string	否	订单号
`app_name`	string	否	项目名称
`tel`	string	否	号码模糊查询

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "list": [
      {
        "order_no": "202607061234567890",
        "app_name": "Telegram",
        "tel": "14400001234",
        "token": "abc123def456ghi789jkl012mno345pq",
        "end_time": "2026-08-06T12:00:00+08:00",
        "created_at": "2026-07-06T12:00:00+08:00"
      }
    ],
    "total": 10
  }
}

查询短信

GET/api/v1/sms

用号码令牌查询该号码收到的最新短信。此接口无需 API Key，令牌本身即凭证，可直接分发给下游使用。

查询参数

参数	类型	必填	说明
`token`	string	是	号码的短信查询令牌（购买时返回）

请求示例

curl "https://a.yljm.cc/api/v1/sms?token=abc123def456ghi789jkl012mno345pq"

响应示例

// 已收到短信
{ "code": 1, "msg": "success", "data": { "msg": "[Telegram] Your code is 88888" } }

// 尚未收到
{ "code": 0, "msg": "暂无短信" }

建议 3～5 秒轮询一次，直到 code=1。该接口限流 30 次 / 10 秒 / IP。