Klíče, limity a náklady

Každá placená služba potřebuje vědět, kdo se ptá. K tomu slouží API klíč – dlouhý náhodný řetězec, který funguje jako heslo.

Pravidla pro klíče

1. Nikdy v kódu

   Ani „dočasně, než to zprovozním“. Dočasné klíče v kódu končí v Gitu.

2. Vždy v proměnné prostředí

   Lokálně v .env.local, naostro v nastavení hostingu.

3. Nikdy v prohlížeči

   Cokoliv, co se dostane do prohlížeče, si může kdokoliv přečíst. Klíče žijí na serveru.

4. Různé klíče pro test a ostrý provoz

   Většina služeb je rozlišuje. Testovací klíč nesmí umět utratit peníze.

5. Otočit klíč, když je podezření

   Objevil se ve screenshotu? V commitu? V logu? Zruš ho a vygeneruj nový.

Zkontroluj mi v projektu práci s API klíči a tajnými hodnotami.

1. Je někde v kódu natvrdo zapsaný klíč, token nebo heslo?
2. Dostane se nějaká tajná hodnota do prohlížeče – například přes
 proměnnou s veřejnou předponou?
3. Je v .gitignore všechno, co obsahuje skutečné hodnoty?
4. Obsahuje .env.example všechny proměnné, které projekt potřebuje –
 ale bez hodnot?
5. Objevuje se nějaký klíč v logu nebo v chybové hlášce?

U každého nálezu napiš, jak je to vážné a co s tím.

Bod 5 je zákeřný. Když se při chybě vypíše celý požadavek včetně hlaviček, klíč skončí v logu – a log může vidět víc lidí, než čekáš.

Limity

Cizí služby omezují, kolik dotazů smíš poslat. Typicky „sto požadavků za minutu“.

Když limit překročíš, dostaneš odpověď s kódem 429. To není chyba tvé aplikace – je to pokyn „zpomal“.

1. Počkej a zkus znovu

   Ne hned. Chvíli počkat, pak zkusit, při dalším neúspěchu počkat déle. Prodlužující se čekání je standardní řešení.

2. Nezkoušej donekonečna

   Tři až pět pokusů. Pak to vzdej a řekni uživateli, co se děje.

3. Nevolej zbytečně

   Když se odpověď nemění každou vteřinu, ulož si ji a chvíli používej uloženou.

Naše aplikace volá [SLUŽBA]. Chci to ošetřit proti limitům a výpadkům.

Zařiď:
1. Při odpovědi 429 počkat a zkusit znovu, s prodlužujícím se čekáním.
 Maximálně 4 pokusy.
2. Při chybě serveru (5xx) totéž.
3. Při chybě klienta (4xx kromě 429) nezkoušet znovu – to se opakováním
 nespraví.
4. Po vyčerpání pokusů srozumitelnou hlášku pro uživatele v češtině,
 ne technickou chybu.
5. Zapsat do logu, co se stalo, ale bez klíče.

Vysvětli mi, co se stane z pohledu uživatele v každém z těch případů.

Náklady

Ceník bývá „za požadavek“ nebo „za objem“. Nebezpečné je, že tvoje aplikace může udělat víc požadavků, než čekáš – kvůli chybě, kvůli opakování ve smyčce nebo kvůli tomu, že ji někdo zneužije.

1. Nastav si upozornění na útratu

   Většina služeb to umí. Nastav to dřív, než něco spustíš.

2. Nastav strop, když to jde

   Tvrdý limit, po kterém se to zastaví, je lepší než překvapení.

3. Ukládej opakované odpovědi

   Když se ptáš na to samé stokrát denně, ptej se jednou.

4. Omez, kolik smí jeden uživatel

   Bez toho může jeden člověk (nebo robot) vyčerpat tvůj rozpočet.