## K čemu omezení na IP adresy slouží

Dokud je seznam povolených adres prázdný, přijímá API požadavky odkudkoli —
portál to hlásí textem `API je dostupné z libovolné IP adresy`. Jakmile do
seznamu přidáte první adresu, začne API obsluhovat jen požadavky přicházející
z uvedených adres.

Přístupové údaje tím nijak nezaniknou. [Application ID](https://www.bulkgate.com/cs/dokumentace/api-administrace-a-tokeny/administrace-api/)
i [API token](https://www.bulkgate.com/cs/dokumentace/api-administrace-a-tokeny/api-tokeny/) platí dál, jen je nelze použít odjinud než
z povolené adresy.

## Kde omezení nastavím

1. V menu portálu klikněte na `Moduly a API`
2. V části `Moje API a Moduly` klikněte na kartu své aplikace
3. Zůstaňte na kartě `Nastavení` a sjeďte do části `Omezení přístupu k API`
4. U dlaždice `Povolené IP adresy` klikněte na `Konfigurovat`
5. Do pole `Zadejte IP adresu` vepište adresu a klikněte na `Přidat`

![Část Omezení přístupu k API s dlaždicí Povolené IP adresy](docs:api-ip-restrictions/allowed-ip_cs)

Okno `Přidat IP adresu` na to rovnou upozorňuje hláškou `API bude dostupné pouze
z uvedených IP adres!` — omezení je aktivní od uložení první adresy.

> [!WARNING]
> Zadejte adresu, ze které na API volá vaše aplikace, ne adresu počítače, na
> kterém nastavení provádíte. Portál po uložení neověřuje, jestli se z uvedené
> adresy někdo skutečně připojí.

## Jaké adresy portál přijme

| Pravidlo | Chování |
|:--|:--|
| Jedna konkrétní adresa | IPv4 i IPv6; rozsahy ani zápis s maskou (`/24`) portál nepřijme |
| Jen veřejné adresy | Lokální a rezervované rozsahy skončí hláškou `Zadejte veřejnou IP adresu, lokální a rezervované rozsahy nelze použít` |
| Platný zápis | Nesmyslná hodnota skončí hláškou `Neplatná IP adresa` |
| Bez duplicit | Adresu, která už v seznamu je, podruhé nepřidáte |

Mezi neveřejné rozsahy patří i `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`,
`127.0.0.0/8` a u IPv6 `fc00::/7` nebo `fe80::/10`. Tlačítko `Přidat` zůstává
nedostupné, dokud zadaná hodnota nevyhoví.

Adresu zapsanou jako IPv4 vnořenou do IPv6 — tedy `::ffff:1.2.3.4` nebo 6to4
tvar `2002:…` — portál převede na odpovídající IPv4. Počet adres v seznamu
omezený není.

## Jak seznam upravím nebo omezení zruším

Po přidání první adresy se z dlaždice stane seznam. Tlačítkem `Přidat` doplníte
další adresu, ikona koše u řádku jednu odebere — smazání potvrdíte tlačítkem
`Smazat`. Šipka vedle `Přidat` rozbalí nabídku, kterou smažete celý seznam
najednou.

Jakmile v seznamu nezůstane žádná adresa, omezení se vypne a API je znovu
dostupné odkudkoli.

## Co se stane s požadavkem z jiné adresy

Požadavek z adresy, která v seznamu není, skončí odpovědí s HTTP kódem `401`
a typem chyby `unknown_identity` — stejnou, jakou vrací neplatný token. Přehled
ostatních chyb najdete na stránce [Typy errorů API](https://www.bulkgate.com/cs/dokumentace/api-administrace-a-tokeny/typy-chyb-api/).