API ドキュメント
sms-activate 互換の handler_api。同じアクション、ステータス、国コード、サービスコードに加え、コード Webhook にも対応。
handler_api URL
https://allinsms.com/stubs/handler_api.php
REST API ベース
https://allinsms.com/v1
番号 (handler_api)
api_key と action を付けて GET または POST します。国は標準の数値 ID (getCountries)、サービスは標準コード (tg、wa、go …) を使います。特記がない限り、レスポンスはプレーンテキストです。
GET https://allinsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=6| action | パラメーター | レスポンス | 説明 |
|---|---|---|---|
| getBalance | なし | ACCESS_BALANCE:12.3400 | 現在のUSDクレジット。 |
| getNumber | service, country, maxPrice? | ACCESS_NUMBER:1042:6281244739021 | 番号を購入します。即時に課金され、コードが届かなければ返金されます。 |
| getNumberV2 | service, country, maxPrice? | {"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…} | getNumber と同じで、価格と終了時刻を含む JSON レスポンスを返します。 |
| getStatus | id | STATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL | コードが届くまで 3〜5 秒ごとにポーリングします。 |
| getStatusV2 | id | {"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null} | SMS 全文を含む JSON ステータス。 |
| getFullSms | id | FULL_SMS:Your code is 48213 | 最後の SMS の全文。 |
| setStatus | id, status=1|3|6|8 | ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL | 1 準備完了、3 別のコード、6 完了、8 キャンセル (待機時間後、コード受信前)。 |
| getActiveActivations | なし | {"status":"success","activeActivations":[…]} | 現在有効なあなたの番号。 |
| getPrices | service?, country? | {"6":{"tg":{"cost":"0.7800","count":5320}}} | 国とサービスごとの価格と在庫。 |
| getNumbersStatus | country? | {"tg_0":"5320","wa_0":"812",…} | 国ごとのサービス別在庫。 |
| getCountries | なし | {"6":{"id":6,"eng":"Indonesia","iso":"id","phoneCode":"62",…}} | ID 付きの国一覧。 |
| getServicesList | なし | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | サービスコードと名称。 |
setStatus の値
- 1 · 番号をサービスに送信済み、SMS 待ち
- 3 · 同じ番号で別のコードをリクエスト
- 6 · アクティベーションを完了
- 8 · キャンセルして返金 (コード受信前)
タイミング
番号の有効時間は標準で 20 分です。キャンセルは購入から 120 秒後に受け付けます (それより前は EARLY_CANCEL_DENIED を返します)。コードがないまま終了したアクティベーションは自動で返金されます。レート制限: キーごとに毎分 300 リクエスト。
エラー
NO_KEYBAD_KEYNO_ACTIONBAD_ACTIONBAD_SERVICEBAD_COUNTRYNO_NUMBERSNO_BALANCEWRONG_MAX_PRICE:0.7800CHANNELS_LIMITNO_ACTIVATIONBAD_STATUSEARLY_CANCEL_DENIEDTOO_MANY_REQUESTS
Webhook
アカウントで Webhook URL を設定すると、受信したすべてのコードを JSON で POST します。サーバーが 2xx を返さない場合は 2 回まで再送します。
POST https://your-server/webhook
{ "activationId": 1042, "service": "tg", "country": "id", "phone": "6281244739021",
"code": "48213", "text": "Telegram code: 48213 …", "receivedAt": "2026-10-09T03:12:44.000Z" }