GlobalJiema / 開發者 / API 檔案

接碼 API 檔案

用程序批量取號、查詢短信、取消退款、同號再次接碼和租用號碼。接口與網頁使用同一套價格和規則，金額為美元。開發者接口需累計核實實付充值滿 100 USDT 後開通，網頁操作不受限制。

REST · JSONX-API-Key 鑑權美元計價

接入說明

更新日期：2026-11-06。基礎地址 https://globaljiema.com。所有金額為美元（USD），與網頁價格相同；餘額用 USDT 儲值（1 USDT = $1）。

認證：請求頭 X-API-Key: YOUR_DEVELOPER_KEY（在本頁上方生成）。POST 使用 application/x-www-form-urlencoded 表單。不要把密鑰放進網址或前端代碼。

統一返回結構

{
  "code": 1,
  "msg": "獲取成功",
  "time": "1793968000",
  "data": { ... }
}

code=1 成功，code=0 為業務失敗（看 msg）；HTTP 200 不等於成功。HTTP 401 密鑰無效，403 未滿足開發者條件，429 請求過於頻繁。

呼叫順序（即時接碼）

GET /api/activation/catalog 選業務 → GET /api/activation/countries?service= 選國家
GET /api/activation/quote 取實時線路與價格（不扣費）
POST /api/activation/allocate 取號（預扣餘額），帶 idempotency_key
每 5 秒 POST /api/activation/poll，sms 數組不為空即收到短信
未收到短信可 POST /api/activation/cancel 退款；有效期內未收碼會自動退款

冪等

會扣費的接口（allocate、again、rental/order）都要求客戶端生成 16–64 位的 idempotency_key。網絡超時後用同一個 key 重試，會返回原訂單而不會重復扣費；換 key 等於新下單。

帳戶餘額

X-API-Key

GET /api/index/user_info

無需業務引數。

返回 id、username、email、money（美元餘額）、currency、status。

成功響應 data 示例

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

業務列表

X-API-Key（網頁可直接瀏覽）

GET /api/activation/catalog

無需業務引數。

全部可取號業務（全球匯總），service 為後續接口使用的業務標識，price_from 為全球最低售價，countries 為可用國家數。數據每天同步兩次。

成功響應 data 示例

{
  "currency": "USD",
  "rows": [
    { "service": "telegram", "name": "Telegram 電報", "icon": "https://...", "countries": 120, "price_from": "0.10" }
  ]
}

國家列表

X-API-Key（網頁可直接瀏覽）

GET /api/activation/countries

引數	型別	說明
`service`	string	選填。帶上時只返回提供該業務的國家，price_from 為該業務在該國的起價，按價格升序

country 為國家代碼（ISO，小寫），用於其他接口的 country 引數。

成功響應 data 示例

{
  "currency": "USD",
  "service": "telegram",
  "rows": [
    { "country": "id", "name": "印尼", "en": "Indonesia", "prefix": "+62", "services": 98, "price_from": "0.13", "success_rate": 62, "multi_sms": true }
  ]
}

某國業務列表

X-API-Key（網頁可直接瀏覽）

GET /api/activation/services

引數	型別	說明
`country`	string	必填，國家代碼，如 us、gb

該國全部可取號業務及參考起價、近期成功率。

成功響應 data 示例

{
  "currency": "USD",
  "country": "us",
  "synced_at": 1793968000,
  "rows": [
    { "service": "walmart", "name": "Walmart 沃爾瑪", "price_from": "0.30", "success_rate": 42, "multi_sms": true }
  ]
}

實時報價（線路）

X-API-Key · 不扣費

GET /api/activation/quote

引數	型別	說明
`country`	string	必填，國家代碼
`service`	string	必填，業務標識

返回當前可買的線路（運營商），按價格升序。operators 為空表示該國這項業務暫無合格號碼（hidden 為因成功率或庫存不足而隱藏的線路數），請換國家。premium=true 的高級號碼只接收一條短信。

成功響應 data 示例

{
  "currency": "USD",
  "country": "us",
  "service": "walmart",
  "operators": [
    { "operator": "verizon", "price": "0.30", "count": 1200, "success_rate": 62, "multi_sms": true, "premium": false }
  ],
  "hidden": 2,
  "purchase_enabled": true
}

