# Nhiệm vụ cho tác nhân

Trang này được viết dựa trên log bán trong 30 ngày, không phải từ trí tưởng tượng. Dưới đây là những cuộc gọi mà các tích hợp thực sự thực hiện với khóa, theo thứ tự tần suất.

## Những gì được gọi thường xuyên nhất

| Endpoint | Số lần gọi thành công trong 30 ngày | Mục đích |
|---|---|---|
| `POST /v1/human-design` | 12 563 | biodigraph: loại, hồ sơ, thẩm quyền, kênh |
| `POST /v1/chart` | 11 763 | bản đồ sinh: hành tinh, nhà, khía cạnh |
| `POST /v1/transits` | 1 999 | truyền qua đến bản đồ sinh vào ngày |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | giai đoạn Vedic Vimshottari |
| `POST /v1/houses` | 861 | chỉ cusp và góc, không có hành tinh |
| `POST /v1/planets` | 761 | chỉ vị trí các thiên thể |
| `POST /v1/acg` | 704 | astrokartography, các đường trên thế giới |
| `POST /v1/transit-calendar` | 678 | lịch truyền qua trong khoảng thời gian |
| `POST /v1/horoscope/daily` | 549 | văn bản cho ngày (AI) |
| `POST /v1/synastry` | 437 | tương thích của hai bản đồ |

`GET /v1/auth/keys/me` (262) trong cùng danh sách này: các agent kiểm tra khóa trước khi làm việc. Điều này miễn phí và không tiêu tốn credit.

## Cuộc gọi tối thiểu

Một payload phù hợp cho `chart`, `houses`, `planets`, `human-design`, `transits` và các endpoint khác của các loại bản đồ:

<Code lang="bash" title="terminal" code={`curl -X POST https://api.astroway.info/v1/chart \\
  -H "X-Api-Key: aw_test_YOUR_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"date":"1990-05-15","time":"15:30:00","timezone":"Europe/Kyiv","latitude":50.45,"longitude":30.52}'`} />

Quy tắc chi tiết cho các trường: [Định dạng trường](/agent-setup/field-formats/). Khóa `aw_test_*` không tiêu tốn credit, vì vậy nên dùng nó để phát triển.

## Đọc đặc tả, không đoán đoán

Mỗi trang thao tác có **bản sao markdown**: cùng URL cộng với `.md`. Đây là thứ nên cung cấp cho mô hình thay vì HTML.

<Code lang="bash" title="terminal" code={`curl https://api.astroway.info/docs/api/operations/acg_categories_get.md`} />

Bên cạnh: [`/llms.txt`](https://api.astroway.info/llms.txt) như điểm vào và [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) như đặc tả đầy đủ.

## Khi không cần khóa

Không có khóa, ba không gian tên vẫn hoạt động, tất cả đều có giới hạn theo IP: `/v1/public/*` (chín endpoint tính toán, được liệt kê ở trang [Miễn phí](/free/)), `/v1/embed/*` (widget sẵn có) và `/v1/reference/*` (tài liệu tham khảo: cung, hành tinh, khía cạnh).

Phản hồi không có khóa sẽ mang trường bổ sung `_footer` với chữ ký, và điều này bình thường, nó đánh dấu mức miễn phí.

## Tiếp theo

- [Lỗi thường gặp](/agent-setup/mistakes/): thường trả về 4xx
- [Cạm bẫy](/agent-setup/gotchas/): hành vi gây bất ngờ
- [MCP](/agent-setup/): một danh mục công cụ cho Claude, Cursor và những thứ khác