开发者资源

CodesJiema 接码 API 开发者文档

CodesJiema 开发者 API:用程序批量取号、查询短信、取消退款、同号再次接码和租用号码。接口与网页使用同一套价格和规则,金额为美元(USD)。累计已核实实付充值满 100 USDT 即可开通,网页手动操作不受影响。

开发者中心

API 密钥 读取中

累计已核实实付充值满 100 USDT 即可开通 API。开通后用 X-API-Key 请求头调用接口,价格与网页一致。

0/ 100 USDT
已核实实付充值

正在读取开通进度…

去充值 →
接码通道 充值 我的 文档/QA

接入说明

更新日期:2026-11-07。基础地址 https://codesjiema.com。所有金额为美元(USD),与网页价格完全一致;余额用 USDT-TRC20 充值(1 USDT = $1)。

开通条件:累计已核实实付充值满 100 USDT,在本页上方生成密钥。认证:每个请求带请求头 X-API-Key: YOUR_DEVELOPER_KEY。POST 使用 application/x-www-form-urlencoded 表单。

统一返回结构

{
  "code": 1,
  "msg": "获取成功",
  "time": "1794032000",
  "data": { ... }
}

code=1 为成功,code=0 为业务失败(原因见 msg)。HTTP 200 不代表成功,请以 code 为准。HTTP 401:密钥无效;403:未满足开通条件;429:请求过于频繁。

即时接码调用顺序

  1. GET /api/activation/catalog 选业务 → GET /api/activation/countries?service= 选国家
  2. GET /api/activation/quote 查看实时线路与价格(不扣费),记下线路编号 route
  3. POST /api/activation/allocate 取号(预扣余额),必须带 idempotency_key
  4. 每 5 秒 POST /api/activation/poll,sms 不为空即收到短信
  5. 不想等了可 POST /api/activation/cancel 退款;有效期内未收到短信会自动退款

幂等(防重复扣费)

会扣费的接口(allocate、again、rental/order)都要求客户端生成 16–64 位的 idempotency_key(字母、数字、下划线、短横线)。网络超时后用同一个 key 重试会返回原订单,不会重复扣费;换 key 等于重新下单。

快速示例

# 查询美国 WhatsApp 的实时线路
curl -H "X-API-Key: $KEY" "https://codesjiema.com/api/activation/quote?country=us&service=whatsapp"

# 取号(route 来自上一步)
curl -H "X-API-Key: $KEY" -X POST https://codesjiema.com/api/activation/allocate \
  -d country=us -d service=whatsapp -d route=R3F9A0C21B7 \
  -d expected_price=3.12 -d idempotency_key=$(uuidgen | tr -d -)

# 查询短信
curl -H "X-API-Key: $KEY" -X POST https://codesjiema.com/api/activation/poll -d order_no=A2611071830...

账户余额

X-API-Key

GET /api/index/user_info

无需业务参数。

返回 id、username、email、money(美元余额)、status。

成功响应 data 示例

{
  "id": 123,
  "username": "you@example.com",
  "money": "25.40",
  "status": "normal"
}

充值记录

X-API-Key

GET /api/index/recharges

无需业务参数。

本人最近 50 笔充值单。credit 为实际入账(本金 + 赠送);status:pending 待付款、paid 已到账、expired 超时未付款。

成功响应 data 示例

{
  "currency": "USD",
  "rows": [ { "order_no": "P2611071830...", "amount": "100.00", "bonus": "40.00", "first_bonus": "0.00", "credit": "140.00", "network": "trc20", "status": "paid", "txid": "…", "created_at": 1794032000, "paid_at": 1794032300 } ]
}

业务列表

X-API-Key(网页可直接浏览)

GET /api/activation/catalog

无需业务参数。

全部可取号业务。service 为后续接口使用的业务标识;price_from 为全部国家中的最低参考价,countries 为可买国家数。目录每天更新两次。

成功响应 data 示例

{
  "currency": "USD",
  "rows": [
    { "service": "telegram", "name": "Telegram 电报", "countries": 4, "price_from": "1.40", "hot": 0 }
  ]
}

