本站累计已核实实付充值满 1000 USDT（含）可使用开发者 API；赠送余额、商品订单付款不计入。网页手动操作不受此限制。 业务接口通过请求头 X-API-Key: YOUR_DEVELOPER_KEY 认证。登录 Token 仅用于网页账户及密钥管理，开发者业务接口统一使用独立密钥。请勿将密钥放进网址。 历史充值未计入时，请联系客服核对原充值单与链上付款凭据。两站独立统计。 账户查询、号码租赁与 eSIM 订单的接口说明与接入边界。 CodesJiema API 接入说明 核对日期：2026-10-21。本站基础地址： https://codesjiema.com 。以下按当前部署代码整理，公开只读接口已检查；不代表已执行真实登录、付费或交付测试。账号、token、余额与订单不得跨站混用。 POST 请求使用 application/x-www-form-urlencoded ，不是 JSON 请求体。开发者业务接口统一携带 X-API-Key: YOUR_DEVELOPER_KEY ，不支持 Bearer 方式。登录 Token 不再授权开发者业务请求；不要把凭证放进网址。HTTP 403 时先核对密钥及累计已核实实付充值 1000 USDT 的条件，不要无限重试。 code=1 成功， code=0 为业务失败；HTTP 200 不等于业务成功。 time 为请求时间的 Unix 秒时间戳，可能以字符串返回。示例为结构示意，不是真实用户或已创建订单；data 以各接口为准。 示例中的凭证必须替换为本人授权账号；不要将真实密码写进公共脚本、浏览器前端或共享命令历史。建议在受控服务端从密钥环境变量读取。 成功后从 data.userinfo.token 读取凭证；保存到服务端。两站提示文案不同，不要依赖 msg 判断成功。 网页登录 Token / 开发者 X-API-Key 无需业务参数；开发者调用须携带 X-API-Key，网页账户调用使用登录 Token。 data 包含 id、name、username、nickname、avatar、email、money、status。money 为账户余额，不是某个订单的报价。 data 为 id、name 对象数组。该列表来自当前内置选项，不代表实时可用号码或库存；部分内置 ID 存在重复，不可作为全球唯一地区编码。 data 为 id、guojia_id、name、price 数组。此接口是内置参考列表，不是实时国家报价接口；价格不能作为最终扣费依据，也不能承诺项目可用。 无需业务参数；开发者调用须携带 X-API-Key。 返回状态正常且 stock > 0 的方案，data.rows 中主要字段：id、country、country_code、flag、price_1、price_3、price_6、price_12、stock。价格对应整段租赁周期；库存与报价可能变化，下单以服务端为准。 校验方案状态、库存、周期价格和余额后扣款并减少库存。成功返回 order_no、amount；初始订单状态 paid，不等于号码已开通。该接口未实现客户端幂等键，请勿自动重发。 无需业务参数；开发者调用须携带 X-API-Key。 返回当前用户全部租赁订单 data.rows，按 id 倒序，无分页参数。主要字段：order_no、plan_id、country、country_code、months、amount、status、starttime、endtime。查询会把已过期的 active 订单更新为 expired；并非完全无副作用的读取。paid 表示已扣款待处理；active 表示已激活；expired 表示已过期。 按服务端商品价格 × 数量扣余额并减少库存，初始状态 paid。成功仅返回 order_no，不直接返回二维码或激活码。商品 ID 请从 /api/catalog/products 或 /api/catalog/product 获取，不要使用租赁 plan_id。重复请求可能重复扣款。 data.total 为总条数，data.rows 为当前用户订单数组。主要字段：order_no、product_id、product_title、unit_price、quantity、total_amount、status，另含关联 product。具体交付内容以订单实际返回与客服处理为准。 无需业务参数；受保护接口仍须携带 token。 注销当前登录凭证。后续请求需要重新登录；不要把退出登录作为接口连通性测试。 2026-10-20 已部署；以下均为公开 GET 接口，沿用 code / msg / time / data 返回结构。

