# Typische Fehler

Die Seite besteht aus einer Aufschlüsselung der Statusverteilungen in Produktion über 30 Tage. Dort, wo wir etwas nicht messen, steht es einfach so.

<Aside type="note">
Fehlercodes **schreiben** wir nicht ins Anfragen‑Log, nur HTTP‑Status. Deshalb gibt es unten die Häufigkeiten der Status, aber kein Ranking von Codes wie `INVALID_FIELD`. Wir haben uns nicht ausgedacht.
</Aside>

## Pfadfehler

Die häufigsten 4xx im Log sind `404`, und fast alle sind nicht deine: das sind Scanner, die `.env`, `.git/config`, `wordpress/`, `wp-content/…` durchforsten. Die echten Pfadfehler bei Integratoren sind andere und bereits mit Beispielen hier beschrieben: [Fehlerhafte Aufrufe, die wir am häufigsten sehen](/api-conventions/#помилкові-виклики-які-ми-бачимо-найчастіше). Kurz: `/api/…` statt `/v1/…`, doppeltes `/v1/v1/…`, `/swagger.json` statt `/v1/openapi.json`.

## `402`: Tarif beinhaltet den Endpunkt nicht

385 Antworten in 30 Tagen. Die Aufschlüsselung zeigt, wo das kostenlose Tarif am häufigsten anstößt:

| Endpunkt | `402` in 30 Tagen |
|---|---|
| `chart` | 114 |
| `transit-calendar` | 101 |
| `vedic/dashas/vimshottari/maha` | 48 |
| `ingresses` | 25 |
| `planetary-hours` | 24 |
| `vedic/panchang/full` | 24 |
| `eclipses` | 13 |

Im Antwort‑Body kommen `current_plan` und `upgrade_to`. Das ist kein Anfragefehler: Der Body ist korrekt, der Schlüssel gültig, einfach beinhaltet das Tarif diesen Endpunkt nicht.

## `429`: zwei verschiedene Limits

6 791 Antworten in 30 Tagen, davon 3 769 ohne Schlüssel und 3 022 mit Schlüssel. Das sind zwei verschiedene Mechanismen, und du solltest sie nicht verwechseln:

- **ohne Schlüssel** wird das Limit pro IP gezählt, 30 Anfragen pro Stunde. Der größte Block in unserem Log sind nicht einmal Integratoren, sondern ein synthetischer Chrome‑Lighthouse‑Audit von 15 Adressen;
- **mit Schlüssel** ist das Limit das RPM deines Tarifs. In der Antwort gibt es `Retry-After` in Sekunden, und genau das musst du abwarten, anstatt sofort einen Retry zu starten.

## `400`: fast immer der Body der Kartenanfrage

700 Antworten in 30 Tagen, und sie konzentrieren sich auf Endpunkte, die Datum, Zeit und Koordinaten akzeptieren: `chart` (111), `horoscope/daily` (19), `transits` (18), `synastry` (15), `rectification` (15).

Der teuerste dieser Fehler ist nicht einmal der, der `400` zurückgibt, sondern der, der einst `200` gab: verkürzte Feldschreibweisen. Regeln und ein Beispiel der Antwort: [Feldformate](/agent-setup/field-formats/).

## `401` und `403`

`401` bedeutet ein fehlender oder falscher Schlüssel; die Meldung nennt beide Klassen, `aw_` und `pk_`. `403` bezieht sich auf die Herkunft: ein Browser‑Schlüssel `pk_` wird abgelehnt, wenn die Anfrage ohne Herkunft oder von einer fremden Domain kommt, und ein Schlüssel mit Endpunkt‑Bereich entspricht `ENDPOINT_NOT_IN_SCOPE` und listet sein Array in `details` auf.

Vollständige Codetabelle: [Fehler](/errors/).
