# Tareas para el agente

Esta página está escrita a partir de los logs de producción de 30 días, no de la imaginación. A continuación, las llamadas que realmente hacen los integradores con clave, en orden de frecuencia.

## Qué se llama con más frecuencia

| Endpoint | Llamadas exitosas en 30 días | Para qué |
|---|---|---|
| `POST /v1/human-design` | 12 563 | bodygraph: tipo, perfil, autoridad, canales |
| `POST /v1/chart` | 11 763 | carta natal: planetas, casas, aspectos |
| `POST /v1/transits` | 1 999 | tránsitos a la natal en una fecha |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | periodos védicos Vimshottari |
| `POST /v1/houses` | 861 | solo cúspides y ángulos, sin planetas |
| `POST /v1/planets` | 761 | solo posiciones de los cuerpos |
| `POST /v1/acg` | 704 | astrocartografía, líneas en el mundo |
| `POST /v1/transit-calendar` | 678 | calendario de tránsitos para un período |
| `POST /v1/horoscope/daily` | 549 | texto del día (IA) |
| `POST /v1/synastry` | 437 | compatibilidad entre dos cartas |

`GET /v1/auth/keys/me` (262) está en esta misma lista: los agentes verifican la clave antes de trabajar. Es gratis y no consume créditos.

## Llamada mínima

Un cuerpo funciona para `chart`, `houses`, `planets`, `human-design`, `transits` y otros endpoints de cartas:

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

Las reglas exactas de los campos: [Formatos de campos](/agent-setup/field-formats/). La clave `aw_test_*` no consume créditos, por lo que es ideal para desarrollar.

## Leer la especificación, no adivinar

Cada página de operación tiene un **duplicado en markdown**: la misma URL más `.md`. Esto es lo que deberías darle al modelo en lugar de HTML.

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

Además: [`/llms.txt`](https://api.astroway.info/llms.txt) como punto de entrada y [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) como especificación completa.

## Cuándo no se necesita clave

Sin clave funcionan tres espacios de nombres, todos con límite por IP: `/v1/public/*` (nueve endpoints de cálculo, listados en la página [Gratis](/free/)), `/v1/embed/*` (widgets listos) y `/v1/reference/*` (referencias: signos, planetas, aspectos).

La respuesta sin clave incluye un campo adicional `_footer` con una firma, y es normal, así se marca el nivel gratuito.

## Siguiente

- [Errores típicos](/agent-setup/mistakes/): lo que más devuelve 4xx
- [Casos especiales](/agent-setup/gotchas/): comportamiento que sorprende
- [MCP](/agent-setup/): un catálogo de herramientas para Claude, Cursor y el resto