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/countries | service(可选) | 查询国家;后续使用小写 country 国家代码 |
| GET /api/activation/services | country(必填) | 查询某国业务 |
| GET /api/activation/quote | country、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/allocate | country、service、idempotency_key | route;expected_price 为可接受的最高 USD 价格,建议填写 |
| POST /api/activation/poll | order_no | 建议间隔 5 秒,读取 sms 和 sms_code |
| POST /api/activation/cancel | order_no | 取号满 2 分钟、尚未收到短信时申请取消,以返回结果为准 |
| GET /api/activation/again_quote | order_no | 查询已收过短信的号码能否再次购买及价格 |
| POST /api/activation/again | order_no、idempotency_key | expected_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/listing | page、status(可选) | 分页查询接码订单 |
| GET /api/activation/order | order_no 或 idempotency_key | 核对单笔订单,尤其用于请求超时后的确认 |
本站充值订单采用人工核款与实际加款流程。本站订单显示核款通过,不代表控制台已经完成入账;完成后查看订单处理说明及通知。开发者接口返回的余额、充值记录属于对应控制台账号。
号码租赁接口
| 方法与路径 | 参数 | 用途 |
|---|---|---|
| GET /api/rental/offers | 无 | 获取单业务与整号方案、租期、total 及库存 |
| POST /api/rental/order | type、term、idempotency_key;single_service 另填 service | full_number 可填 country;建议填 expected_price |
| GET /api/rental/orders | 无 | 本人租赁订单 |
| GET /api/rental/detail | order_no | 订单与短信详情 |
| POST /api/rental/refund_order | order_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 或余额、订单结果不一致时,保留订单号并联系处理。不要把密钥或完整短信验证码发到公开反馈中。