Verify (OTP check)

API для создания и проверки одноразовых кодов верификации (OTP) через SMS, Email и другие каналы.

Endpoint: <ApiUrl/>/api/verify.php

Запросы по POST отправляются с заголовком Content-Type: application/json. Проверка кода (verify) поддерживает также GET.

---

Создание кода (verify/create)

Создаёт код верификации и отправляет его по SMS или Email. Запрос принимается в очередь для обработки; в ответ сразу возвращаются success и request_id.

Метод: POST

Параметры запроса

authstringобязательный API ключ из личного кабинета

commandstringобязательный Должно быть verify/create

phonestringобязательный Номер телефона в любом формате (обязателен, если не указан email)

emailstringобязательный Email адрес (обязателен, если не указан phone)

typestringобязательный Тип верификации: sms, hlr, rcs, email, viber

sender_namestringобязательный Альфаимя отправителя для SMS

langstring Язык сообщения: uk, ru, en (по умолчанию en)

code_lengthnumber Длина кода (по умолчанию 8, диапазон 1–10)

code_typestring Тип кода: numeric, alphabetic, alphanumeric, extended (по умолчанию numeric)

service_idnumber ID сервиса верификации

custom_idstring Пользовательский идентификатор для связи с вашей системой

hookstring URL для webhook уведомлений о статусе верификации

Пример запроса

{
  "auth": "API_KEY",
  "command": "verify/create",
  "phone": "441501234567",
  "type": "sms",
  "sender_name": "MyBrand",
  "lang": "en",
  "code_length": 6,
  "code_type": "numeric",
  "service_id": 1,
  "custom_id": "abcdef1234567",
  "hook": "https://example.com/webhook"
}

Ответ

successboolean Результат приёма запроса

request_idstring Идентификатор запроса

Пример ответа:

{
  "success": true,
  "request_id": "cf-ray-1234567890-ABC"
}

Ошибки HTTP: 400 (неверный формат/JSON), 401 (неверный auth), 413 (лимит размера тела), 503 (очередь недоступна).

---

Проверка кода (verify)

Запрос проверяет введённый пользователем код и возвращает статус верификации.

Параметры запроса

authstringrequired API ключ, который можно получить в личном кабинете

commandstringrequired Должно быть verify

phonestringобязательный Номер телефона (обязателен, если не указан email)

emailstringобязательный Email адрес (обязателен, если не указан phone)

codestringобязательный Код для проверки

verify_idstring ID верификации (UUID)

service_idnumber ID сервиса верификации (если не указан verify_id)

custom_idstring Пользовательский идентификатор (если не указаны service_id и verify_id)

Пример запроса (GET)

/api/verify.php?auth=API_KEY&command=verify&phone=380501234567&code=123456&verify_id=14fb5f3d-20be-41ef-b31a-b9f5e499bc7a

Пример запроса (POST, JSON)

{
  "auth": "API_KEY",
  "command": "verify",
  "phone": "380501234567",
  "code": "123456",
  "verify_id": "14fb5f3d-20be-41ef-b31a-b9f5e499bc7a"
}

Ответ

successboolean Результат запроса

verify_idstring ID верификации

phonestring Номер телефона

typestring Тип канала: sms, email, hlr, rcs, viber

statusstring Статус верификации (см. ниже)

service_idnumber ID сервиса верификации

Пример успешного ответа:

{
  "success": true,
  "verify_id": "14fb5f3d-20be-41ef-b31a-b9f5e499bc7a",
  "phone": "441501234567",
  "type": "sms",
  "status": "approved",
  "service_id": 1
}

Возможные статусы status:

status	Описание
approved	Код верный, верификация успешна
pending	Код неверный, попытки ещё остались
expired	Код истёк
blocked	Превышен лимит попыток

Коды ошибок HTTP:

• 400 — неверный формат запроса или JSON
• 401 — отсутствует или неверный auth
• 413 — превышен лимит размера тела запроса

---

Примеры вызова (curl)

verify/create (SMS):

curl -X POST https://portal.interconnect.solutions/api/verify.php \
  -H "Content-Type: application/json" \
  -d '{
    "auth": "your-api-key",
    "command": "verify/create",
    "phone": "441501234567",
    "type": "sms",
    "sender_name": "MyBrand",
    "lang": "en",
    "code_length": 6
  }'

verify/create (Email):

curl -X POST https://portal.interconnect.solutions/api/verify.php \
  -H "Content-Type: application/json" \
  -d '{
    "auth": "your-api-key",
    "command": "verify/create",
    "email": "user@example.com",
    "type": "email",
    "lang": "en",
    "code_length": 8
  }'

verify (проверка кода), GET:

curl "https://portal.interconnect.solutions/api/verify.php?auth=your-api-key&command=verify&phone=441501234567&code=123456&verify_id=14fb5f3d-20be-41ef-b31a-b9f5e499bc7a"

verify (проверка кода), POST:

curl -X POST https://portal.interconnect.solutions/api/verify.php \
  -H "Content-Type: application/json" \
  -d '{
    "auth": "your-api-key",
    "command": "verify",
    "phone": "441501234567",
    "code": "123456",
    "verify_id": "14fb5f3d-20be-41ef-b31a-b9f5e499bc7a"
  }'

---

Ограничения

• Время жизни кода: по умолчанию 300 секунд (5 минут), диапазон 60–3600 секунд.
• Максимальные попытки ввода: по умолчанию 5.