# 一般的なエラー

このページは本番環境での30日間のステータス分布で構成されています。測定していない箇所はそのまま記載されています。

<Aside type="note">
エラ―コードは**記録**しません、リクエストログにはHTTPステータスだけを書きます。そのため以下にステータス頻度はありますが、`INVALID_FIELD` のようなコードのランキングはありません。作り出すことはしませんでした。
</Aside>

## パスエラー

ログで最も多い4xxは `404` で、ほぼすべてはあなたのものではありません：`.env`、`.git/config`、`wordpress/`、`wp-content/…` を走査するスキャナーです。統合者の本当のパスエラーは別で、すでに例とともにここで説明しています: [よく見る誤った呼び出し](/api-conventions/#помилкові-виклики-які-ми-бачимо-найчастіше)。要点は：`/api/…` を `/v1/…` の代わりに、二重の `/v1/v1/…`、`/swagger.json` を `/v1/openapi.json` の代わりに使用していることです。

## `402`: プランにエンドポイントが含まれていない

30日間で385件のレスポンスがあります。分布は無料プランが最も頻繁にどこでブロックされるかを示しています：

| エンドポイント | `402` 30日間で |
|---|---|
| `chart` | 114 |
| `transit-calendar` | 101 |
| `vedic/dashas/vimshottari/maha` | 48 |
| `ingresses` | 25 |
| `planetary-hours` | 24 |
| `vedic/panchang/full` | 24 |
| `eclipses` | 13 |

レスポンスボディには `current_plan` と `upgrade_to` が含まれます。これはリクエストエラーではなく、ボディは正しく、キーも有効ですが、プランにこのエンドポイントが含まれていないだけです。

## `429`: 2つの異なるレートリミット

30日間で6 791件のレスポンスがあり、そのうち3 769件はキーなし、3 022件はキーありです。これは2つの異なるメカニズムで、混同しないでください：

- **キーなし** リミットはIP単位で計算され、1時間あたり30リクエストです。私たちのログで最大のブロックは統合者ではなく、15アドレスからのChrome-Lighthouseの合成監査です；
- **キーあり** リミットはプランのRPMです。レスポンスには秒単位の `Retry-After` が含まれており、すぐにリトライせずにそれを待つ必要があります。

## `400`: ほぼ常にリクエストボディが原因

30日間で700件のレスポンスがあり、日付、時刻、座標を受け取るエンドポイントに集中しています：`chart` (111)、`horoscope/daily` (19)、`transits` (18)、`synastry` (15)、`rectification` (15)。

この種の最も高価なエラーは `400` を返すものではなく、かつて `200` を返したものです：フィールドの短縮記述です。ルールとレスポンス例は [フィールドフォーマット](/agent-setup/field-formats/) を参照してください。

## `401` と `403`

`401` はキーが欠如または無効です；メッセージは両方のクラス `aw_` と `pk_` を示します。`403` はオリジンに関するものです：ブラウザキー `pk_` はオリジンがない、または別ドメインからのリクエストの場合に拒否され、エンドポイント領域のキーは `ENDPOINT_NOT_IN_SCOPE` に該当し、`details` にリストが列挙されます。

完全なコード表は: [エラー](/errors/).
