API 接入文档

通过 API Key 调用接码服务:取号,使用号码触发短信,轮询获取验证码

1. 获取国家 + 平台列表

返回可用国家及其号码库存,每个国家下附带开放的平台与面向当前 API Key 的实际价格(已含用户专属价)。

{
  "code": 0, "msg": "success",
  "data": [
    {
      "country": "CD", "name": "刚果金", "available": 1980,
      "platforms": [
        { "platform": "tg", "name": "Telegram", "price": 0.1 },
        { "platform": "ins", "name": "Instagram", "price": 0.2 },
        { "platform": "ws", "name": "WhatsApp", "price": 0.2 }
      ]
    }
  ]
}

2. 获取平台列表(可选)

仅返回全部平台及其默认价格(不含国家/用户维度差异)。

{ "code": 0, "msg": "success",
  "data": [ { "platform": "tg", "name": "Telegram", "price": 0.1 }, { "platform": "fb", "name": "Facebook", "price": 0.3 } ] }

3. 取号

// 不传 country,随机国家取一个 ws 号
GET https://rdwpxs.vip/api/?action=get_number&platform=ws&key=API_KEY

{ "code":0, "msg":"success", "data":{
    "order_no":"202607290012345678",
    "country":"PE",          // ← 实际选中的国家,以返回值为准
    "platform":"ws", "number":"51966364963", "price":0.25,
    "expire_in":300
} }

批量取号示例 &count=5 一次取 5 个:

// GET .../api/?action=get_number&country=CD&platform=tg&count=5&key=API_KEY
{ "code":0, "msg":"success", "data":{
    "country":"CD", "platform":"tg", "price":0.1,
    "requested":5, "count":5,
    "numbers":[
      {"order_no":"2026...001","number":"24390000001"},
      {"order_no":"2026...002","number":"24390000002"}
    ]
}}

{
  "code": 0, "msg": "success",
  "data": {
    "order_no": "202607151203339981",
    "country": "CD",
    "platform": "tg",
    "number": "243906887805",
    "price": 0.1,
    "expire_in": 300,
    "tip": "请在 5 分钟内使用该号码接收验证码;仅收到验证码时扣费 $0.1"
  }
}

取号本身不扣费。只有 get_sms 成功返回验证码时,才从余额扣除该平台价格(美元);超时或 cancel 不产生任何费用。系统保证同一号码不会重复分配到同一平台。

渠道授权:取号需管理员为你的账号开通该国家/渠道,未开通返回 code 1「未开通该国家/渠道权限」,请联系管理员。  并发线程:每个账号有并发上限(管理员可设),超过返回 code 429,请降低客户端并发线程数后重试。

4. 获取验证码(轮询,支持批量)

建议每 3~5 秒轮询一次,直到 status 变为 received。批量查码:order_no 用逗号分隔多个订单号(最多 20),一次查询多单。

// 批量:GET .../api/?action=get_sms&order_no=单号1,单号2,单号3&key=API_KEY
{ "code":0, "msg":"success", "data":{
    "total":3, "received":1,
    "results":[
      {"order_no":"单号1","status":"received","number":"...","code":"123456","charged":0.1},
      {"order_no":"单号2","status":"waiting","number":"...","code":null},
      {"order_no":"单号3","status":"expired","code":null}
    ]
}}

批量模式恒返回 code 0,逐单看 results[].status;单个模式仍兼容旧的 code 0/6/7。取消也支持批量:action=cancel&order_no=单号1,单号2。

// 尚未收到
{ "code": 7, "msg": "暂无验证码,请稍后重试", "data": { "status": "waiting", "number": "243906887805" } }

// 已收到验证码
{
  "code": 0, "msg": "success",
  "data": {
    "order_no": "202607151203339981",
    "status": "received",
    "number": "243906887805",
    "code": "123456",
    "content": "您的验证码是 123456"
  }
}

5. 取消订单

取消等待中的订单并释放号码(取号未计费,无扣款)。

取号后 4 分钟内不可取消:4 分钟内调用会返回 code 1「取号后 4 分钟内不可取消,请先等待验证码」。请等待验证码,或订单满 5 分钟超时后自动作废(超时不计费)。批量取消中未满 4 分钟的单会保持 waiting、其余正常取消。

6. 查询余额(美元)

{ "code": 0, "msg": "success", "data": { "username": "demo", "balance": 9.85, "currency": "USD" } }

balance 为美元可用余额;收到验证码时按平台价格扣减。余额充值请联系管理员。

返回码说明

代码示例(Python)

import requests, time

BASE = "https://rdwpxs.vip/api/"
KEY  = "你的API_KEY"

def call(action, **params):
    params.update(action=action, key=KEY)
    return requests.get(BASE, params=params, timeout=30).json()

# 1) 取号(指定国家 + 平台)
r = call("get_number", country="CD", platform="tg")
print(r)
order_no = r["data"]["order_no"]
number   = r["data"]["number"]
print("请用号码接收验证码:", number)

# 2) 轮询收码(最多 5 分钟)
for _ in range(60):
    time.sleep(5)
    r = call("get_sms", order_no=order_no)
    if r["code"] == 0:
        print("验证码:", r["data"]["code"]); break
    print("等待中...")

代码示例(cURL)

curl "https://rdwpxs.vip/api/?action=get_number&country=CD&platform=tg&key=你的API_KEY"
curl "https://rdwpxs.vip/api/?action=get_sms&order_no=订单号&key=你的API_KEY"

平台代码表

实际价格以 countries 返回的 platforms.price 为准(含国家差价与您的专属价)。用户可在控制台自建专属渠道并上传号码,仅本人 Key 可调用。

当前可用国家代码

© 2026 接码 API 分配平台