El catálogo de AstroWay ya suma 865 endpoints en 57 grupos. A esta escala, la pregunta principal del integrador no es “¿será suficiente la cobertura?”, sino “¿cómo no perderme?”. Este artículo es un mapa: cómo se divide el catálogo en dominios y cómo encontrar lo que necesitas en un minuto.
Un patrón para todas las llamadas
Sección titulada «Un patrón para todas las llamadas»Sea cual sea el 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 con los parámetros propios de la técnica. La respuesta siempre es { "ok": true, "data": {...} } o { "ok": false, "error": {...} }. Nada de GraphQL ni de flujos de auth distintos por dominio: una clave en la cabecera X-Api-Key, un formato de respuesta.
Esto significa que el wrapper que escribes para la carta natal sirve también para BaZi y para las runas: solo cambian la ruta y el esquema del cuerpo.
Dominios del catálogo
Sección titulada «Dominios del catálogo»El catálogo se agrupa en grandes dominios. Este es el mapa con los contadores reales (los números salen del manifiesto en cada build, así que aquí siempre están al día):
| Dominio | Endpoints | Qué contiene |
|---|---|---|
| Astrología occidental | 186 | Carta natal, aspectos, dignidades, técnicas predictivas (tránsitos, progresiones, direcciones), horaria, 4 escuelas helenísticas, psicológica moderna, evolutiva, cosmobiología |
| Védica | 230 | El dominio más grande: nakshatras, dashas, cartas divisionales (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Human Design | 12 | Bodygraph, canales, puertas, tipo/perfil/autoridad, cruz de encarnación |
| Tarot | 71 | Tres barajas: Rider-Waite-Smith, Marseille, Lenormand: tiradas, significados, combinaciones |
| Numerología | 55 | 5 sistemas con 10 cálculos cada uno (pitagórico, caldeo, dos cabalísticos, védico) |
| China + Maya | 55 | BaZi (cuatro pilares), Zi Wei Dou Shu, zodíaco chino y feng shui, calendarios mayas |
| Adivinación | 40 | Geomancia (Agrippa), runas del Futhark antiguo, quiromancia (Cheiro), I Ching |
| Nichos aplicados | 53 | Wellness, astrología de mascotas, negocios, finanzas, familia |
| Informes | 29 | Interpretaciones listas (natal, synastry), en HTML/PDF, con marca white-label |
| Render | 14 | Ruedas de carta en SVG/PNG, bodygraph, anillos de tránsitos, sin frontend propio |
| Herramientas dev | 47 | Webhooks, streaming en tiempo real, widgets embebibles, white-label |
El resto son interpretaciones con IA, horóscopos, endpoints de referencia (signos, planetas, aspectos) y de sistema (health, usage, openapi).
La védica es otra historia
Sección titulada «La védica es otra historia»230 endpoints védicos son más que toda la parte occidental. La razón es simple: la tradición védica está más formalizada. Donde la astrología occidental tiene un conjunto de casas, la védica tiene 16 cartas divisionales (varga), varios sistemas de dasha y decenas de yogas con reglas precisas. Cada uno de ellos es un endpoint aparte con un resultado determinista.
Si construyes para el mercado indio, esto es el núcleo del producto, no un complemento.
La precisión debajo de todo esto
Sección titulada «La precisión debajo de todo esto»Por exótica que sea la técnica, las posiciones planetarias las calcula un único núcleo basado en Swiss Ephemeris. Ese mismo núcleo funciona en nuestra aplicación y en la API: una sola base de código, ninguna divergencia. Los endpoints de cálculo están cubiertos por 888 tests de snapshot que en cada PR se cotejan con fuentes de referencia. Hay más detalles en el artículo sobre la precisión en CI.
Cómo encontrar lo que necesitas
Sección titulada «Cómo encontrar lo que necesitas»Tres caminos, del más rápido al más lento:
- Referencia OpenAPI: /docs/api/ se genera directamente a partir de la especificación de producción
openapi.json. Los grupos de la barra lateral son los dominios de arriba. Cada endpoint tiene el esquema del cuerpo, un ejemplo y un botón para “probarlo”. - Catálogo MCP: si trabajas 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 solo el endpoint adecuado a partir de la descripción. - Búsqueda en la especificación:
curl https://api.astroway.info/v1/openapi.jsondevuelve el contrato completo legible por máquinas. Útil para generar tu propio cliente.
Empezar
Sección titulada «Empezar»Una clave en dashboard/sign-up te da 10 000 créditos al mes, suficiente para recorrer decenas de dominios y ver cuáles son para ti. No hace falta estudiar el catálogo entero: toma tu dominio, y el resto esperará hasta que lo necesites.
Posiciones al segundo de arco en 4 líneas de código.
Clave gratuita sin tarjeta. 5 000 llamadas al mes antes del primer pago.