Частые вопросы
Общее
Что делает Verificahub?
Подтверждает, что номер телефона принадлежит пользователю. Вы инициируете проверку через API, пользователь совершает действие (звонок или ввод кода), и вы получаете подтверждённый номер.
Какие методы подтверждения доступны?
Активны: reverse_flash_call, flash_call, telegram, sms. Метод voice (голосовой код) — скоро. Полное сравнение и тарифы — в разделе Методы и тарифы.
По способу подтверждения методы делятся на два типа:
- Автоматический —
reverse_flash_call: пользователь сам звонит на выданный номер, подтверждение без ввода кода. - С вводом кода —
telegram,sms,flash_call: пользователь вводит код, вы подтверждаете его черезPOST /v1/verify/check. Уflash_callкод — это последние цифры входящего номера.
Как подключиться?
Оставьте заявку на verificahub.ru, получите доступ и API-ключ в личном кабинете — см. Быстрый старт.
Запросы к API
Какой базовый адрес API?
https://api.verificahub.ru/v1.
Как авторизоваться?
HTTP Basic: пара api_key:api_secret. В curl — флаг -u api_key:api_secret. Передавайте их только с сервера, не из клиентского кода.
В каком формате передавать номер?
В формате E.164, например +79991234567. В ответах номер тоже нормализуется к E.164.
Что такое request_id?
Идентификатор сессии проверки. Возвращается при инициировании и используется, чтобы узнать статус (GET /v1/verify/{request_id}) или проверить код.
Сколько живёт сессия проверки?
Срок задаётся параметром expiry_seconds при инициировании (если не указать — применяется значение по умолчанию). Точное время окончания приходит в поле expires_at. После него статус становится expired.
Как узнать, что номер подтверждён?
Для reverse_flash_call опрашивайте GET /v1/verify/{request_id}, пока status не станет verified. Для методов с вводом кода (telegram, sms, flash_call) подтверждение возвращается сразу в ответе на POST /v1/verify/check.
Нужно ли вызывать /v1/verify/check для обратного flash-call?
Нет. При reverse_flash_call подтверждение происходит автоматически по входящему звонку. /v1/verify/check нужен только для методов с вводом кода (telegram, sms, flash_call).
Тарифы и оплата
Сколько это стоит?
Оплата pay-as-you-go: списание за каждую инициированную проверку по тарифу метода:
| Метод | Цена |
|---|---|
reverse_flash_call | 0,25 ₽ |
flash_call | 0,80 ₽ |
telegram | 0,90 ₽ |
sms | 3,00 ₽ |
voice | скоро |
Цены ориентировочные; актуальные тарифы — на verificahub.ru.
Когда списываются деньги?
Стоимость фиксируется при инициировании проверки и приходит в поле cost ответа.
Что будет при нулевом балансе?
Инициирование вернёт ошибку 402. Следите за балансом через GET /v1/balance — см. Баланс и статистика.
Где смотреть статистику и расходы?
GET /v1/usage — сводка за период: число проверок, конверсия, разбивка по методам и статусам, затраты.
Ошибки
Что значат статусы expired и failed?
expired — пользователь не успел подтвердить до конца сессии. failed — подтвердить не удалось. Подробнее — в разделе Статусы и ошибки.
Получаю 401 — в чём дело?
Неверные api_key или api_secret, либо они не переданы. Проверьте учётные данные и способ авторизации (Basic).
Получаю 400 при проверке кода (Telegram / SMS / Flash Call).
Код неверный или сессия истекла. Покажите пользователю сообщение и предложите запросить код заново.