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
典型流程
- 使用服務和國家代碼調用getNumber。保存ID。
- 在應用中輸入號碼並請求SMS。
- 每5到10秒調用一次getStatus,直到STATUS_OK。
- 需要另一個SMS?調用setStatus 3,然後再次調用getStatus。完成:調用setStatus 6。
- 沒有收到代碼?調用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個激活進行中。 |