国家列表

X-API-Key(网页可直接浏览)

GET /api/activation/countries
参数类型说明
servicestring选填。带上时只返回提供该业务的国家,price_from 为该业务在该国的参考起价,按价格升序

country 为小写 ISO 国家代码(如 us、gb),用于其他接口的 country 参数。

成功响应 data 示例

{
  "currency": "USD",
  "service": "whatsapp",
  "rows": [
    { "country": "ca", "name": "加拿大", "en": "Canada", "prefix": "+1", "services": 98, "price_from": "2.40", "success_rate": 92, "multi_sms": true }
  ]
}

某国业务列表

X-API-Key(网页可直接浏览)

GET /api/activation/services
参数类型说明
countrystring必填,国家代码,如 us、gb

该国全部可取号业务及参考起价、近期成功率。

成功响应 data 示例

{
  "currency": "USD",
  "country": "us",
  "synced_at": 1794032000,
  "rows": [
    { "service": "whatsapp", "name": "WhatsApp", "price_from": "3.12", "success_rate": 88, "multi_sms": true }
  ]
}

实时报价(线路)

X-API-Key · 不扣费

GET /api/activation/quote
参数类型说明
countrystring必填,国家代码
servicestring必填,业务标识

返回当前可买的线路,按价格升序。route 是本站线路编号,取号时传入即可锁定该线路。routes 为空表示该国这项业务暂无合格号码(hidden 为因成功率或库存不足被隐藏的线路数),请换国家。premium=true 的高级号码只接收一条短信。

成功响应 data 示例

{
  "currency": "USD",
  "country": "us",
  "service": "whatsapp",
  "routes": [
    { "route": "R3F9A0C21B7", "price": "3.12", "count": 1200, "success_rate": 88, "multi_sms": true, "premium": false }
  ],
  "hidden": 2,
  "purchase_enabled": true
}

取号

X-API-Key · 预扣余额

POST /api/activation/allocate
参数类型说明
countrystring必填,国家代码
servicestring必填,业务标识
routestring选填,来自 quote 的线路编号;不填则使用当前最便宜的线路
expected_pricedecimal选填(建议填写),可接受的最高价格;实时价格更高时不会下单
idempotency_keystring必填,16–64 位,重试时保持不变

成功时 order.status=active,返回号码 phone 和有效期 expires_at。取号失败(暂无号码、价格变化等)会退回余额,status=failed。status=review 表示结果待人工核查,请保留订单号联系客服,不要换 key 重新下单。余额不足时返回 data.need_recharge=true。

成功响应 data 示例

{
  "order": {
    "order_no": "A2611071830124F1C2B9A0D",
    "kind": "new",
    "country": "us",
    "service": "whatsapp",
    "route": "R3F9A0C21B7",
    "amount": "3.12",
    "currency": "USD",
    "status": "active",
    "phone": "+15551234567",
    "sms": [],
    "sms_code": "",
    "multi_sms": 1,
    "expires_at": 1794033200,
    "refunded": 0
  },
  "replayed": false
}

查询短信

X-API-Key

POST /api/activation/poll
参数类型说明
order_nostring必填

建议每 5 秒调用一次。sms 不为空即已收到短信(每条含 sender、text、code、date);sms_code 为最近一条的验证码(可能为空,请读 text)。普通号码在有效期内可以继续收到更多短信。

status含义
buying取号处理中
active已分配号码,等待短信
received已收到短信(有效期内仍可接收)
finished已结束
cancelled已取消或超时未收码,已退款
failed取号失败,已退款
review结果待人工核查

成功响应 data 示例

{
  "order": {
    "order_no": "A2611071830124F1C2B9A0D",
    "status": "received",
    "phone": "+15551234567",
    "sms": [ { "sender": "WhatsApp", "text": "Your WhatsApp code: 847-291", "code": "847291", "date": "2026-11-07T10:31:10Z" } ],
    "sms_code": "847291"
  },
  "poll_after_seconds": 5
}

取消并退款

X-API-Key

