Выберите язык

API для разработчиков

Покупайте номера из своего ПО с помощью API-ключей, оптовых скидок, подписанных вебхуков и эндпоинта, совместимого с sms-activate.

5 инструкций · 4 быстрых ответа

Инструкции

  • Быстрый старт с API для разработчиков Покупайте номера и читайте коды из своего ПО. Создайте ключ, узнайте цены, купите номер, дождитесь SMS и завершите, шаг за шагом. 4 мин чтения
  • API-ключи и безопасность Области доступа, списки разрешённых IP, дневные лимиты расходов, срок действия, ротация без простоя и что делать при утечке ключа. 2 мин чтения
  • Оптовые цены и уровни объёма API продаёт по тем же ценам, что и приложение, за вычетом оптовой скидки: уровня объёма по расходам за 30 дней или фиксированной скидки реселлера. 2 мин чтения
  • Вебхуки Получайте события активаций на свой сервер в реальном времени, проверяйте заголовок SmsGrab-Signature и разберитесь с повторами, тестовыми доставками и автоматическим отключением. 3 мин чтения
  • Эндпоинт, совместимый с sms-activate Продолжайте пользоваться ботами и панелями для протокола sms-activate, сменив один URL. Поддерживаемые действия, форматы идентификаторов и важные отличия. 2 мин чтения

Быстрые ответы

Сколько стоит API для разработчиков?

Подписки нет: вы платите за каждый номер с обычного баланса. Каждый номер стоит столько же, сколько в приложении, за вычетом вашей оптовой скидки. Уровни объёма снижают цену, как только ваши чистые расходы за последние 30 дней во всех каналах переходят порог, а одобренные реселлеры получают фиксированную скидку; всегда действует бо́льшая из двух. Номера без кода возвращаются как обычно. См. Оптовые цены и уровни объёма.

Открыть этот ответ на отдельной странице
Сколько запросов можно отправлять в 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