# Gyakori hibák

Oldal összeállítva a 30 napos időszakban a hibák elosztása alapján. Ahol nem mérhető, ott is így van megfogalmazva.

<Aside type="note">
A hibakódokat nem írjuk a kérések naplójába, csak a HTTP-állapotokat. Ezért a következőben a hibák gyakorisága van, de nincs hibakódokat tartalmazó listája, mint például `INVALID_FIELD`. Nem találtuk ki.
</Aside>

## Út hiányzó hibák

A 4xx-es hibák leggyakoribbja a `404`, és ezek nagy része nem a mi hibánk: ezek a keresők, amelyek a `.env`, `.git/config`, `wordpress/`, `wp-content/…`-t keresik. A valódi úthibák a integrátorokban vannak, és azokat már leírtuk példákkal itt: [A leggyakoribb hibák, amelyeket látunk](/api-conventions/#a-leggyakoribb-hibák-amelyeket-látunk). Röviden: `/api/…` helyett `/v1/…`, duplikált `/v1/v1/…`, `/swagger.json` helyett `/v1/openapi.json`.

## `402`: a tarif nem tartalmazza az endpointet

385 válasz a 30 napos időszakban. A gyakoriság elosztása mutatja, hogy hol fordul elő a leggyakoribb hibák:

| Végpont | `402` 30 nap alatt |
|---|---|
| `chart` | 114 |
| `transit-kalendárium` | 101 |
| `vedic/dashas/vimshottari/maha` | 48 |
| `bejáratok` | 25 |
| `bolygóórák` | 24 |
| `vedic/panchang/ teljes` | 24 |
| `fogyatkozások` | 13 |

A válaszban a `current_plan` és `upgrade_to` érkezik. Ez nem hibás kérés: a testben a kulcs helyes, de a tarif nem tartalmazza ezt az endpointet.

## `429`: két külön határolt

6 791 válasz a 30 napos időszakban, ebből 3 769 nincs kulccsal és 3 022 van kulccsal. Ez két külön mechanizmus, és nem keverjük őket:

- **nincs kulccsal** határolt: az IP-értékesítés alapján 30 kérés óra alatt. A legnagyobb blokkunk nem az integrátorok, hanem a szintetikus Chrome-Lighthouse audit 15 címmel;
- **van kulccsal** határolt: ez az RPM-tartalékod. A válaszban van `Retry-After` másodpercben, és ezt kell várni, nem pedig azonnal visszalépni.

## `400`: majdnem mindig a kártya kérésének testje

700 válasz a 30 napos időszakban, és ezek azok az endpointekre összpontosulnak, amelyek elfogadják a dátumot, időt és koordinátákat: `chart` (111), `horoscope/daily` (19), `transits` (18), `synastry` (15), `rectification` (15).

A legdrágább ilyen hibák közül még nem az, amely `400`-t ad, hanem az, amely egyszer `200`-t adott: a rövid írásokat tartalmazó mezők. A szabályok és példák itt: [Mezőformátumok](/agent-setup/field-formats/).

## `401` és `403`

`401` hiányzó vagy hibás kulcs; a hibás üzenet két osztályt említi, `aw_` és `pk_`. `403` hiányzás: a böngészői kulcs `pk_` elutasítja, ha a kérés nincs eredetben vagy a külföldi doménból érkezik, és a kulcs az eredeti végpontokban `ENDPOINT_NOT_IN_SCOPE`-t adja vissza és a saját listáját tartalmazza `details`-ben.

A teljes kódok listája: [Hibák](/errors/).
