# carrierLookup | Определение мобильного оператора

## Использование этого метода

<mark style="color:blue;">`GET`</mark> `https://api.meowsms.app/carrierLookup/`

#### Headers

| Name                                            | Type           | Description  |
| ----------------------------------------------- | -------------- | ------------ |
| Authorization<mark style="color:red;">\*</mark> | Bearer API key | Ваш API ключ |

#### Request Body

| Name                                     | Type        | Description    |
| ---------------------------------------- | ----------- | -------------- |
| number<mark style="color:red;">\*</mark> | 34987654321 | Номер телефона |

{% tabs %}
{% tab title="Успешно/Success" %}

```json
{
    "result": true,
    "country": "Испания",
    "carrier": "Orange"
}
```

{% endtab %}

{% tab title="Ошибка/Error" %}

```json
{
    "result": false,
    "error": "Error description in English",
    "error_ru": "Описание ошибки на русском"
}
```

{% endtab %}
{% endtabs %}

## 🕹 Примеры использования

{% tabs %}
{% tab title="🐘 PHP" %}
🇬🇧 **To work**, you need to **install the** `Guzzle` **library** (`composer require guzzlehttp/guzzle`, <https://packagist.org/packages/guzzlehttp/guzzle>)

🇷🇺 **Для работы**, вам нужно **установить библиотеку** `Guzzle` (`composer require guzzlehttp/guzzle`, <https://packagist.org/packages/guzzlehttp/guzzle>)

```php
<?php

$http_method = "GET";
$api_url = "https://api.meowsms.app/";
$api_method = "carrierLookup/";
$api_key = "";
$body = ["number" => 34987654321];

require_once "vendor/autoload.php";

$client = new GuzzleHttp\Client([
    "http_errors" => false,
    "timeout" => 5,
    "connect_timeout" => 5,
    "headers" => ["Authorization" => "Bearer " . $api_key]
]);

echo "[" . date("d.m.Y H:i:s") . "] API URL: " . $api_url . $api_method . PHP_EOL;
echo "[" . date("d.m.Y H:i:s") . "] HTTP Method Request: " . $http_method . PHP_EOL;
echo "[" . date("d.m.Y H:i:s") . "] HTTP Body Request: " . json_encode($body) . PHP_EOL;

try {
    $request = $client->request($http_method, $api_url . $api_method, ["json" => $body]);
} catch(Exception $e){
    echo "[" . date("d.m.Y H:i:s") . "] Error: " . $e->getMessage() . PHP_EOL;
    exit();
}

echo "[" . date("d.m.Y H:i:s") . "] Status Code: " . $request->getStatusCode() . PHP_EOL;
echo "[" . date("d.m.Y H:i:s") . "] Response: " . $request->getBody()->getContents() . PHP_EOL;
```

{% endtab %}

{% tab title="🫗 Node.JS" %}
🇬🇧 **To work**, you need to **install the** `axios` **library** (`npm i axios`, <https://www.npmjs.com/package/axios>)

🇷🇺 **Для работы**, вам нужно **установить библиотеку** `axios` (`npm i axios`, <https://www.npmjs.com/package/axios>)

```javascript
const axios = require('axios');

const http_method = "GET";
const api_url = "https://api.meowsms.app/";
const api_method = "carrierLookup/";
const api_key = "";
const body = {"number": 34987654321};
const headers = {"Authorization": "Bearer " + api_key};

console.log("[" + new Date().toLocaleString() + "] API URL: " + api_url + api_method);
console.log("[" + new Date().toLocaleString() + "] HTTP Method Request: " + http_method);
console.log("[" + new Date().toLocaleString() + "] HTTP Body Request: " + JSON.stringify(body));

axios({
    method: http_method,
    url: api_url + api_method,
    headers: headers,
    data: body
})
    .then(response => {
        console.log("[" + new Date().toLocaleString() + "] Status Code: " + response.status);
        console.log("[" + new Date().toLocaleString() + "] Response: " + response.data);
    })
    .catch(error => {
        console.log("[" + new Date().toLocaleString() + "] Error: " + error.message);
        console.log("[" + new Date().toLocaleString() + "] Response: " + error.response.data);
    });
```

{% endtab %}

{% tab title="🐍 Python" %}
🇬🇧 **To work**, you need to **install the** `requests` **library** (`pip install requests`, <https://pypi.org/project/requests/>)

🇷🇺 **Для работы**, вам нужно **установить библиотеку** `requests` (`pip install requests`, <https://pypi.org/project/requests/>)

```python
import requests
import json
from datetime import datetime

http_method = "GET"
api_url = "https://api.meowsms.app/"
api_method = "carrierLookup/"
api_key = ""
body = {"number": 34987654321}

headers = {"Authorization": "Bearer " + api_key}

print("[" + str(datetime.now()) + "] API URL: " + api_url + api_method)
print("[" + str(datetime.now()) + "] HTTP Method Request: " + http_method)
print("[" + str(datetime.now()) + "] HTTP Body Request: " + json.dumps(body))

try:
    response = requests.request(http_method, api_url + api_method, headers=headers, json=body)
    response.raise_for_status()
    print("[" + str(datetime.now()) + "] Status Code: " + str(response.status_code))
    print("[" + str(datetime.now()) + "] Response: " + response.text)
except requests.exceptions.RequestException as e:
    print("[" + str(datetime.now()) + "] Error: " + str(e))
```

{% endtab %}
{% endtabs %}

## 👉 Следующий метод

{% content-ref url="hlrlookup-or-proverka-statusa-mobilnogo-nomera" %}
[hlrlookup-or-proverka-statusa-mobilnogo-nomera](https://docs.meowsms.app/rabota-s-nomerom/hlrlookup-or-proverka-statusa-mobilnogo-nomera)
{% endcontent-ref %}