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キーごとに
1分あたり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_REQUESTS1分あたり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ステップ

    終了

    コード入力後、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とWeb画面は同じクレジットと価格を使用します。
リクエストは何回まで可能ですか?
APIキー毎に分間最大300回リクエスト可能。超過時はTOO_MANY_REQUESTSエラーが発生しクレジットは差し引かれません
APIで購入した番号も返金されますか?
はい。20分以内にコードが到着しない場合、APIで購入した番号もクレジットで自動返金されます。
APIキーはどこで作成しますか?
ログイン後、アカウント画面のAPIメニューで作成してください。キーは作成時一度だけ表示されるので即座に保存してください。

APIキー生成後すぐに接続してみてください

登録後クレジットをチャージすると、アカウント画面で直接APIキーを生成できます。

SMS認証API | SNSSIM