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 đồ:

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. 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.

curl https://api.astroway.info/docs/api/operations/acg_categories_get.md

Bên cạnh: /llms.txt như điểm vào và /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í), /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í.