# Aufgaben für Agent

Diese Seite ist geschrieben basierend auf den Protokollen der Integrationen über 30 Tage, nicht aus der Fantasie. Hier sind die Aufrufe, die Integratoren tatsächlich mit ihrem Schlüssel durchführen, in der Häufigkeitsreihenfolge.

## Am häufigsten aufgerufene Endpunkte

| Endpunkt | Erfolgreiche Aufrufe in 30 Tagen | Wofür |
|---|---|---|
| `POST /v1/human-design` | 12 563 | Bodygraph: Typ, Profil, Autorität, Kanäle |
| `POST /v1/chart` | 11 763 | Geburtshoroskop: Planeten, Häuser, Aspekte |
| `POST /v1/transits` | 1 999 | Transite zum Nataldatum |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | Vimshottari-Dasha-Perioden in der vedischen Astrologie |
| `POST /v1/houses` | 861 | nur Häuserkuppen und Winkel, ohne Planeten |
| `POST /v1/planets` | 761 | nur Positionen der Himmelskörper |
| `POST /v1/acg` | 704 | Astrocartography, Linien weltweit |
| `POST /v1/transit-calendar` | 678 | Transiten-Kalender für einen Zeitraum |
| `POST /v1/horoscope/daily` | 549 | Text für den Tag (KI) |
| `POST /v1/synastry` | 437 | Kompatibilität zweier Horoskope |

`GET /v1/auth/keys/me` (262) ist auch in dieser Liste: Agenten prüfen den Schlüssel vor der Arbeit. Das ist kostenlos und verbraucht keine Credits.

## Minimaler Aufruf

Ein Himmelskörper funktioniert für `chart`, `houses`, `planets`, `human-design`, `transits` und die restlichen Endpunkte:

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

Die genauen Feldregeln: [Feldformate](/agent-setup/field-formats/). Der Schlüssel `aw_test_*` verbraucht keine Credits, daher sollte man damit entwickeln.

## Spezifikation lesen, nicht raten

Jede Operationsseite hat ein **Markdown-Gegenstück**: die gleiche URL plus `.md`. Das ist, was man dem Modell anstelle von HTML geben sollte.

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

Daneben: [`/llms.txt`](https://api.astroway.info/llms.txt) als Einstiegspunkt und [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) als vollständige Spezifikation.

## Wenn kein Schlüssel benötigt wird

Ohne Schlüssel funktionieren drei Namespaces, alle mit IP-Limit: `/v1/public/*` (neun Berechnungs-Endpunkte, auf der Seite [Kostenlos](/free/) aufgeführt), `/v1/embed/*` (fertige Widgets) und `/v1/reference/*` (Nachschlagewerke: Zeichen, Planeten, Aspekte).

Die Antwort ohne Schlüssel enthält ein zusätzliches Feld `_footer` mit einer Signatur, und das ist normal, so wird der kostenlose Kenntlich gemacht.

## Weiter

- [Typische Fehler](/agent-setup/mistakes/): was am häufigsten 4xx zurückgibt
- [Stolperfallen](/agent-setup/gotchas/): überraschendes Verhalten
- [MCP](/agent-setup/): ein Katalog von Werkzeugen für Claude, Cursor und den Rest