POST /api/activation/cancel
参数类型说明
order_nostring必填

成功取号满 2 分钟且还没有收到短信(status=active)才可手动撤销。提前操作返回 409,data.retry_after_seconds 是剩余秒数。订单的 cancel_available_at 是最早可撤销的 Unix 时间戳。撤销确认后余额退回,status 变为 cancelled。

成功响应 data 示例

{
  "order": { "order_no": "A2611071830124F1C2B9A0D", "status": "cancelled", "refunded": 1 }
}

同号再次接码

X-API-Key · 预扣余额

GET /api/activation/again_quote → POST /api/activation/again
参数类型说明
order_nostring必填,原订单号(必须收到过短信)
expected_pricedecimalPOST 时选填,建议填 again_quote 返回的 price
idempotency_keystringPOST 时必填

用之前订单的同一个号码再接收一次验证码。先用 again_quote 查询能否再次购买及价格,再 POST again 下单;新订单号以 B 开头,返回格式同 allocate。

成功响应 data 示例

{
  "available": true,
  "phone": "+15551234567",
  "service": "whatsapp",
  "price": "2.40",
  "currency": "USD"
}

接码订单列表

X-API-Key

GET /api/activation/listing · GET /api/activation/order
参数类型说明
pageintegerlisting 选填,每页 20 条
statusstringlisting 选填,按状态筛选
order_nostringorder 查询单个订单时填此项或 idempotency_key

只返回本人订单,按时间倒序。如果取号请求超时且未收到响应,用原 idempotency_key 调用 GET /api/activation/order 核对订单,避免重复下单。确认未分配号码的取号超时订单会自动退回预扣余额,status=failed 且 refunded=1。

成功响应 data 示例

{
  "total": 42,
  "page": 1,
  "rows": [ { "order_no": "A261107…", "status": "finished", "amount": "3.12", "phone": "+1555…", "sms_code": "847291" } ]
}

租赁方案

X-API-Key(网页可直接浏览)

GET /api/rental/offers

无需业务参数。

single_service:单业务租用(美国号码,只接收所选业务的短信);full_number:整号租用(接收所有业务短信)。价格为整个租期的美元售价;available / in_stock 为 false 时暂无号码。

成功响应 data 示例

{
  "currency": "USD",
  "can_rent": true,
  "single_service": { "available": true, "country": "usa", "services": [ { "service": "whatsapp", "name": "WhatsApp", "in_stock": true, "terms": [ { "term": "1m", "months": 1, "total": "23.96", "per_month": "23.96", "in_stock": true } ] } ] },
  "full_number": [ { "country": "usa", "iso": "us", "name": "美国", "available": true, "prices": { "1m": "59.96", "3m": "155.88", "6m": "263.76", "1y": "431.52" } } ]
}

租用号码

X-API-Key · 扣余额

POST /api/rental/order
参数类型说明
typestring必填,single_service 或 full_number
termstring必填,1m / 3m / 6m / 1y(以方案中提供的为准)
servicestringsingle_service 必填
countrystringfull_number 选填,默认 usa
expected_pricedecimal选填(建议填写)
idempotency_keystring必填

成功返回号码 number 和到期时间 ends_at。本站不自动续费。

成功响应 data 示例

{
  "order": { "order_no": "R261107…", "type": "single_service", "service": "whatsapp", "term": "1m", "amount": "23.96", "status": "active", "number": "+13055550100", "ends_at": 1796624000 },
  "replayed": false
}

租赁订单与短信

X-API-Key

GET /api/rental/orders · GET /api/rental/detail · POST /api/rental/refund_order
参数类型说明
order_nostringdetail / refund_order 必填

orders 返回本人全部租赁订单;detail 额外返回该号码收到的全部短信 sms;单业务租用在购买后 7 天内一条短信都没收到时(can_refund=true)可调用 refund_order 退款到余额。

成功响应 data 示例

{
  "order": { "order_no": "R261107…", "status": "active", "sms_count": 1, "can_refund": false },
  "sms": [ { "sender": "WhatsApp", "text": "Your WhatsApp code: 123-456", "code": "123456", "date": "2026-11-07T12:31:10Z" } ]
}

