El catálogo de AstroWay cuenta con 758 endpoints en 57 grupos. En este escala, el principal problema del integrador no es “¿Cuál es la cobertura?”, sino “¿Cómo no me pierdo?” Esta artículo es una guía: cómo el catálogo está organizado en dominios y cómo encontrar el endpoint adecuado en un minuto.
Un patrón para todos los llamados
Sección titulada «Un patrón para todos los llamados»Independientemente del dominio, cada endpoint de cálculo tiene la misma forma:
POST /v1/{domain}/{calc}X-Api-Key: aw_live_...Content-Type: application/jsonEl cuerpo es un JSON con los datos de nacimiento (fecha, hora, coordenadas) o parámetros específicos para la técnica. La respuesta siempre es { "ok": true, "data": {...} } o { "ok": false, "error": {...} }. No hay GraphQL, ni autenticación separada por dominio: un solo clave en el encabezado X-Api-Key, un solo formato de respuesta.
Esto significa que la envoltura que escribas bajo la guía de la carta es adecuada tanto para BaZi como para los runas - cambia solo el camino y la esquema del cuerpo.
Los dominios del catálogo
Sección titulada «Los dominios del catálogo»El catálogo se agrupa en grandes dominios. Aquí está la guía con números reales (los números se toman del manifiesto en cada build, por lo que siempre son actuales):
| Dominio | Número de endpoints | Qué hay dentro |
|---|---|---|
| Occidental Astrology | 182 | Carta natal, aspectos, dignidades, predicciones (transits, progresiones, direcciones), horarios, 4 escuelas elípticas, psicología moderna, evolutiva, cosmobiología |
| Védica | 174 | El mayor dominio: nakshatras, dashas, divisional-carta (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Diseño Humano | 12 | Bodigrafo, canales, puertas, tipo/perfil/autoridad, cruz de encarnación |
| Tarot | 66 | Tres barajas: Rider-Waite-Smith, Marseille, Lenormand - planificaciones, significados, combinaciones |
| Numerología | 50 | 5 sistemas por 10 cálculos (pitagórico, caldeo, dos cabalísticos, védico) |
| Chino + Maya | 55 | BaZi (cuatro columnas), Zi Wei Dou Shu, zodíaco chino y feng shui, calendarios maya |
| Adivinación | 31 | Geomancia (Agrípida), runas del viejo Futhark, chiromancia (Cheiro), I Ching |
| Aplicaciones de nicho | 51 | Bienestar, astrología de mascotas, negocios, finanzas, familia |
| Informes | 23 | Interpretaciones listas (natal, sinestra), en HTML/PDF, con etiquetado blanco |
| Render | 14 | SVG/PNG ruedas de cartas, bodigrafos, círculos de transito - sin su propio front-end |
| Herramientas de desarrollo | 44 | Webhooks, streaming en tiempo real, inyecciones de código, etiquetado blanco |
El resto es interpretación de AI, horoscopos, endpoints de información (signos, planetas, aspectos) e información de sistema (salud, uso, OpenAPI).
Védica - una historia aparte
Sección titulada «Védica - una historia aparte»174 endpoints védicos son más que todo el dominio occidental. La razón es simple: la tradición védica es más formalizada. Allí donde la astrología occidental tiene un conjunto de casas, la védica tiene 16 divisional-carta (varga), varias sistemas dasha, decenas de yogas con reglas claras. Cada uno de esto - un endpoint separado con resultado determinado.
Si construyes para el mercado indio, esto es el núcleo del producto, no una adición.
Precisión bajo todo esto
Sección titulada «Precisión bajo todo esto»Independientemente de la exótica técnica, las posiciones planetarias se calculan con un núcleo en Swiss Ephemeris (WASM). El mismo núcleo funciona tanto en el navegador del cliente como en el servidor API - una sola base de código, sin divergencia. Los endpoints de cálculo están cubiertos por 873 pruebas de snapshot, que se verifican en cada PR con fuentes de referencia. Más detalles sobre esto - en un artículo aparte sobre la precisión de CI.
Cómo encontrar el necesario
Sección titulada «Cómo encontrar el necesario»Tres caminos, desde el más rápido:
- Guía de OpenAPI - /docs/api/ se genera directamente de la especificación de producto
openapi.json. Los grupos en el menú lateral = dominios arriba. Cada endpoint tiene un esquema de cuerpo, un ejemplo y un botón “Probar”. - Catálogo MCP - si estás en Claude o Cursor, todo el catálogo está disponible como un conjunto de herramientas a través de
mcp.astroway.info. El agente encuentra el endpoint adecuado por su descripción. - Búsqueda por especificación -
curl https://api.astroway.info/v1/openapi.jsondevuelve el contrato completo en máquina. Es cómodo para la generación de código de cliente propio.
Comenzar
Sección titulada «Comenzar»La clave en dashboard/sign-up da 10,000 créditos al mes - suficientes para pasar por docenas de dominios y entender qué hay aquí. No hay que estudiar el catálogo por completo: toma tu dominio, y el resto esperará hasta que lo necesites.
El mismo Swiss Ephemeris que en Solar Fire - en 4 líneas de código.
Clave gratuita sin tarjeta. 5 000 llamadas al mes antes del primer pago.