在线接码 API

按次取号、即取即用：选应用 → 选国家 → 取号（扣款）→ 轮询取码 → 收到验证码即完成。未收到验证码可随时释放即时退款，号码超时（约 10 分钟）未收码也会自动退款。

会话状态说明

status	含义
`1`	等待接码
`2`	已收到验证码
`3`	已释放（已退款）
`4`	超时（已自动退款）

获取应用列表

GET/api/v1/online/apps

查询参数

参数	类型	必填	说明
`keyword`	string	否	应用名称关键词

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "list": [
      { "id": "1001", "name": "WhatsApp", "icon": "https://a.yljm.cc/uploads/online_icons/1001.png?w=46&h=46" },
      { "id": "1002", "name": "Telegram", "icon": "" }
    ]
  }
}

获取国家报价

GET/api/v1/online/countries

查询指定应用支持的国家、单价、有货状态与近期成功率。

查询参数

参数	类型	必填	说明
`app_id`	string	是	应用 ID（来自应用列表）
`keyword`	string	否	国家名称/区号关键词

请求示例

curl "https://a.yljm.cc/api/v1/online/countries?app_id=1001" \
  -H "Authorization: 你的API_KEY"

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "list": [
      {
        "country_id": "52",
        "title": "美国",
        "iso": "us",
        "dial_code": "+1",
        "price": 0.35,          // 单价（USDT）
        "available": true,      // 是否有货
        "success_rate": 90.2    // 成功率 %，无数据为 null
      }
    ]
  }
}

购买取号

POST/api/v1/online/orders

取号即扣款，单次最多 10 个号码。返回的 session_no 是后续取码 / 释放的凭证。

请求体（JSON）

参数	类型	必填	说明
`app_id`	string	是	应用 ID
`country`	string	是	国家 ID（来自国家报价）
`quantity`	int	否	数量 1～10，默认 1

请求示例

curl -X POST "https://a.yljm.cc/api/v1/online/orders" \
  -H "Authorization: 你的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app_id": "1001", "country": "52", "quantity": 1}'

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "count": 1,
    "list": [
      {
        "session_no": "OS202607061234567890",
        "project_name": "WhatsApp",
        "country_title": "美国",
        "iso": "us",
        "tel": "+14400001234",
        "unit_price": 0.35,
        "status": 1,
        "code": "",
        "sms_content": "",
        "expire_at": "2026-07-06T12:10:00+08:00",
        "created_at": "2026-07-06T12:00:00+08:00"
      }
    ]
  }
}

轮询取码

GET/api/v1/online/orders/{session_no}/code

轮询查询会话状态，status=2 时 code 为验证码、sms_content 为短信原文。建议 3～5 秒轮询一次。

请求示例

curl "https://a.yljm.cc/api/v1/online/orders/OS202607061234567890/code" \
  -H "Authorization: 你的API_KEY"

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "session_no": "OS202607061234567890",
    "tel": "+14400001234",
    "status": 2,
    "code": "882211",
    "sms_content": "WhatsApp code 882211",
    "expire_at": "2026-07-06T12:10:00+08:00"
  }
}

释放退款（取消激活）

POST/api/v1/online/orders/{session_no}/release

未收到验证码时释放号码，费用即时原路退回余额。已收码（status=2）的会话不可释放。

请求示例

curl -X POST "https://a.yljm.cc/api/v1/online/orders/OS202607061234567890/release" \
  -H "Authorization: 你的API_KEY"

响应示例

{
  "code": 1,
  "msg": "success",
  "data": { "session_no": "OS202607061234567890", "status": 3 }
}

接码记录

GET/api/v1/online/orders

查询最近 1 小时内的接码会话记录。

查询参数

参数	类型	必填	说明
`page` / `limit`	int	否	分页，默认 1 / 10
`status`	int	否	按状态筛选 1-4
`tel`	string	否	号码模糊查询

响应示例

{
  "code": 1,
  "msg": "success",
  "data": {
    "list": [
      {
        "session_no": "OS202607061234567890",
        "project_name": "WhatsApp",
        "country_title": "美国",
        "tel": "+14400001234",
        "unit_price": 0.35,
        "status": 2,
        "code": "882211",
        "created_at": "2026-07-06T12:00:00+08:00"
      }
    ],
    "total": 1
  }
}