## Na čo slúži obmedzenie na IP adresy

Kým je zoznam povolených adries prázdny, prijíma API požiadavky odkiaľkoľvek —
portál to oznamuje textom `API je dostupné z ľubovoľnej IP adresy`. Hneď ako do
zoznamu pridáte prvú adresu, začne API obsluhovať len požiadavky prichádzajúce
z uvedených adries.

Prístupové údaje tým nijako nezaniknú. [Application ID](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/administracia-api/)
aj [API token](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/api-tokeny/) platia ďalej, len ich nemožno použiť odinakiaľ ako
z povolenej adresy.

## Kde obmedzenie nastavím

1. V menu portálu kliknite na `Moduly a API`
2. V časti `Moje API a Moduly` kliknite na kartu svojej aplikácie
3. Zostaňte na karte `Nastavenie` a posuňte sa nadol do časti `Obmedzenie prístupu k API`
4. Pri dlaždici `Povolené IP adresy` kliknite na `Konfigurovať`
5. Do poľa `Zadajte IP adresu` vpíšte adresu a kliknite na `Pridať`

![Časť Obmedzenie prístupu k API s dlaždicou Povolené IP adresy](docs:api-ip-restrictions/allowed-ip_cs)

Okno `Pridať IP adresu` na to rovno upozorňuje hláškou `API bude dostupné iba
z uvedených IP adries!` — obmedzenie je aktívne od uloženia prvej adresy.

> [!WARNING]
> Zadajte adresu, z ktorej API volá vaša aplikácia, nie adresu počítača, na
> ktorom nastavenie robíte. Portál po uložení neoveruje, či sa z uvedenej
> adresy niekto naozaj pripojí.

## Aké adresy portál prijme

| Pravidlo | Správanie |
|:--|:--|
| Jedna konkrétna adresa | IPv4 aj IPv6; rozsahy ani zápis s maskou (`/24`) portál neprijme |
| Len verejné adresy | Lokálne a rezervované rozsahy skončia hláškou `Zadajte verejnú IP adresu, lokálne a rezervované rozsahy nie je možné použiť` |
| Platný zápis | Nezmyselná hodnota skončí hláškou `Neplatná IP adresa` |
| Bez duplicít | Adresu, ktorá už v zozname je, druhýkrát nepridáte |

Medzi neverejné rozsahy patria aj `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`,
`127.0.0.0/8` a pri IPv6 `fc00::/7` alebo `fe80::/10`. Tlačidlo `Pridať` zostáva
nedostupné, kým zadaná hodnota nevyhovie.

Adresu zapísanú ako IPv4 vnorenú do IPv6 — teda `::ffff:1.2.3.4` alebo 6to4
tvar `2002:…` — portál prevedie na zodpovedajúcu IPv4. Počet adries v zozname
nie je obmedzený.

## Ako zoznam upravím alebo obmedzenie zruším

Po pridaní prvej adresy sa z dlaždice stane zoznam. Tlačidlom `Pridať` doplníte
ďalšiu adresu, ikona koša pri riadku jednu odoberie — zmazanie potvrdíte tlačidlom
`Zmazať`. Šípka vedľa `Pridať` rozbalí ponuku, ktorou zmažete celý zoznam
naraz.

Hneď ako v zozname nezostane žiadna adresa, obmedzenie sa vypne a API je znova
dostupné odkiaľkoľvek.

## Čo sa stane s požiadavkou z inej adresy

Požiadavka z adresy, ktorá v zozname nie je, skončí odpoveďou s HTTP kódom `401`
a typom chyby `unknown_identity` — rovnakou, akú vracia neplatný token. Prehľad
ostatných chýb nájdete na stránke [Typy chýb API](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/typy-chyb-api/).