capabilities 返回现有功能开关，sms 内 false 表示供应商未接入。products 与页面使用相同正常上架商品和筛选规则；country 精确匹配，category 模糊匹配分类，q 模糊匹配标题、国家、摘要。筛选均可省略。page 默认 1，最大 10000；limit 默认 12，范围 1–50。country/category 最长 80 字符，q 最长 100 字符。 products 的 data 包含 currency=CNY、page、limit、total、rows。商品字段：id、title、slug、country、flag、categories、cover、summary、price、stock、delivery_type。包含零库存商品，与页面一致；下单前再核对库存。详情必须且只能提供 id 或 slug，data.product 另含 description（HTML 商品介绍，客户端渲染前须净化）；不存在或隐藏商品返回 HTTP 404 / code 404。商品价格为参考，实际订单由服务端计算。 全部需要 X-API-Key 请求头。type 必填且仅 rental / esim；page 默认 1，范围 1–9999；limit 默认 20，范围 1–50。status 选填：租赁 paid/active/expired/cancelled；eSIM paid/delivering/completed/cancelled。listing 的 data 返回 currency、page、limit、total、rows，不包含 eSIM 交付内容。 detail 的 order_no 必填，1–48 位字母、数字、下划线或短横线。data 返回 currency=CNY 与 order 对象，只能查询凭证所属用户的订单；不存在和他人订单统一 HTTP 404 / code 404。租赁 order 包含 order_no、plan_id、country、country_code、months、amount、phone_number、status、starttime、endtime、createtime、updatetime；eSIM order 包含 order_no、product_id、product_title、unit_price、quantity、total_amount、status、delivery_data、createtime、updatetime。 号码未分配时 phone_number 为空；eSIM 尚未交付时 delivery_data 可能为空。交付内容为后台保存的文本，不保证固定 JSON、二维码或激活码格式，请勿作为 HTML 直接执行。响应 no-store，不应缓存或公开交付内容。新查询不会修改余额、库存、订单或到期状态；status 为存储值，租赁使用前应同时核对 endtime。旧 rental/orders 会更新到期状态，新接口不这样处理。 新增接口仅支持 GET，其他方法返回 HTTP 405 / code 405。参数错误返回 HTTP 200 / code 0；未登录返回 401。成功时 code=1。未经真实用户登录、扣费与交付端到端测试，不承诺未集成的供应商能力。 基础地址为本站域名；沿用统一 JSON 返回及 X-API-Key 请求头鉴权。供应商密钥只保存在服务器私有配置，不交给客户端。国家、服务、价格为 GET 查询；全部开发者业务请求都需要已开通的开发者密钥。读写请求按 IP 分别设置每分钟约 120 次的防护，超过返回 HTTP 429。验证码订单查询与操作返回 no-store。 1. 获取真实国家、服务和价格库存 countries 的 data.rows 为 {id,name,iso2}，applications 为 {id,name}。目录、价格、参考库存均读取数据库，不在用户请求中实时调用上游；prices 必须传 country_id，国内 ID=3 不使用本国际接口。data 包含 source=database、synced_at（最近同步的 Unix 秒）、currency=CNY、source_currency=USD、usd_cny=6.00、cache_seconds=0、rows。每行包含 country_id、application_id、cost_usd、price、currency、stock、synced_at。stock 为最近同步的库存参考，非取号保证。价格计算规则不变，独立服务器同步命令生成新批次，完整成功后才切换；失败保留上一批数据。没有在本次新增自动定时同步任务。 2. 获取本站签名报价（不扣费） 两个 ID 均必填，使用上方目录。data 包含 quote_id、expires_at、amount、currency、usd_cny、purchase_enabled。报价绑定当前用户，有效期 120 秒。purchase_enabled=false 时不开放取号；报价本身不会创建订单或扣款。 3. 按报价取号（会预扣余额） 表单提交。quote_id 必填；idempotency_key 为每个新订单唯一的 16–64 位字母、数字、下划线或短横线。网络重试必须原样复用同一 quote_id 和幂等键，不得换键。相同用户相同键返回原订单（即使报价随后过期），replayed=true；同一键改报价会拒绝。 本站先按签名金额预扣并记录余额流水，再以美元最高价限制请求上游；客户端不能改价。返回 data.order 与 replayed。明确取号失败将退回本站余额，订单 failed/refunded=1；超时或异常不自动再次取号、不自动退款，而保留 review 待人工核查。code=1 表示请求已处理，不代表取号成功，必须检查 order.status 和 number。code=0 且 data.allocation_not_started=true 表示确定尚未取号，可重新报价；其他不确定结果先查询订单。一次新取号须重新报价并生成新幂等键。 order、poll、cancel 均返回 data.order；listing 返回 total、page、rows，每页固定 20 条，page 为 1–9999。仅可查当前用户订单，其他用户与不存在订单统一 404。order/listing 只读；poll 会向上游查询并更新收码状态，最短间隔 5 秒，重复查询使用缓存状态。后台未执行定时轮询，请在活跃页面或自有后端按限制轮询；关闭页面不代表取消订单。 order 字段：order_no、country_id、application_id、amount（CNY 字符串）、status、number、sms_code、refunded、created_at、updated_at。不会返回供应商 request_id、密钥或内部幂等数据。上游仅提供验证码时不伪造短信原文。 cancel 仅对 active 尝试取消：先确认没有收到验证码，再向上游提交 reject；仅上游确认取消成功才将预扣金额退回本站余额，状态 cancelled、refunded=1。重复取消不会重复退款。收到码后不可取消退款。上游拒绝取消时可能仍为 active；结果不确定时进入 review，不可据此再次退款。接口成功返回不代表取消成功，仍需检查状态。 buying：本站已预扣，取号处理中；active：已有号码，等待验证码；received：已收到码；failed：明确取号失败并退款；cancelled：确认取消并退款；cancelling：取消请求处理中；review：供应商响应或本地处理异常，需人工核对。长时间 buying / cancelling 也需人工核对；不能仅凭超时判定失败。服务未配置或上游故障返回 code=0；错误参数 code=0，未登录 401，订单不存在 404，方法错误 405，处理中并发操作可能返回 409。 与 eSIM、长期租赁是独立订单类型；不要将这三类订单号混用。本次只读验证与隔离测试未进行真实付费取号、收码或退款端到端测试。 核实累计实付充值满 1000 USDT → 在 API 文档页生成密钥 → 查询国家与服务 → 查询价格库存 → 获取 quote_id → 提交 allocate 并保存 order_no → 每隔至少 5 秒 poll → 收到码后停止。需要放弃时调用 cancel 并核对最终状态。请使用本站独立开发者密钥，并通过 X-API-Key 请求头发送。 国内页面恢复原省份、业务项目和价格，使用 GET /api/code/get_guojia?type=1 与 GET /api/code/get_option?guojia_id=3。不得将省份 ID 或旧项目 ID 直接当作国际国家 / 服务 ID。原版国内没有连接真实自动取号通道，本次不新增国内扣款或接入国际线路。新 quote/allocate 不接受国内国家 ID=3；已有订单仍可按原订单号查询、收码和申请取消。 本次核对未确认统一的“2 秒”限流契约；旧文案中的清空余额处罚不作为本页接口行为承诺。建议只读查询使用低频、退避重试，这是客户端建议而非服务端配额；扣费接口没有客户端幂等键，不支持安全地自动重试。金额按服务端返回核对，不由客户端自行改价。 注意：这条“无幂等键”说明仅适用于旧租赁和 eSIM 下单接口；即时接码 activation/allocate 必须使用下述幂等键。 即时取号、收码、取消已接入下述 activation 接口。不要使用旧 /api/get_mobile、/api/get_myinfo 或将路径改为 /api2/。供应商国家 / 服务 ID 与旧参考列表 ID 不可混用。 主动发送短信、拉黑号码、自动续租、自动 eSIM 交付、回调通知尚未接入。现有长期租赁与 eSIM 的 paid 仅表示本站已扣款，不代表供应商已开通；保持现有后台交付流程。 首页实时接码 · 即时接码订单记录 · 帮助中心