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回
- 国 / サービス
- 145 / 1,255
- コードがない場合は自動返金
- 20分
業界標準の方法
APIキーごとに
国 / サービス
コードがない場合は自動返金
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 |
| service | getNumber | サービス名コード(例:telegram、whatsapp、google)。サービス一覧ページと同じ値です |
| country | getNumber | 国コード2文字 (例: gb, us, id) |
| id | getStatus, setStatus | getNumberで発行した番号ID(Nで始まる) |
| status | setStatus | 8でキャンセル、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_KEY | APIキーが正しくありません | 課金されません |
| BAD_SERVICE / BAD_COUNTRY | サービスまたは国コードが正しくありません | 課金されません |
| NO_ACTIVATION | 番号IDが見つかりません | そのまま |
| TOO_MANY_REQUESTS | 1分あたり300回を超えました | 課金されません |
APIでコードを受け取る順序は?
番号を受け取り、入力し、コードを確認して完了する4ステップです。
- 1ステップ
番号を取得
getNumberで希望のサービスと国を選択し番号を発行してください。
action=getNumber&service=telegram&country=gb > ACCESS_NUMBER:SS8Q2K7:447700900123
- 2ステップ
番号入力
購入した番号を登録ページやプログラムに入力してください。
+44 7700 900123
- 3ステップ
コードを確認
5秒ごとにgetStatusを呼び出しコード到着を確認してください
action=getStatus&id=SS8Q2K7 > STATUS_OK:48215
- 4ステップ
終了
コード入力後、setStatus 6で完了してください。20分以内にコードがなければ自動返金されます。
action=setStatus&id=SS8Q2K7&status=6 > ACCESS_ACTIVATION
言語別のサンプル
番号を受け取り、コードを待ち、完了するまでの全プロセスです。タップして言語を変更してください。
# Balance
curl "https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=getBalance"
# Get a number (Telegram, United Kingdom)
curl "https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=getNumber&service=telegram&country=gb"
# ACCESS_NUMBER:N-8Q2K7XLM:447700900123
# Check the code (every 5 seconds)
curl "https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=getStatus&id=N-8Q2K7XLM"
# STATUS_WAIT_CODE or STATUS_OK:48215
# Finish (6) / Cancel (8, full refund before a code)
curl "https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=setStatus&id=N-8Q2K7XLM&status=6"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)// Node.js 18+
const BASE = "https://snssim.com/stubs/handler_api.php";
const KEY = "API_KEY";
const call = (p) => fetch(BASE + "?" + new URLSearchParams({ api_key: KEY, ...p })).then((r) => r.text());
const r = await call({ action: "getNumber", service: "telegram", country: "gb" });
if (!r.startsWith("ACCESS_NUMBER")) throw new Error(r);
const [, id, phone] = r.split(":");
console.log("Number:", phone);
for (let i = 0; i < 240; i++) {
const s = await call({ action: "getStatus", id });
if (s.startsWith("STATUS_OK")) {
console.log("Code:", s.split(":")[1]);
await call({ action: "setStatus", id, status: "6" });
break;
}
await new Promise((ok) => setTimeout(ok, 5000));
}<?php
$base = "https://snssim.com/stubs/handler_api.php";
$key = "API_KEY";
function call($p) { global $base, $key;
return file_get_contents($base . "?" . http_build_query(["api_key" => $key] + $p)); }
$r = call(["action" => "getNumber", "service" => "telegram", "country" => "gb"]);
if (strpos($r, "ACCESS_NUMBER") !== 0) exit($r);
[, $id, $phone] = explode(":", $r);
echo "Number: $phone\n";
for ($i = 0; $i < 240; $i++) {
$s = call(["action" => "getStatus", "id" => $id]);
if (strpos($s, "STATUS_OK") === 0) {
echo "Code: " . explode(":", $s)[1] . "\n";
call(["action" => "setStatus", "id" => $id, "status" => 6]);
break;
}
sleep(5);
}package main
import ("fmt"; "io"; "net/http"; "net/url"; "strings"; "time")
const base = "https://snssim.com/stubs/handler_api.php"
const key = "API_KEY"
func call(p url.Values) string {
p.Set("api_key", key)
r, _ := http.Get(base + "?" + p.Encode())
defer r.Body.Close()
b, _ := io.ReadAll(r.Body)
return string(b)
}
func main() {
r := call(url.Values{"action": {"getNumber"}, "service": {"telegram"}, "country": {"gb"}})
if !strings.HasPrefix(r, "ACCESS_NUMBER") { fmt.Println(r); return }
f := strings.Split(r, ":")
fmt.Println("Number:", f[2])
for i := 0; i < 240; i++ {
s := call(url.Values{"action": {"getStatus"}, "id": {f[1]}})
if strings.HasPrefix(s, "STATUS_OK") {
fmt.Println("Code:", strings.Split(s, ":")[1])
call(url.Values{"action": {"setStatus"}, "id": {f[1]}, "status": {"6"}})
return
}
time.Sleep(5 * time.Second)
}
}import java.net.URI; import java.net.URLEncoder; import java.net.http.*;
import java.nio.charset.StandardCharsets; import java.util.Map; import java.util.stream.Collectors;
public class SNSSIM {
static final String BASE = "https://snssim.com/stubs/handler_api.php", KEY = "API_KEY";
static final HttpClient http = HttpClient.newHttpClient();
static String call(Map<String, String> p) throws Exception {
String q = p.entrySet().stream().map(e -> e.getKey() + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8)).collect(Collectors.joining("&"));
return http.send(HttpRequest.newBuilder(URI.create(BASE + "?api_key=" + KEY + "&" + q)).build(), HttpResponse.BodyHandlers.ofString()).body();
}
public static void main(String[] a) throws Exception {
String r = call(Map.of("action", "getNumber", "service", "telegram", "country", "gb"));
if (!r.startsWith("ACCESS_NUMBER")) { System.out.println(r); return; }
String[] f = r.split(":");
System.out.println("Number: " + f[2]);
for (int i = 0; i < 240; i++) {
String s = call(Map.of("action", "getStatus", "id", f[1]));
if (s.startsWith("STATUS_OK")) { System.out.println("Code: " + s.split(":")[1]); call(Map.of("action", "setStatus", "id", f[1], "status", "6")); return; }
Thread.sleep(5000);
}
}
}using System.Net.Http;
const string Base = "https://snssim.com/stubs/handler_api.php";
const string Key = "API_KEY";
var http = new HttpClient();
async Task<string> Call(string q) => await http.GetStringAsync($"{Base}?api_key={Key}&{q}");
var r = await Call("action=getNumber&service=telegram&country=gb");
if (!r.StartsWith("ACCESS_NUMBER")) { Console.WriteLine(r); return; }
var f = r.Split(':');
Console.WriteLine($"Number: {f[2]}");
for (var i = 0; i < 240; i++)
{
var s = await Call($"action=getStatus&id={f[1]}");
if (s.StartsWith("STATUS_OK"))
{
Console.WriteLine($"Code: {s.Split(':')[1]}");
await Call($"action=setStatus&id={f[1]}&status=6");
break;
}
await Task.Delay(5000);
}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メニューで作成してください。キーは作成時一度だけ表示されるので即座に保存してください。