## API URL
Adresa URL používaná na odosielanie HTTP požiadaviek:
```url
https://portal.bulkgate.com/api/1.0/integration/check-phone-numbers
```

> [!NOTE]
> Ak sa požiadavka nedostane k cieľu, zopakujte ju na [záložnom serveri](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/zalozny-server/) `backup1.bulkgate.com`.

```http
POST /api/1.0/integration/check-phone-numbers HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
```


### Tabuľka s parametrami

| NÁZOV PARAMETRA	  | HODNOTA                                                        | POVINNÝ | PREDVOLENÁ HODNOTA |
|:------------------|:---------------------------------------------------------------|:-------:|:---------------:|
| application_id    | [Aplikačný identifikátor](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/administracia-api/)         | **Áno** |        -        |
| application_token | [Aplikačný overovací token](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/api-tokeny/)	              | **Áno** |        -        |
| numbers           | Zoznam štruktúr čísel na kontrolu, pozri [Numbers](#numbers)  |   Nie   |        -        |

#### Numbers

| NÁZOV PARAMETRA	 | HODNOTA                                                                                                             | POVINNÝ | PREDVOLENÁ HODNOTA |
|:-----------------|:--------------------------------------------------------------------------------------------------------------------|:-------:|:---------------:|
| phone_number     | telefónne číslo                                                                                                     | **Áno** |        -        |
| country          | [Kód krajiny](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) telefónneho čísla |   Nie   |        -        |



**Príklad úplnej požiadavky:**
```http-json
POST /api/1.0/integration/check-phone-numbers HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
  "application_id": 451,
  "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
  "numbers": [
        {
            "phone_number": "420777777777",
            "country": "cz"
        },
        {
            "phone_number": "7777",
            "country": "cz"
        }
    ]
}
```


## Odpoveď na tento príkaz môže byť:

**V prípade úspechu**
```json
{
    "data": {
        "420777777777": {
            "phone_number": "420777777777",
            "valid": true,
            "country": "cz",
            "call_prefix": 420,
            "network_code": "23003",
            "network_name": "Vodafone"
        },
        "7777": {
            "phone_number": "7777",
            "valid": false,
            "country": null,
            "call_prefix": null,
            "network_code": null,
            "network_name": "unknown"
        }
    }
}
```