# Những lỗi phổ biến

Trang này được tổng hợp từ phân bổ trạng thái trên môi trường sản xuất trong 30 ngày. Những chỗ chúng tôi không đo lường thì sẽ ghi rõ.

<Aside type="note">
Chúng tôi **không** ghi mã lỗi vào nhật ký yêu cầu, chỉ ghi trạng thái HTTP. Do đó, bên dưới có tần suất trạng thái, nhưng không có xếp hạng mã lỗi như `INVALID_FIELD`. Chúng tôi không tự ý tạo ra nó.
</Aside>

## Lỗi đường dẫn

Các lỗi 4xx phổ biến nhất trong nhật ký là `404`, và hầu hết chúng không phải do bạn: đó là các trình quét đang cố gắng truy cập `.env`, `.git/config`, `wordpress/`, `wp-content/…`. Các lỗi đường dẫn thực sự của các nhà tích hợp khác, và chúng đã được mô tả với các ví dụ tại đây: [Các cuộc gọi sai mà chúng tôi thường thấy nhất](/api-conventions/#помилкові-виклики-які-ми-бачимо-найчастіше). Tóm tắt: `/api/…` thay vì `/v1/…`, `/v1/v1/…` bị trùng lặp, `/swagger.json` thay vì `/v1/openapi.json`.

## `402`: gói cước không bao gồm endpoint

385 phản hồi trong 30 ngày. Phân bổ cho thấy gói miễn phí thường gặp giới hạn ở đâu nhất:

| Endpoint | `402` trong 30 ngày |
|---|---|
| `chart` | 114 |
| `transit-calendar` | 101 |
| `vedic/dashas/vimshottari/maha` | 48 |
| `ingresses` | 25 |
| `planetary-hours` | 24 |
| `vedic/panchang/full` | 24 |
| `eclipses` | 13 |

Trong phần thân phản hồi, bạn sẽ nhận được `current_plan` và `upgrade_to`. Đây không phải là lỗi yêu cầu: phần thân đúng, khóa hợp lệ, chỉ là gói cước không bao gồm endpoint này.

## `429`: hai giới hạn khác nhau

6.791 phản hồi trong 30 ngày, trong đó 3.769 không có khóa và 3.022 có khóa. Đây là hai cơ chế khác nhau, và không nên nhầm lẫn chúng:

- **không có khóa** giới hạn được tính theo IP, 30 yêu cầu mỗi giờ. Khối lớn nhất trong nhật ký của chúng tôi thậm chí không phải là các nhà tích hợp, mà là kiểm toán tổng hợp của Chrome-Lighthouse từ 15 địa chỉ;
- **có khóa** giới hạn là RPM của gói cước của bạn. Trong phản hồi có `Retry-After` tính bằng giây, và bạn phải đợi khoảng thời gian đó, chứ không phải thử lại ngay lập tức.

## `400`: hầu như luôn là phần thân của yêu cầu biểu đồ

700 phản hồi trong 30 ngày, và chúng tập trung vào các endpoint chấp nhận ngày, giờ và tọa độ: `chart` (111), `horoscope/daily` (19), `transits` (18), `synastry` (15), `rectification` (15).

Lỗi đắt nhất trong số này thậm chí không phải là lỗi trả về `400`, mà là lỗi đã từng trả về `200`: cách viết tắt các trường. Quy tắc và ví dụ phản hồi: [Định dạng trường](/agent-setup/field-formats/).

## `401` và `403`

`401` là khóa bị thiếu hoặc không hợp lệ; thông báo đề cập đến cả hai loại, `aw_` và `pk_`. `403` là do nguồn gốc: khóa trình duyệt `pk_` bị từ chối nếu yêu cầu đến mà không có nguồn gốc hoặc từ một miền khác, và khóa với phạm vi endpoint tương ứng với `ENDPOINT_NOT_IN_SCOPE` và liệt kê danh sách của nó trong `details`.

Bảng mã đầy đủ: [Lỗi](/errors/).
