Один процесс — в панели и в API
Опробуйте проверки в панели, затем подключите свой сервер к тем же одиночным и массовым проверкам через API.
Начните с одиночной проверки
Отправляйте запросы на https://api.numdetect.com с API-ключом, который хранится на вашем сервере. В панели можно создать несколько ключей, по одному на систему, и удалить любой из них. Не размещайте ключ в frontend-коде.
curl "https://api.numdetect.com/api/v1/checks" \
-H "Authorization: Bearer $NUMDETECT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"phone": "+12025550147",
"products": [
"whatsapp"
]
}'Иллюстративный запрос с образцом номера. Замените $NUMDETECT_API_KEY своим ключом; каждый запуск — это реальная платная проверка.
Что возвращает проверка
Каждый вход получает одну запись на продукт. Сначала смотрите registered: true и false — однозначные, null — неизвестно. Одиночная проверка оплачивается только за true и false; оптовая группа оплачивается полностью, когда её пакет завершён.
{
"id": "10000000-0000-4000-8000-000000000001",
"input_kind": "phone",
"input": "+12025550147",
"country": "US",
"charged": 4000,
"results": [
{
"product_id": "whatsapp",
"status": "success",
"result": true,
"price": 4000,
"charged": 4000
}
]
}status- success: однозначный ответ; unknown: нет однозначного ответа; failed: продукт оказался недоступен. Оплачивается только success.
result- true: аккаунт найден; false: аккаунта нет; null, если status не success.
info- Дополнительные поля, которые возвращают некоторые продукты, например признак WhatsApp Business.
price- Цена этого продукта за проверку в USD micros (1 000 000 = $1).
charged- Что фактически списано: цена при однозначном ответе, иначе 0.
01
Изучите процесс в кабинете
Запустите несколько одиночных проверок в панели, чтобы увидеть входные данные и ответы, прежде чем писать интеграцию.
02
Получите актуальный каталог
Получите список продуктов, чтобы увидеть, какие продукты в продаже, их типы входных данных, страны и цены. Не зашивайте их в код на основе публичного сайта.
03
Создайте задачу и отслеживайте её
Отправляйте Idempotency-Key при создании проверки или массового задания. Если ответ потерялся, повторите запрос с тем же ключом, а не с новым.
Массовая проверка номеров
- 1
Загрузите файл CSV или текстовый файл с продуктами, столбцом номеров и максимальной суммой, которую вы готовы заплатить.
- 2
Список делится по странам; каждая страна проверяется каждым выбранным вами продуктом.
- 3
Следите за заданием до завершения или получите webhook.
- 4
Скачайте один файл результатов со всеми исходными строками и одним столбцом ответов на каждый продукт.
Храните ключи на сервере
- До 10 Bearer API-ключей на аккаунт, каждый можно удалить в любой момент.
- Подписанный webhook отправляется, когда массовое задание завершается.
- Файлы результатов скачиваются по ссылке, действующей 10 минут.
Храните учётные данные в переменных окружения, а если ключ раскрыт, удалите его в панели. При обращении в поддержку указывайте ID проверки или задания; никогда не вставляйте API-ключи в скриншоты и публичные примеры.
Готовы проверить свои номера?
Начинайте сразу после регистрации, без одобрения. Пополните баланс и проверяйте реальные номера.