Tugas untuk Agen

Halaman ini ditulis dari log selama 30 hari, bukan dari imajinasi. Di bawah ini adalah panggilan yang benar-benar dilakukan oleh integrator dengan kunci, dalam urutan frekuensi.

Yang paling sering dipanggil

Endpoint	Panggilan berhasil dalam 30 hari	Untuk apa
POST /v1/human-design	12 563	bodygraph: tipe, profil, otoritas, saluran
POST /v1/chart	11 763	natal chart: planet, rumah, aspek
POST /v1/transits	1 999	transit ke natal pada tanggal
POST /v1/vedic/dashas/vimshottari/maha	1 272	periode Vedic Vimshottari
POST /v1/houses	861	hanya kuspida dan sudut, tanpa planet
POST /v1/planets	761	hanya posisi benda
POST /v1/acg	704	astrocartografi, garis di dunia
POST /v1/transit-calendar	678	kalender transit untuk periode
POST /v1/horoscope/daily	549	teks untuk hari (AI)
POST /v1/synastry	437	kompatibilitas dua chart

GET /v1/auth/keys/me (262) juga dalam daftar ini: agen memeriksa kunci sebelum bekerja. Ini gratis dan tidak menghabiskan kredit.

Panggilan minimal

Satu benda cocok untuk chart, houses, planets, human-design, transits dan endpoint kartu lainnya:

terminal

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}'

Aturan pasti untuk bidang: Format Bidang. Kunci aw_test_* tidak menghabiskan kredit, jadi seharusnya digunakan untuk pengembangan.

Baca spesifikasi, jangan tebak

Setiap halaman operasi memiliki markdown twin: URL yang sama ditambah .md. Ini yang seharusnya diberikan kepada model sebagai gantinya HTML.

terminal

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

Di sebelahnya: /llms.txt sebagai titik masuk dan /v1/openapi.json sebagai spesifikasi lengkap.

Kapan kunci tidak diperlukan

Tanpa kunci, tiga namespace bekerja, semuanya dengan limit per IP: /v1/public/* (sembilan endpoint perhitungan, terdaftar di halaman Gratis), /v1/embed/* (widget siap pakai) dan /v1/reference/* (referensi: tanda, planet, aspek).

Tanpa kunci, respons memiliki bidang tambahan _footer dengan tanda, dan ini normal, begitulah cara menandai tingkat gratis.

Selanjutnya

• Kesalahan umum: yang sering mengembalikan 4xx
• Kesulitan: perilaku yang mengejutkan
• MCP: satu katalog alat untuk Claude, Cursor dan lainnya