GET /api/v2/phone/search

Метод позволяет определить оператора по российскому номеру городского или мобильного телефона.

Запрос

Стоимость запроса: 0.3 руб.

URL: https://uni-tools.net/api/v2/phone/search/{number}

Заголовки:

Параметр Тип Значение
Api-Key string YOUR_API_KEY

Примеры кода:

  • cURL

    curl --request GET "https://uni-tools.net/api/v2/phone/search/79001234567" \
    --header "Api-Key: YOUR_API_KEY"
    
  • PHP

    <?php
    $apiKey = "YOUR_API_KEY";
    $phoneNumber = 79001234567;
    $ch = curl_init("https://uni-tools.net/api/v2/phone/search/$phoneNumber");
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ["Api-Key: $apiKey"]
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    echo $response;
    
  • Python

    import requests
    
    api_key = "YOUR_API_KEY"
    phone_number = 79001234567
    url = f"https://uni-tools.net/api/v2/phone/search/{phone_number}"
    headers = {
        "Api-Key": api_key
    }
    response = requests.get(url, headers=headers)
    print(response.text)
    

Ответ

Успех:

{
    "success": true,
    "result": {
        "phone": 79001234567,
        "region": "Ростовская область",
        "district": "Южный федеральный округ",
        "operator": "Теле2"
    }
}

Неудача:

{
    "success": false,
    "error": {
        "code": 400,
        "message": "Invalid parameter: number"
    }
}

Ошибки

Код Сообщение Описание
400 Missing required parameter: number Номер телефона не был передан
400 Invalid parameter: number Передан некорректный номер телефона
401 Missing API key Отсутствует заголовок "Api-Key"
402 Insufficient balance Недостаточно средств для оплаты запроса
403 Invalid API key Указанный Api-Key недействителен
404 Result not found Не удалось найти информацию по указанному номеру
500 Internal Server Error Внутренняя ошибка сервера
503 Route under maintenance Маршрут временно недоступен (тех. работы)