Принимайте коды подтверждения и отправляйте SMS через один SMS API

Что такое SMS API?

SMS API это подключение, через которое ваша программа принимает или отправляет SMS с помощью HTTP-запросов. Код делает то, что человек сделал бы кликами на сайте, поэтому повторяющиеся задачи, например автотесты регистрации, отправка кодов подтверждения и уведомлений о заказах, выполняются без ручной работы.

API TODAY SMS даёт две возможности вместе. Первая это API SMS-верификации (API SMS-активации) для приёма кодов подтверждения приложений на одноразовые номера, вторая это API отправки SMS на мобильные телефоны по всему миру. Оба используют один URL, один API-ключ и один баланс, поэтому отдельная регистрация и отдельное пополнение не нужны.

Как пользоваться API SMS-верификации?

Всего четыре шага. Выберите код приложения через GET /apps и посмотрите страны и цены через GET /prices?app=CODE. Купите номер через POST /numbers и получите номер и его id, затем каждые несколько секунд вызывайте GET /numbers/{id}, чтобы проверить, пришёл ли код. Получив код, закройте номер через POST /numbers/{id}/finish.

Каждый номер ждёт SMS 20 минут, а SMS на тот же номер за это время ничего не стоят. Если SMS не придёт, по окончании срока вся сумма вернётся на баланс, а если ничего не пришло, можно отменить номер самостоятельно через POST /numbers/{id}/cancel начиная с 120 секунд после покупки. Когда нужна автоматизация верификации приложений или API виртуальных номеров для больших объёмов, просто повторяйте этот сценарий.

Как пользоваться API отправки SMS?

Отправьте список получателей (to) и текст сообщения (text) на POST /messages, и в ответ придут id сообщения, число получателей, число частей и итоговая стоимость. Указывайте получателей в международном формате с + и кодом страны, до 1,000 в запросе. Чтобы запланировать отправку, укажите время UTC в at.

После отправки проверяйте отчёт о доставке по каждому получателю через GET /messages/{id}. Статусов четыре: pending, sent, delivered и failed, а сумма за части со статусом failed добавляется в refunded и возвращается на баланс. Запланированную отправку, которая ещё не началась, отменяйте через POST /messages/{id}/cancel.

Тем же методом отправляйте коды подтверждения (OTP). Каждый код считается одним SMS без отдельной платы за верификацию, а цену за SMS для каждой страны можно получить через GET /messages/prices и рассчитать расходы.

На что смотреть при выборе недорогого SMS API?

Смотрите на итоговую сумму, которую вы реально платите, а не только на цену за SMS в прайс-листе. У TODAY SMS нет абонентской платы, списываются только отправленные части, а за недоставленные части и коды подтверждения, которые так и не пришли, деньги возвращаются на баланс.

Далее рассмотрите управление ключами и ограничения. Вы получаете один API-ключ на аккаунт и можете создать новый в любое время, что сразу блокирует старый ключ. Разрешено до 300 запросов в минуту, что достаточно для большинства автоматизаций. Наконец, рассмотрите оплату. Вы можете пополнить баланс с помощью 12 криптовалютных методов, включая USDT, USDC и BTC, без карты, что позволяет начать сразу из любой страны.

Как получить API-ключ?

Создайте аккаунт, и после зачисления первого пополнения вы сможете создать ключ на странице API-ключа. Ключ показывается только один раз при создании, поэтому сохраните его в надёжном месте. Передавайте его в каждом запросе в заголовке Authorization: Bearer.

Если вы думаете, что ключ утёк, создайте новый на странице API-ключа. Старый ключ сразу перестанет работать. Любой, у кого есть ваш ключ, может покупать номера или отправлять SMS с вашего баланса, поэтому никогда не размещайте его в коде браузера или публичном репозитории.