sms-activate 互換エンドポイント

多くのツールが sms-activate プロトコルを使っています。SmsGrab には互換エンドポイントがあるため、ベース URL を変更して SmsGrab の API キーを使えば、これらのツールが動作します。

エンドポイント

https://smsgrab.com/api/stubs/handler_api.php

api_key と action を、アクションのパラメーターとともに GET または POST で送信します。キーは Authorization: Bearer として送ることもできます。

例

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getBalance"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getNumber&service=tg&country=6"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getStatus&id=100000123"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=setStatus&id=100000123&status=6"

ACCESS_BALANCE:12.34
ACCESS_NUMBER:100000123:6281234567890
STATUS_WAIT_CODE
STATUS_OK:482913
ACCESS_ACTIVATION

対応アクション

ID

• サービス には、プロトコルの短いコードがあればそれを使います。たとえば wa WhatsApp、tg Telegram、go Google、fb Facebook、ig Instagram、ds Discord です。SmsGrab のサービス ID も使えます。
• 国 には、プロトコルの数値 ID があればそれを使います。たとえば 0 ロシア、6 インドネシア、4 フィリピン、22 インド、187 米国です。SmsGrab の ID と ISO コードも使えます。
• getCountries と getServicesList は、最新の一覧をすべて返します。
• アクティベーションの id は 100000123 のような数値で、REST API でも使えます。

知っておきたい違い

• 金額は米ドル で、小数点以下 2 桁の開発者価格です。ルーブルではありません。
• operator は無視され、利用可能な最適な番号が選ばれます。
• エラーは元のプロトコルと同じく、HTTP 200 と NO_NUMBERS、NO_BALANCE、BAD_KEY などのテキストで返ります。リクエストが多すぎる場合は HTTP 429 と TOO_MANY_REQUESTS が返ります。
• NO_ACCESS は、キーに purchase スコープがない、IP アドレスが許可されていない、または 1 日の利用上限に達したことを意味します。
• このエンドポイントではレンタルを利用できません。

それ以外は REST API と同じです。キー、制限、価格、返金、Webhook も共通です。