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 使用與網頁相同的信用及價格。

基本地址是什麼?

所有請求均以 GET 方式發送至相同地址,並附加 api_key 和 action。

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接收驗證碼的順序是?

領取號碼、輸入、確認代碼並完成的四個步驟。

  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個步驟

    結束

    輸入驗證碼後,請使用 setStatus 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