Перейти к основному содержимому

Проверка телефонного номера

Отправьте телефонный номер для валидации и определения мошенничества.

Отправить проверку телефона

Создать новый запрос на проверку телефонного номера.

Endpoint

POST /api/v1/checkers/phone/

Тело запроса

{
"value": "+88002000600"
}

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

curl -X 'POST' \
'https://app.cyberyozh.com/api/v1/checkers/phone/' \
-H 'accept: application/json' \
-H 'X-Api-Key: ваш_api_ключ' \
-H 'Content-Type: application/json' \
-d '{
"value": "+12025550123"
}'

Поля запроса

ПолеТипОбязательноОписание
valuestringДаТелефонный номер в международном формате (E.164)

Формат телефонного номера

Телефонные номера должны быть предоставлены в международном формате с кодом страны:

  • ✅ Правильно: +12025550123, +442071234567, +88002000600
  • ❌ Неправильно: 2025550123, 02071234567, 8002000600

Ответ (201)

{
"id": "9adb5486-0742-4c6f-a372-d434649aa698"
}

Ответ содержит уникальный идентификатор, который можно использовать для получения результатов проверки.

Поля ответа

ПолеТипОписание
idstringUUID для этого запроса проверки

Следующие шаги

После отправки проверки:

  1. Сохраните возвращенный id
  2. Используйте его для получения результатов проверки
  3. Проверка обычно завершается в течение нескольких секунд

Примечания

  • Каждый запрос на проверку телефона расходует кредиты с вашего баланса
  • Результаты проверки сохраняются и могут быть получены несколько раз, используя один и тот же ID
  • Неверные форматы телефонных номеров вернут ошибку
  • Один и тот же телефонный номер можно проверять несколько раз (каждая проверка оплачивается отдельно)