取號

X-API-Key · 預扣餘額

POST /api/activation/allocate

引數	型別	說明
`country`	string	必填，國家代碼
`service`	string	必填，業務標識
`operator`	string	選填，來自 quote 的線路；不填則用當前最便宜的線路
`expected_price`	decimal	選填（建議填寫），你能接受的價格；實時價格高於它時不會下單
`idempotency_key`	string	必填，16–64 位，失敗重試時保持不變

成功時 order.status=active 並返回號碼 phone 與有效期 expires_at。取號失敗（無號碼、價格變化等）會退回餘額，status=failed。status=review 表示平台結果未確認，請保留訂單號聯系客服，不要換 key 重下。餘額不足時 data.need_recharge=true。

成功響應 data 示例

{
  "order": {
    "order_no": "A261106203012ABCDEF0123",
    "country": "us",
    "service": "walmart",
    "operator": "verizon",
    "amount": "0.30",
    "currency": "USD",
    "status": "active",
    "phone": "+15551234567",
    "sms": [],
    "sms_code": "",
    "multi_sms": 1,
    "expires_at": 1793969200,
    "refunded": 0
  },
  "replayed": false
}

查詢短信

X-API-Key

POST /api/activation/poll

引數	型別	說明
`order_no`	string	必填

建議每 5 秒調用一次。sms 數組不為空即已收到短信（每條含 sender、text、code、date），sms_code 為最近一條的驗證碼（可能為空，請讀 text）。普通號碼在有效期內可繼續收到更多短信。狀態：active 等待短信、received 已收到（仍可接收）、finished 已結束、cancelled 已退款、failed 取號失敗已退款、review 待核查。

成功響應 data 示例

{
  "order": {
    "order_no": "A261106203012ABCDEF0123",
    "status": "received",
    "phone": "+15551234567",
    "sms": [ { "sender": "Walmart", "text": "Your code is 847291", "code": "847291", "date": "2026-11-06T12:31:10Z" } ],
    "sms_code": "847291"
  },
  "poll_after_seconds": 5
}

取消並退款

X-API-Key

POST /api/activation/cancel

引數	型別	說明
`order_no`	string	必填

只能取消還沒有收到短信的訂單（status=active），成功後退回餘額，status 變為 cancelled。

成功響應 data 示例

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

同號再次接碼

X-API-Key · 預扣餘額

GET /api/activation/again_quote　→　POST /api/activation/again

引數	型別	說明
`order_no`	string	必填，原訂單號（必須收到過短信）
`expected_price`	decimal	POST 時選填，建議填 again_quote 返回的 price
`idempotency_key`	string	POST 時必填

用之前訂單的同一個號碼再接收一次驗證碼（例如重新登錄用這個號碼注冊的帳號）。先用 again_quote 查詢能否再次購買及價格，再 POST again 下單；新訂單號以 B 開頭，返回格式同 allocate。

成功響應 data 示例

{
  "available": true,
  "phone": "+15551234567",
  "service": "walmart",
  "price": "0.20",
  "currency": "USD"
}

接碼訂單列表

X-API-Key

GET /api/activation/listing　·　GET /api/activation/order

引數	型別	說明
`page`	integer	listing 選填，每頁 20 條
`status`	string	listing 選填，按狀態篩選
`order_no`	string	order 必填，查詢單個訂單

只返回本人訂單，按時間倒序。

成功響應 data 示例

{
  "total": 42,
  "page": 1,
  "rows": [ { "order_no": "A261106...", "status": "finished", "amount": "0.30", "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": "7.79", "per_month": "7.79", "in_stock": true } ] } ] },
  "full_number": [ { "country": "usa", "iso": "us", "name": "美國", "available": true, "prices": { "1m": "19.49", "3m": "50.67" } } ]
}

租用號碼

X-API-Key · 扣餘額

POST /api/rental/order

引數	型別	說明
`type`	string	必填，single_service 或 full_number
`term`	string	必填，1m / 3m / 6m / 1y（以方案中有的為準）
`service`	string	single_service 必填
`country`	string	full_number 選填，預設 usa
`expected_price`	decimal	選填（建議填寫）
`idempotency_key`	string	必填

