SMS 驗證 API

SNSSIM API透過單一HTTP請求處理號碼購買、驗證碼確認、取消、信用額及價格查詢。採用業界標準handler_api方式,只需更改現有程序的地址及API密鑰即可立即連接。

GET /stubs/handler_api.php
  ?api_key=API_KEY&action=getNumber
  &service=telegram&country=gb

ACCESS_NUMBER:SS8Q2K7:447700900123

GET ...&action=getStatus&id=SS8Q2K7
STATUS_OK:48215
行業標準方式
handler_api

行業標準方式

每個API密鑰
每分鐘300次

每個API密鑰

國家 / 服務
145 / 1,255

國家 / 服務

如果沒有代碼,自動退款
20 分鐘

如果沒有代碼,自動退款

如何獲取API密鑰?

登入後在帳戶頁面的API選單中生成金鑰。金鑰僅顯示一次,請立即保存。API使用與網頁相同的餘額及價格。

基本地址是什麼?

所有請求需在相同網址添加api_key及action,以GET方式發送。

https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=...

可以發送哪些請求?

從號碼購買到驗證碼確認、取消、查詢餘額,共支持7種請求。

action負責事項回應範例
getBalance查看餘額ACCESS_BALANCE:12.50
getPrices&service=telegram&country=gb各服務及國家價格與剩餘號碼{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gb購買號碼ACCESS_NUMBER:ID:PHONE
getStatus&id=ID查詢驗證碼STATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8取消使用號碼(未收到驗證碼全額退款)ACCESS_CANCEL
setStatus&id=ID&status=3用同一號碼接收額外驗證碼ACCESS_RETRY_GET
setStatus&id=ID&status=6結束使用ACCESS_ACTIVATION

請求項目

名稱必填說明
api_key全部在帳戶畫面建立的 API 金鑰
action全部getBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumber服務名稱代碼(例如:telegram, whatsapp, google)。與服務列表頁面的值相同
countrygetNumber國家代碼2位 (例如: gb, us, id)
idgetStatus, setStatusgetNumber發出的號碼ID(以N開頭)
statussetStatus8取消,3重新請求驗證碼,6結束,1準備

回應文字及意思

回覆將以簡潔文字顯示,並會同時顯示餘額扣除情況。

回應意思金錢
ACCESS_NUMBER:ID:PHONE已取得號碼會扣除號碼費用
STATUS_WAIT_CODE正在等待驗證碼不變
STATUS_OK:CODE已收到驗證碼付款完成
STATUS_WAIT_RETRY:CODE正在等待額外驗證代碼(包括之前的代碼)不另收費
STATUS_CANCEL已取消或時間已結束如未收到驗證碼即已退款
ACCESS_CANCEL已取消全數退款
ACCESS_RETRY_GET正在等待用同一號碼再次接收驗證碼不另收費
ACCESS_ACTIVATION已完成號碼使用不變
NO_BALANCE增值後即可接收不扣款
NO_NUMBERS目前無法提供該國家的號碼不扣款
NO_ACTIVATIONS使用中號碼已達 20 個不扣款
EARLY_CANCEL_DENIED已接收驗證代碼的號碼請選擇結束(6)而非取消不變
BAD_KEYAPI 金鑰不正確不扣款
BAD_SERVICE / BAD_COUNTRY服務或國家代碼不正確不扣款
NO_ACTIVATION找不到號碼 ID不變
TOO_MANY_REQUESTS已超過每分鐘 300 次不扣款

通過API接收驗證碼的流程是?

共4個步驟:獲取號碼、輸入號碼、確認驗證碼及完成驗證。

  1. 1 步驟

    取得號碼

    通過getNumber選擇所需服務和國家,獲取號碼。

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2 步驟

    輸入號碼

    將購買的號碼輸入到註冊頁面或程式中。

    +44 7700 900123
  3. 3 步驟

    查詢驗證碼

    每5秒調用getStatus檢查驗證碼是否到達。

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 步驟

    結束

    輸入驗證碼後請設定狀態為6完成操作。20分鐘內未收到驗證碼將自動退款。

    action=setStatus&id=SS8Q2K7&status=6
    > ACCESS_ACTIVATION

各語言範例

這是獲取號碼、等待驗證碼並完成驗證的完整流程。點擊切換語言。

import time, requests

BASE = "https://snssim.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

API常見問題

API提供145個國家1,255項服務的號碼,價格與網頁相同。

甚麼是SMS驗證API?
通過HTTP請求實現虛擬號碼購買、驗證碼確認及取消功能。SNSSIM API採用行業標準handler_api方式。
可以繼續使用其他SMS驗證網站的程式嗎?
如果使用handler_api方式的程序,只需更改基本地址和API密鑰即可立即連接。
API有額外費用嗎?
無差異。API和網頁界面使用相同的信用和價格。
最多可以發送多少次請求?
每個API密鑰每分鐘最多可請求300次。超出時會出現TOO_MANY_REQUESTS錯誤,信用額不會扣除。
通過API購買的號碼可以退款嗎?
是的。如果20分鐘內未收到驗證碼,透過API購買的號碼也會自動退還至賬戶餘額。
API密鑰在哪裡建立?
登入後在帳戶頁面的API選單中生成。金鑰僅在生成時顯示一次,請立即保存。

生成API密鑰後立即連接

註冊後充值信用,即可在帳戶頁面生成API密鑰。

SMS 驗證 API | SNSSIM