API для разработчиков по SMS-верификации: первые шаги

Если вы тестируете процесс регистрации в своём приложении или автоматизируете подтверждение, API позволяет делать всё то же, что и панель, не открывая её.

Перед началом

Получите ключ на странице API в своей панели. Не публикуйте ключ в репозитории с кодом; храните его в переменной окружения.

Базовый порядок действий

1. Получите список сервисов и стран.
2. Купите номер.
3. Периодически запрашивайте статус или используйте webhook.
4. Завершите активацию, когда придёт код; если код не придёт, отмените активацию.

На что обратить внимание

• При повторных запросах передавайте заголовок Idempotency-Key. Если после сетевой ошибки повторить запрос с тем же ключом, второй номер куплен не будет.
• Соблюдайте лимит запросов; не сокращайте интервал опроса без необходимости.
• Обрабатывайте отдельно ответы «недостаточно средств» и «нет в наличии» в своём коде.

Если ваше ПО использует протокол, совместимый с SMS-Activate, можно подключиться через совместимые эндпоинты без изменения кода. Все подробности — в документации API.