📚 API Документация
Инструкции по использованию API для поиска оператора и проверки номеров на спам. Все примеры доступны на русском и английском языках.
Эндпоинт: GET /v2/operator
Описание: Определяет текущего оператора связи по номеру телефона. Проверяет таблицы MNP и DEF параллельно. Если номер найден в MNP - возвращает оператора из MNP, иначе из DEF.
Параметры:
num- номер телефона в любом формате (обязательный)token- API токен (обязательный, можно передать через заголовок X-API-Key)
Пример запроса (cURL):
curl -X GET "https://num-api.jlnem.ru/v2/operator?num=79991234567" \
-H "X-API-Key: ваш_токен"
Эндпоинт: POST /v2/bulk
Описание: Массовый поиск оператора для списка номеров. Максимум 100 номеров за запрос. Обрабатывается параллельно батчами по 25 номеров.
Параметры:
numbers- массив номеров (обязательный, JSON body)token- API токен (обязательный, можно передать через заголовок X-API-Key)
Пример запроса (cURL):
curl -X POST "https://num-api.jlnem.ru/v2/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: ваш_токен" \
-d '{
"numbers": [
"79991234567",
"+7 921 123-45-67",
"8 (999) 555-44-33"
]
}'
Endpoint: GET /v2/operator
Description: Determines the current mobile operator for a phone number. Checks MNP and DEF tables in parallel. If the number is found in MNP - returns operator from MNP, otherwise from DEF.
Parameters:
num- phone number in any format (required)token- API token (required, can be passed via X-API-Key header)
Example Request (cURL):
curl -X GET "https://num-api.jlnem.ru/v2/operator?num=79991234567" \
-H "X-API-Key: your_token"
Endpoint: POST /v2/bulk
Description: Bulk operator lookup for a list of phone numbers. Maximum 100 numbers per request. Processed in parallel batches of 25 numbers.
Parameters:
numbers- array of phone numbers (required, JSON body)token- API token (required, can be passed via X-API-Key header)
Example Request (cURL):
curl -X POST "https://num-api.jlnem.ru/v2/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: your_token" \
-d '{
"numbers": [
"79991234567",
"+7 921 123-45-67",
"8 (999) 555-44-33"
]
}'
Эндпоинт: GET /v2/yandex-spam-check
Описание: Проверка одного номера на наличие в спам-базе Яндекс Caller ID. Работает для любых номеров, независимо от наличия в базе DEF/MNP.
Параметры:
num- номер телефона в любом формате (обязательный)token- API токен (обязательный, можно передать через заголовок X-API-Key)
Пример запроса (cURL):
curl -X GET "https://num-api.jlnem.ru/v2/yandex-spam-check?num=79991234567" \
-H "X-API-Key: ваш_токен"
Эндпоинт: POST /v2/yandex-spam-check/bulk
Описание: Массовая проверка номеров на наличие в спам-базе Яндекс Caller ID. До 7500 номеров за запрос (75 потоков × 100 номеров). Каждый поток обрабатывает свой батч параллельно.
Параметры:
numbers- массив номеров (обязательный, JSON body, до 7500 номеров)token- API токен (обязательный, можно передать через заголовок X-API-Key)
Пример запроса (cURL):
curl -X POST "https://num-api.jlnem.ru/v2/yandex-spam-check/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: ваш_токен" \
-d '{
"numbers": [
"79991234567",
"+7 921 123-45-67",
"8 (999) 555-44-33"
]
}'
Эндпоинт: GET /v2/tbank-check
Описание: Проверка одного номера на наличие в базе T-Bank Who-Called. Работает для любых номеров, независимо от наличия в базе DEF/MNP.
Параметры:
num- номер телефона в любом формате (обязательный)token- API токен (обязательный, можно передать через заголовок X-API-Key)
Пример запроса (cURL):
curl -X GET "https://num-api.jlnem.ru/v2/tbank-check?num=79991234567" \
-H "X-API-Key: ваш_токен"
Эндпоинт: POST /v2/tbank-check/bulk
Описание: Массовая проверка номеров через T-Bank Who-Called. До 100 номеров за запрос. Обрабатывается параллельно батчами по 25 номеров.
Параметры:
numbers- массив номеров (обязательный, JSON body, до 100 номеров)token- API токен (обязательный, можно передать через заголовок X-API-Key)
Пример запроса (cURL):
curl -X POST "https://num-api.jlnem.ru/v2/tbank-check/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: ваш_токен" \
-d '{
"numbers": [
"79991234567",
"+7 921 123-45-67",
"8 (999) 555-44-33"
]
}'
Endpoint: GET /v2/yandex-spam-check
Description: Check a single phone number in Yandex Caller ID spam database. Works for any numbers, regardless of presence in DEF/MNP database.
Parameters:
num- phone number in any format (required)token- API token (required, can be passed via X-API-Key header)
Example Request (cURL):
curl -X GET "https://num-api.jlnem.ru/v2/yandex-spam-check?num=79991234567" \
-H "X-API-Key: your_token"
Endpoint: POST /v2/yandex-spam-check/bulk
Description: Bulk check phone numbers in Yandex Caller ID spam database. Up to 7500 numbers per request (75 threads × 100 numbers). Each thread processes its batch in parallel.
Parameters:
numbers- array of phone numbers (required, JSON body, up to 7500 numbers)token- API token (required, can be passed via X-API-Key header)
Example Request (cURL):
curl -X POST "https://num-api.jlnem.ru/v2/yandex-spam-check/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: your_token" \
-d '{
"numbers": [
"79991234567",
"+7 921 123-45-67",
"8 (999) 555-44-33"
]
}'
Endpoint: GET /v2/tbank-check
Description: Check a single phone number in T-Bank Who-Called database. Works for any numbers, regardless of presence in DEF/MNP database.
Parameters:
num- phone number in any format (required)token- API token (required, can be passed via X-API-Key header)
Example Request (cURL):
curl -X GET "https://num-api.jlnem.ru/v2/tbank-check?num=79991234567" \
-H "X-API-Key: your_token"
Endpoint: POST /v2/tbank-check/bulk
Description: Bulk check phone numbers through T-Bank Who-Called. Up to 100 numbers per request. Processed in parallel batches of 25 numbers.
Parameters:
numbers- array of phone numbers (required, JSON body, up to 100 numbers)token- API token (required, can be passed via X-API-Key header)
Example Request (cURL):
curl -X POST "https://num-api.jlnem.ru/v2/tbank-check/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: your_token" \
-d '{
"numbers": [
"79991234567",
"+7 921 123-45-67",
"8 (999) 555-44-33"
]
}'
Для получения API токена обратитесь к администратору или войдите в админ-панель.