国内接码(中国大陆手机号)

国内接码与国际接码共用账户余额,售价按项目不同(以搜索结果的 price 为准)。调用顺序:GET /api/cnsms/search 搜索项目 → POST /api/cnsms/allocate 取号(预扣该项目单价)→ 每 5 秒 POST /api/cnsms/poll 查询验证码 → 不需要时 POST /api/cnsms/release 释放。号码有效期内未收到验证码会自动释放并退款;收到验证码后释放不退款。省份、运营商代码可用 GET /api/cnsms/options 获取。

国内接码:选项

X-API-Key(网页可直接浏览)

GET /api/cnsms/options

无需业务参数。

返回单价、等待时长(秒)、省份代码 provinces、运营商代码 carriers 和单次最大数量。

成功响应 data 示例

{
  "price": "1.00",
  "currency": "USD",
  "ttl": 1200,
  "provinces": { "11": "北京", "31": "上海", "44": "广东" },
  "carriers": { "CMCC": "中国移动", "CUCC": "中国联通", "CTCC": "中国电信", "CBN": "中国广电", "MVNO": "虚拟运营商" },
  "max_quantity": 5
}

国内接码:取号

X-API-Key · 预扣余额

POST /api/cnsms/allocate
参数类型说明
project_idstring必填,来自 search
project_namestring必填,来自 search 的 name
project_tokenstring必填,来自 search 的 token
provincestring选填,省份代码,如 44;留空不限制
carrierstring选填,CMCC / CUCC / CTCC / CBN / MVNO
ascriptionstring可选。卡号类型:2 实卡,1 虚拟卡;不传或 0 为全部
paragraphstring可选。号段筛选,手机号前 3 位,如 138;与 phone 同时传时以 phone 为准
phonestring选填,指定历史获取过的号码(指定时数量固定为 1)
quantityinteger选填,1–5,默认 1,每个号码 $1
idempotency_keystring必填,16–64 位,重试时保持不变

每个号码一个订单(订单号以 C 开头)。成功取到的号码 status=active;未取到的会立即退款(status=failed)。message 不为空表示部分号码未取到。余额不足时返回 data.need_recharge=true。

成功响应 data 示例

{
  "orders": [
    { "order_no": "C2611080012…", "project_name": "抖音", "phone": "13800138000", "province": "广东", "carrier": "中国移动", "amount": "1.00", "status": "active", "sms_code": "", "sms_content": "", "refunded": 0, "expires_at": 1794068400, "currency": "USD" }
  ],
  "replayed": false,
  "message": null
}

国内接码:查询验证码

X-API-Key

POST /api/cnsms/poll
参数类型说明
order_nostring必填

建议每 5 秒调用一次。收到后 status=received,验证码在 sms_code,短信原文在 sms_content。状态:active 等待验证码、received 已收到、finished 已完成、released 已释放并退款、expired 超时已退款、failed 失败已退款、review 待人工核查。

成功响应 data 示例

{
  "order": { "order_no": "C2611080012…", "phone": "13800138000", "status": "received", "sms_code": "482913", "sms_content": "【抖音】验证码 482913,用于手机号登录…" },
  "poll_after_seconds": 5
}

国内接码:释放号码

X-API-Key

POST /api/cnsms/release
参数类型说明
order_nostring必填

成功取号满 2 分钟后可手动释放,提前操作返回 409。未收到验证码(active)释放后退回实际预扣金额,status=released;已收到验证码(received)释放后 status=finished,不退款。

成功响应 data 示例

{
  "order": { "order_no": "C2611080012…", "status": "released", "refunded": 1 }
}

国内接码:订单列表

X-API-Key

GET /api/cnsms/listing

无需业务参数。

返回本人最近 50 个国内接码订单,按时间倒序。

成功响应 data 示例

{
  "rows": [ { "order_no": "C2611080012…", "phone": "13800138000", "status": "finished", "sms_code": "482913" } ],
  "price": "1.00",
  "currency": "USD"
}

错误与重试