GET /api/v2/phone/mnp

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

Запрос

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

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

Заголовки:

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

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

  • cURL

    curl --request GET "https://uni-tools.net/api/v2/phone/mnp/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/mnp/$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/mnp/{phone_number}"
    headers = {
        "Api-Key": api_key
    }
    response = requests.get(url, headers=headers)
    print(response.text)
    

Ответ

Успех:

{
    "success": true,
    "result": {
        "phone": 79001234567,
        "type": "Мобильный",
        "region": "Ростовская область",
        "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 Не удалось найти информацию по указанному номеру
429 Too many requests Запросы поступают слишком часто
500 Internal Server Error Внутренняя ошибка сервера
503 Route under maintenance Маршрут временно недоступен (тех. работы)