跳转到正文
国内实名卡验证码接收_国外国际短信临时接码、手机号码租赁与ESIM卡购买 接码巴士平台客服 09:00—22:00 · UTC+8
接码巴士平台SMS BUS HUB

用 API 将接码服务
接入你的应用

查阅鉴权、地区查询、订单和接收结果的接口说明与请求示例。

开始接入

API 凭证与调用权限在服务控制台管理。请使用你账号对应的服务地址,勿将 API 密钥公开到网页源码。

联系客服开通服务 ↗

接入范围与权限

本页介绍国际接码与号码租赁控制台的开发者协议,核对日期:2026-11-20。基础地址:https://codesjiema.com。使用账号所属控制台的密钥,本站登录密码不能代替 API 密钥。国内接码有独立渠道,不能直接套用这里的国际接口。

控制台当前的 API 开通条件为累计已核实实付充值满 100 USDT,赠送额度不计入;网页手动操作不受此 API 条件限制。以账号控制台显示的权限为准。金额单位为 USD,价格、库存和租期以查询结果为准。

每个请求通过 X-API-Key 请求头鉴权。POST 使用 application/x-www-form-urlencoded。请在服务端调用,密钥不要放在网址、网页代码或公开仓库中。

curl -H "X-API-Key: YOUR_DEVELOPER_KEY" "https://codesjiema.com/api/index/user_info"

返回结构包含 code、msg、time、data。code=1 表示成功,code=0 表示业务失败;HTTP 200 本身不代表已取号或已扣款成功。

目录、国家与实时报价

方法与路径参数用途
GET /api/activation/catalog无读取 service 业务标识、名称与参考起价
GET /api/activation/countriesservice(可选)查询国家;后续使用小写 country 国家代码
GET /api/activation/servicescountry(必填)查询某国业务
GET /api/activation/quotecountry、service(必填)查询当前线路 route、USD 价格与数量,不扣费
curl -H "X-API-Key: YOUR_DEVELOPER_KEY" "https://codesjiema.com/api/activation/quote?country=us&service=whatsapp"

routes 为空表示当前没有可买线路。参考起价不等于指定国家、指定线路的成交价。请从最新 quote 返回结果读取 route 和 price。premium=true 的号码只支持一条短信。

取号与收短信

方法与路径必填参数可选参数 / 说明
POST /api/activation/allocatecountry、service、idempotency_keyroute;expected_price 为可接受的最高 USD 价格,建议填写
POST /api/activation/pollorder_no建议间隔 5 秒,读取 sms 和 sms_code
POST /api/activation/cancelorder_no取号满 2 分钟、尚未收到短信时申请取消,以返回结果为准
GET /api/activation/again_quoteorder_no查询已收过短信的号码能否再次购买及价格
POST /api/activation/againorder_no、idempotency_keyexpected_price 建议采用刚查询的价格
curl -H "X-API-Key: YOUR_DEVELOPER_KEY" -X POST "https://codesjiema.com/api/activation/allocate" \
  --data-urlencode "country=us" --data-urlencode "service=whatsapp" \
  --data-urlencode "route=ROUTE_FROM_QUOTE" --data-urlencode "expected_price=PRICE_FROM_QUOTE" \
  --data-urlencode "idempotency_key=YOUR_UNIQUE_REQUEST_KEY"

示例中的 ROUTE_FROM_QUOTE、PRICE_FROM_QUOTE 和 YOUR_UNIQUE_REQUEST_KEY 必须替换。幂等键为 16–64 位字母、数字、下划线或短横线。同一笔请求超时后用原 key 重试;更换 key 会被当作新订单。

active 表示已分配号码;received 表示已收到短信;failed / cancelled 的退款结果应读取 refunded;review 表示需要人工核查。不要因为请求超时就更换 key 再次下单。短信验证码可能为空,必要时读取短信原文 text。

余额与订单核对

方法与路径参数用途
GET /api/index/user_info无读取本人 USD 余额
GET /api/index/recharges无读取本人最近充值记录
GET /api/activation/listingpage、status(可选)分页查询接码订单
GET /api/activation/orderorder_no 或 idempotency_key核对单笔订单,尤其用于请求超时后的确认

本站充值订单采用人工核款与实际加款流程。本站订单显示核款通过,不代表控制台已经完成入账;完成后查看订单处理说明及通知。开发者接口返回的余额、充值记录属于对应控制台账号。

号码租赁接口

方法与路径参数用途
GET /api/rental/offers无获取单业务与整号方案、租期、total 及库存
POST /api/rental/ordertype、term、idempotency_key;single_service 另填 servicefull_number 可填 country;建议填 expected_price
GET /api/rental/orders无本人租赁订单
GET /api/rental/detailorder_no订单与短信详情
POST /api/rental/refund_orderorder_no符合 can_refund 条件时申请退款

type 取 single_service 或 full_number;term 和 country 应原样使用 offers 返回值,不应自行推测。total 是整个租期的 USD 价格,不是单月价。available 或 in_stock 为 false 时不要下单。租赁不自动续费;单业务退款资格读取 can_refund。

国内接码接入

国内接码业务保留,使用独立可用渠道。当前没有对外确认的国内开发者接口协议和统一单价表,因此不提供可直接调用的国内取号示例。请先确认具体项目、号码类型、地区与渠道报价,再使用对应控制台操作;国际开发者密钥不保证可用于国内渠道。

失败与重试

HTTP 401 请核对密钥;403 请核对开通权限;429 根据 Retry-After 等待。409 或价格变化提示应按返回内容处理。只读请求失败可稍后重试;会扣费的请求使用原幂等键核对,不重复创建。

遇到 review 或余额、订单结果不一致时,保留订单号并联系处理。不要把密钥或完整短信验证码发到公开反馈中。

联系 Telegram 客服 返回顶部