# Ajan Görevleri

Bu sayfa 30 günlük loglardan yazılmıştır, hayal ürünü değildir. Aşağıda, entegratörlerin anahtarla gerçekten yaptığı çağrıların sıklık sırasıyla listesi bulunmaktadır.

## En sık çağrılanlar

| Ендпоінт | 30 günde başarılı çağrılar | Neden |
|---|---|---|
| `POST /v1/human-design` | 12 563 | bodygraph: tip, profil, yetki, kanallar |
| `POST /v1/chart` | 11 763 | doğum haritası: gezegenler, evler, aspectler |
| `POST /v1/transits` | 1 999 | doğum haritasına göre transitler belirli tarih için |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | Vedic Vimshottari dönemleri |
| `POST /v1/houses` | 861 | sadece köşe noktaları ve evler, gezegenler olmadan |
| `POST /v1/planets` | 761 | sadece cisimlerin pozisyonları |
| `POST /v1/acg` | 704 | astroloji haritalama, dünya üzerindeki hatlar |
| `POST /v1/transit-calendar` | 678 | belirli bir dönem için transit takvimi |
| `POST /v1/horoscope/daily` | 549 | günlük metin (AI) |
| `POST /v1/synastry` | 437 | iki haritanın uyumluluğu |

`GET /v1/auth/keys/me` (262) bu listede de var: ajanlar çalışmadan önce anahtarları kontrol eder. Bu ücretsizdir ve kredi harcamaz.

## Minimum çağrı

Tek bir cisim `chart`, `houses`, `planets`, `human-design`, `transits` ve diğer kart uç noktaları için uygundur:

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

Alanların tam kuralları: [Alan Formatları](/agent-setup/field-formats/). `aw_test_*` anahtarı kredi harcamaz, bu yüzden geliştirme için kullanılmalıdır.

## Spekülasyon yerine belgeleri okuyun

Her işlem sayfasının bir **markdown karşılığı** vardır: aynı URL plus `.md`. Bu, HTML yerine modele verilmelidir.

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

Yanında: [`/llms.txt`](https://api.astroway.info/llms.txt) giriş noktası ve [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) tam belge olarak.

## Anahtar ne zaman gerekmez

Anahtar olmadan üç ad alanı çalışır, hepsi IP başına limit ile: `/v1/public/*` (dokuz hesaplama uç noktası, [Ücretsiz](/free/) sayfasında listelenen), `/v1/embed/*` (hazır widget'lar) ve `/v1/reference/*` (referanslar: burçlar, gezegenler, aspectler).

Anahtarsız yanıtta `_footer` adında bir ek alan imza içerir ve bu normaldir, ücretsiz seviye böyle işaretlenir.

## Sonraki adımlar

- [Yaygın Hatalar](/agent-setup/mistakes/): 4xx durum kodlarını ne sıklıkla döndürür
- [Tuzaklar](/agent-setup/gotchas/): şaşırtıcı davranışlar
- [MCP](/agent-setup/): Claude, Cursor ve diğerleri için tek araç dizini