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:

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

Las reglas exactas de los campos: Formatos de campos. 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.

terminal

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

Además: /llms.txt como punto de entrada y /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), /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: lo que más devuelve 4xx
• Casos especiales: comportamiento que sorprende
• MCP: un catálogo de herramientas para Claude, Cursor y el resto