API

簡訊激活API

從您的腳本購買號碼並讀取驗證碼。API使用常見的簡訊激活格式,因此大多數現有客戶端只需更改基礎地址和密鑰即可使用。

在控制台的API密鑰頁面創建您的API密鑰。密鑰僅顯示一次。

基礎地址與密鑰

使用api_key和action向基礎地址發送GET或POST請求。在控制台的API密鑰頁面創建密鑰;它只會顯示一次。

https://snsactivate.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance

服務代碼是我們服務頁面上的名稱(例如whatsapp、telegram、google)。國家代碼是小寫的ISO代碼(us、gb、in)。限制:每個密鑰每分鐘300次請求。每次激活有20分鐘的窗口,與控制台相同。

getBalance

您的餘額(美元)。

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getBalance
ACCESS_BALANCE:12.50

getServicesList

您可以購買的服務代碼(JSON)。

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getServicesList
{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries

國家代碼(ISO,小寫)和撥號代碼(JSON)。

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getCountries
{"us":{"name":"United States","dial":"1"}}

getPrices

各國與服務的美元價格及庫存數量。兩個篩選條件皆為選填。

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getPrices&service=whatsapp&country=us
{"us":{"whatsapp":{"cost":0.18,"count":130598}}}

getNumber

購買一次激活。返回激活ID和號碼及其國家代碼。

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getNumber&service=whatsapp&country=us
ACCESS_NUMBER:AC-7K2M9QX4PB:13475550182

getStatus

STATUS_WAIT_CODE(尚未收到代碼),STATUS_OK:<code>,STATUS_WAIT_RETRY:<last code>(請求另一個代碼),STATUS_CANCEL(已取消或退款)。

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getStatus&id=AC-7K2M9QX4PB
STATUS_OK:482913

setStatus

status=1 準備就緒(ACCESS_READY),3 請求另一個代碼(ACCESS_RETRY_GET),6 完成(ACCESS_ACTIVATION),8 在未收到代碼時取消並全額退款(ACCESS_CANCEL)。

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3
ACCESS_RETRY_GET

典型流程

  1. 使用服務和國家代碼調用getNumber。保存ID。
  2. 在應用中輸入號碼並請求SMS。
  3. 每5到10秒調用一次getStatus,直到STATUS_OK。
  4. 需要另一個SMS?調用setStatus 3,然後再次調用getStatus。完成:調用setStatus 6。
  5. 沒有收到代碼?調用setStatus 8取消並全額退款。如果不調用,窗口結束時會自動退款。

錯誤

BAD_KEY缺少或錯誤的API密鑰。
BAD_ACTION未知操作。
BAD_SERVICE未知的服務代碼。
BAD_COUNTRY該服務在該國家不銷售。
NO_BALANCE餘額不足。
NO_NUMBERS目前沒有可用的號碼。請稍後再試。
NO_ACTIVATION未知的激活ID,或不是您的。
EARLY_CANCEL_DENIED已經收到代碼,因此無法取消激活。
TOO_MANY_REQUESTS一分鐘內超過300次請求。
NO_ACTIVATIONS已經有20個激活進行中。
SMS激活API:getNumber、getStatus、setStatus