Typické chyby

Stránka vychází z rozložení stavových kódů na produkci za 30 dní. Kde něco neměříme, je to tak i napsáno.

Poznámka

Chybové kódy do logu požadavků nezapisujeme, jen HTTP stavy. Proto níže najdeš četnosti stavů, ale žádný žebříček kódů typu INVALID_FIELD. Vymýšlet jsme si ho nechtěli.

Chyby v cestě

Nejčastější 4xx v logu je 404 a téměř žádná z nich není tvoje: jde o skenery, které zkoušejí .env, .git/config, wordpress/, wp-content/…. Skutečné chyby v cestě u integrátorů jsou jiné a jsou už i s příklady popsané zde: Chybná volání, která vidíme nejčastěji. Stručně: /api/… místo /v1/…, zdvojené /v1/v1/…, /swagger.json místo /v1/openapi.json.

402: tarif endpoint nezahrnuje

385 odpovědí za 30 dní. Rozložení ukazuje, kde bezplatný tarif naráží nejčastěji:

Endpoint	402 za 30 dní
chart	114
transit-calendar	101
vedic/dashas/vimshottari/maha	48
ingresses	25
planetary-hours	24
vedic/panchang/full	24
eclipses	13

V těle odpovědi přijde current_plan a upgrade_to. Nejde o chybu požadavku: tělo je správné, klíč platný, jen tarif tento endpoint nezahrnuje.

429: dva různé limity

6 791 odpovědí za 30 dní, z toho 3 769 bez klíče a 3 022 s klíčem. Jde o dva různé mechanismy a neměly by se plést:

• bez klíče se limit počítá podle IP, 30 požadavků za hodinu. Největší blok v našem logu ani nejsou integrátoři, ale syntetický audit Chrome-Lighthouse z 15 adres;
• s klíčem je limitem RPM tvého tarifu. Odpověď obsahuje Retry-After v sekundách a právě tolik je třeba počkat, místo okamžitého opakování.

400: téměř vždy tělo požadavku na horoskop

700 odpovědí za 30 dní a soustřeďují se na endpointy, které přijímají datum, čas a souřadnice: chart (111), horoscope/daily (19), transits (18), synastry (15), rectification (15).

Nejdražší z těchto chyb ani není ta, která vrací 400, ale ta, která dříve vracela 200: zkrácené názvy polí. Pravidla a ukázka odpovědi: Formáty polí.

401 a 403

401 znamená chybějící nebo neplatný klíč; hláška jmenuje obě třídy, aw_ i pk_. 403 se týká původu (origin): prohlížečový klíč pk_ se odmítne, pokud požadavek přišel bez originu nebo z cizí domény, a klíč omezený na určité endpointy odpoví ENDPOINT_NOT_IN_SCOPE a v details vypíše svůj seznam.

Kompletní tabulka kódů: Chyby.