endpoint سازگار با sms-activate

بسیاری از ابزارها با پروتکل sms-activate کار می‌کنند. SmsGrab یک endpoint سازگار ارائه می‌دهد، پس این ابزارها با عوض کردن نشانی پایه و استفاده از کلید API خود در SmsGrab کار می‌کنند.

endpoint

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

کنش‌های پشتیبانی‌شده

شناسه‌ها

• سرویس‌ها در صورت وجود از کدهای کوتاه پروتکل استفاده می‌کنند، مثل wa برای WhatsApp، tg برای Telegram، go برای Google، fb برای Facebook، ig برای Instagram و ds برای Discord. شناسه‌های سرویس خود ما هم کار می‌کنند.
• کشورها در صورت وجود از شناسه‌های عددی پروتکل استفاده می‌کنند، مثل 0 برای روسیه، 6 برای اندونزی، 4 برای فیلیپین، 22 برای هند و 187 برای آمریکا. شناسه‌های ما و کدهای ISO هم کار می‌کنند.
• getCountries و getServicesList فهرست‌های کامل و به‌روز را برمی‌گردانند.
• id فعال‌سازی عددی مثل 100000123 است و REST API هم آن را می‌پذیرد.

تفاوت‌هایی که باید بدانید

• مبالغ به دلار آمریکا و با دو رقم اعشار، به قیمت توسعه‌دهنده شما هستند. به روبل نیستند.
• operator نادیده گرفته می‌شود؛ بهترین پیشنهاد موجود برایتان انتخاب می‌شود.
• به خطاها مثل پروتکل اصلی پاسخ داده می‌شود، با HTTP 200 و متنی مثل NO_NUMBERS، NO_BALANCE یا BAD_KEY. درخواست‌های بیش از حد HTTP 429 با TOO_MANY_REQUESTS می‌گیرند.
• NO_ACCESS یعنی کلید دامنه purchase را ندارد، نشانی IP مجاز نیست یا سقف هزینه روزانه پر شده است.
• اجاره از طریق این endpoint در دسترس نیست.

بقیه موارد با REST API مشترک است: همان کلیدها، محدودیت‌ها، قیمت‌ها، بازپرداخت‌ها و وب‌هوک‌ها.