成功返回號碼 number 與到期時間 ends_at。本站不自動續費。

成功響應 data 示例

{
  "order": { "order_no": "R261106...", "type": "single_service", "service": "whatsapp", "term": "1m", "amount": "7.79", "status": "active", "number": "+13055550100", "ends_at": 1796560000 }
}

租賃訂單與短信

X-API-Key

GET /api/rental/orders　·　GET /api/rental/detail　·　POST /api/rental/refund_order

引數	型別	說明
`order_no`	string	detail / refund_order 必填

orders 返回本人全部租賃訂單；detail 額外返回該號碼收到的全部短信 sms；單業務租用在購買後 7 天內未收到任何短信時（can_refund=true）可調用 refund_order 退款。

成功響應 data 示例

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

國內接碼（中國大陸手機號）

國內接碼與國際接碼共用帳戶餘額，統一售價 $1.00 / 個。呼叫順序：GET /api/cnsms/search 搜索項目 → POST /api/cnsms/allocate 取號（預扣 $1）→ 每 5 秒 POST /api/cnsms/poll 查詢驗證碼 → 不需要時 POST /api/cnsms/release 釋放。號碼取到後 20 分鍾內未收到驗證碼會自動釋放並退款；收到驗證碼後釋放不退款。省份、運營商代碼可用 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（網頁可直接瀏覽）

GET /api/cnsms/search

引數	型別	說明
`keyword`	string	必填，項目關鍵詞，如微信、抖音、淘寶

返回匹配的項目。取號時需原樣帶上 project_id、name、token（token 是項目校驗串，請勿修改）。

成功響應 data 示例

{
  "price": "1.00",
  "currency": "USD",
  "rows": [ { "project_id": "21459", "name": "抖音", "token": "MjE0NTl8…" } ]
}

國內接碼：取號

X-API-Key · 預扣餘額

POST /api/cnsms/allocate

引數	型別	說明
`project_id`	string	必填，來自 search
`project_name`	string	必填，來自 search 的 name
`project_token`	string	必填，來自 search 的 token
`province`	string	選填，省份代碼，如 44；留空不限制
`carrier`	string	選填，CMCC / CUCC / CTCC / CBN / MVNO
`ascription`	string	選填，號碼型別：1=虛擬卡，2=實體卡
`phone`	string	選填，指定歷史獲取過的號碼（指定時數量固定為 1）
`quantity`	integer	選填，1–5，預設 1，每個號碼 $1
`idempotency_key`	string	必填，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_no`	string	必填

建議每 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_no`	string	必填

未收到驗證碼（active）釋放後退回 $1，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"
}

錯誤與重試

只讀接口（GET）失敗可以稍後重試。
會扣費的接口超時或網絡中斷：用同一個 idempotency_key 重試，或用 listing 查找訂單，不要換 key 重下。
msg 含“價格已變”：重新調用 quote 確認價格後再下單。
同一 IP 每分鍾最多約 120 次查詢、30 次下單；超過返回 429。
status=review 的訂單請聯系客服（Telegram）並提供訂單號。

開啟 API 自動化接入

API 密鑰管理

接入說明

統一返回結構

呼叫順序（即時接碼）

冪等

帳戶餘額

成功響應 data 示例

業務列表

成功響應 data 示例

國家列表

成功響應 data 示例

某國業務列表

成功響應 data 示例

實時報價（線路）

成功響應 data 示例

取號

成功響應 data 示例

查詢短信

成功響應 data 示例

取消並退款

成功響應 data 示例

同號再次接碼

成功響應 data 示例

接碼訂單列表

成功響應 data 示例

租賃方案

成功響應 data 示例

租用號碼

成功響應 data 示例

租賃訂單與短信

成功響應 data 示例

國內接碼（中國大陸手機號）

國內接碼：選項

成功響應 data 示例

國內接碼：搜索項目

成功響應 data 示例

國內接碼：取號

成功響應 data 示例

國內接碼：查詢驗證碼

成功響應 data 示例

國內接碼：釋放號碼

成功響應 data 示例

國內接碼：訂單列表

成功響應 data 示例

錯誤與重試