# 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:

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

Aturan pasti untuk bidang: [Format Bidang](/agent-setup/field-formats/). 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.

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

Di sebelahnya: [`/llms.txt`](https://api.astroway.info/llms.txt) sebagai titik masuk dan [`/v1/openapi.json`](https://api.astroway.info/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](/free/)), `/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](/agent-setup/mistakes/): yang sering mengembalikan 4xx
- [Kesulitan](/agent-setup/gotchas/): perilaku yang mengejutkan
- [MCP](/agent-setup/): satu katalog alat untuk Claude, Cursor dan lainnya