• 228 направлений
  • Без KYC — всегда
  • Bitcoin, Monero, USDT и ещё 4 валюты

API и интеграция

Тестовый ключ (песочница)

Тестовый ключ — учётные данные API, с которыми запросы проходят ту же проверку и расчёт стоимости, что и в рабочем режиме, но сообщения не отправляются и баланс не списывается.

Тестовый ключ даёт интеграции безопасное место для ошибок. Запросы с ним проходят ту же проверку и расчёт цены, что и рабочий трафик, и получают ответы того же формата, поэтому форматы запросов, обработку ошибок, повторы и обработку вебхуков можно отработать без последствий. Лучшие песочницы отличаются от рабочей среды ровно в одном — в самой отправке — и явно обозначают это отличие собственным статусом, а не делают вид, что сообщение доставлено.

Тестовый ключ проверяет интеграцию, а не маршрут. Доходят ли сообщения до телефонов, как быстро, под каким отправителем и как текст выглядит на экране телефона, видно только на рабочем трафике. Обычная последовательность: тестовый ключ для разработки и автотестов, затем несколько рабочих сообщений на собственные телефоны, затем запуск в рабочем режиме. Если держать тестовые и рабочие ключи в разных средах, а в коде ветвить логику по статусу, результаты тестов не попадут в реальные записи.

Это ещё и честный вариант бесплатного пробного периода: ничего не раздаётся даром и ничего не подделывается.

Пример

Условная разработчица создаёт сценарий отправки кодов регистрации на тестовом стенде с тестовым ключом. Каждый запрос возвращает идентификатор сообщения, цену и число сегментов со статусом test; недопустимые номера вызывают те же ошибки, что и в рабочем трафике; подписанные вебхуки приходят на эндпоинт её тестового стенда, поэтому проверка подписи тоже тестируется. Для перехода в рабочий режим достаточно изменить одно значение в конфигурации.

Типичные ошибки

  • Записывать тестовые сообщения в собственную базу данных как доставленные.
  • Использовать рабочий ключ в автотестах.
  • Считать успешный тестовый прогон доказательством того, что сообщения будут доставляться в страну.

В SMSMeteor: у каждой учётной записи есть ключ sk_test_. Запросы с ним проверяются, для них рассчитывается цена, а в ответе возвращается статус test; ничего не отправляется и не списывается, но вебхуки всё равно срабатывают и подписываются так же, как рабочие. Кроме того, из панели можно отправить на ваш эндпоинт тестовое событие любого типа. Подход подробно разобран в статье «Интеграция без затрат»; см. также быстрый старт.

Подробнее

Посмотрите, как это работает на практике.Для регистрации достаточно адреса электронной почты. Таблица тарифов открыта, оплата принимается в криптовалюте, тестовый ключ бесплатный.
Начать отправку