API для разработчиков
Покупайте номера из своего ПО с помощью API-ключей, цен для разработчиков и объёмных уровней, подписанных вебхуков и эндпоинта, совместимого с sms-activate.
5 инструкций · 4 быстрых ответа
Инструкции
-
Быстрый старт с API для разработчиков Покупайте номера и читайте коды из своего ПО. Создайте ключ, узнайте цены, купите номер, дождитесь SMS и завершите, шаг за шагом.
-
API-ключи и безопасность Области доступа, списки разрешённых IP, дневные лимиты расходов, срок действия, ротация без простоя и что делать при утечке ключа.
-
Цены для разработчиков и объёмные уровни Цена для разработчиков — это оптовая цена плюс наценка, которая снижается с ростом вашего объёма за 30 дней, но не ниже 0,10 USD и не выше цены в приложении.
-
Вебхуки Получайте события активаций на свой сервер в реальном времени, проверяйте заголовок SmsGrab-Signature и разберитесь с повторами, тестовыми доставками и автоматическим отключением.
-
Эндпоинт, совместимый с sms-activate Продолжайте пользоваться ботами и панелями для протокола sms-activate, сменив один URL. Поддерживаемые действия, форматы идентификаторов и важные отличия.
Быстрые ответы
Сколько стоит API для разработчиков?
Подписки нет: вы платите за каждый номер со своего обычного баланса. Цена для разработчиков — это оптовая цена плюс наценка 80 %, которая снижается до 70 % от 100 USD, до 60 % от 500 USD и до 50 % от 2000 USD расходов разработчика за последние 30 дней. Она никогда не бывает ниже 0,10 USD и выше цены в приложении. За номера без кода деньги возвращаются как обычно. См. Цены для разработчиков и объёмные уровни.
Сколько запросов можно отправлять в API?
По умолчанию каждый ключ может отправлять 600 запросов и делать 60 покупок в минуту, а все ключи аккаунта вместе — 3000 запросов в минуту. На одном аккаунте одновременно могут ждать код до 100 номеров, а на один ключ может быть открыто до 20 ожидающих запросов (?wait=). При превышении лимита вы получите 429 RATE_LIMITED с заголовком Retry-After; в каждом ответе также есть заголовки RateLimit-*. См. Быстрый старт с API для разработчиков.
Мой API-ключ утёк. Что делать?
Действуйте сразу: отзовите ключ в Аккаунт > Разработчикам или выполните ротацию с переходным периодом 0 часов. Отзыв срабатывает мгновенно и не требует пароля. Затем проверьте журнал запросов ключа и Кошелёк на незнакомую активность и создайте новый ключ со списком разрешённых IP и дневным лимитом расходов. Храните ключи только на серверах, никогда в приложениях или на веб-страницах. См. API-ключи и безопасность.
Работают ли с SmsGrab инструменты для sms-activate?
Да, в большинстве случаев. Укажите в инструменте https://smsgrab.com/api/stubs/handler_api.php и используйте свой API-ключ SmsGrab как api_key. Поддерживаются стандартные действия, от getBalance и getNumber до setStatus и getStatus. Суммы указаны в долларах США по вашей цене для разработчиков, а не в рублях, и аренда недоступна. См. Эндпоинт, совместимый с sms-activate.
Другие темы
Всё ещё нужна помощь?
Напишите нам. Мы отвечаем на каждое сообщение, обычно в течение нескольких часов.
Или напишите на support@smsgrab.com