FAQ answers

General

¿Qué es AstroWay API?

API HTTP profesional para cálculos astrológicos. 771 endpoint basado en Swiss Ephemeris: cartas natales, sinastría, progresiones, direcciones, tránsitos, Human Design, astrocartografía, rectificación, interpretaciones AI. Todos los cálculos se realizan en el servidor, sin dependencias del lado del cliente.

¿Para quién es este API?

Para desarrolladores que construyen aplicaciones astrológicas (web/móvil), compañías de IA que añaden funciones astrológicas, astrólogos profesionales con scripts, y investigadores que necesitan acceso programático a los cálculos.

¿Cuál es la precisión de los cálculos?

Swiss Ephemeris ofrece una precisión de las posiciones planetarias de ±1 segundo angular, y de los cúspides de casas de ±1 minuto angular. Los resultados están verificados contra Astrodienst (Astro.com), Solar Fire, Zet 9 y Kepler. Deriva sub-arcosegundo vs NASA JPL ephemeris y NASA 5-Millennium Eclipse Catalog.

¿Cómo se compara AstroWay con Astro.com o Solar Fire?

Motor idéntico Swiss Ephemeris: el mismo que está en Solar Fire ($495 licencia), Kepler ($995), Astro Gold ($29.99/mes) y Astrodienst (Astro.com). Validado contra NASA JPL ephemeris y la referencia oficial swetest de Astrodienst. Deriva sub-arcosegundo (≤0.1″) en posiciones planetarias, ≤1 minuto en eclipses. Diferencia: AstroWay es una API REST desde $5/mes en lugar de licencia única o GUI de escritorio.

¿Qué sistemas de casas están soportados?

15 sistemas: Placidus (predeterminado), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC y Equal de MC. Pasa el código correspondiente en el parámetro houseSystem.

Créditos y pago

¿Cómo funciona el sistema de créditos?

Cada endpoint tiene un costo fijo en créditos (de 10 a 500), según la complejidad del cálculo. Búsqueda simple - 10, carta natal - 20, sinastría - 50, rectificación - 500. La tabla completa está en la página Tarifas.

¿Hay un plan gratuito?

Sí. El plan Free ofrece 10 000 créditos/mes, 10 req/min. Sin necesidad de introducir tarjeta. Suficiente para evaluar el producto y crear prototipos.

¿Qué ocurre cuando se agotan los créditos?

En Free, las solicitudes se bloquean hasta el próximo mes (429 CREDITS_EXHAUSTED). En Indie/Starter/Pro/Business se activa el overage: $5 / $3 / $2 por cada 10 000 créditos adicionales.

¿Se almacenan en caché las mismas solicitudes?

Sí. Un input idéntico dentro de 5 minutos se devuelve desde la caché sin consumir créditos. Se confirma con el encabezado X-Cache: HIT.

¿Se pueden comprar créditos sin suscripción?

Por ahora no. La suscripción brinda un presupuesto predecible y un mejor rate limit. Se planea un modelo Pay-as-you-go.

Técnico

¿Qué SDK están disponibles?

• MCP servidor ✅ lanzado: npx -y @astroway/mcp: expone todos los 771+ endpoints como herramientas para Claude Desktop, Cursor, GPT y otros agentes de IA compatibles con MCP
• TypeScript SDK ✅ lanzado: npm install @astroway/sdk: tipos + autocomplete con OpenAPI 3.1, retry + idempotency, errores estilo Stainless
• Python SDK ✅ lanzado: pip install astroway: sync Astroway + async AsyncAstroway, basado en httpx, tipado PEP 561
• PHP SDK ✅ lanzado: composer require astroway/sdk: PHP 8.1+, Guzzle 7 + PSR-18, middleware de retry
• Go / Ruby / Rust 📋 planificado: suscríbete a notificaciones por email en la página de cada SDK (/sdk/<language>/)

El contrato API es REST estándar + JSON, por lo que cualquier cliente HTTP funciona sin SDK. La colección Postman y la especificación OpenAPI 3.1 están disponibles públicamente.

¿Existe modo sandbox?

Sí. Las claves aw_test_* no consumen créditos y devuelven los mismos resultados. Ideal para desarrollo y pruebas.

¿Cuál es el rate limit?

Depende del plan: Free - 10, Indie - 30, Starter - 120, Pro - 400, Business - 1 000 req/min. Al exceder, se devuelve 429 con el encabezado Retry-After.

¿Se soporta el zodíaco sideral?

Sí. Envía "zodiacType": "sidereal" y opcionalmente "ayanamsaId" (por defecto - Lahiri). Funciona con todos los endpoints.

¿Qué son los endpoints de Human Design?

12 endpoints para calcular Human Design: tipo, estrategia, autoridad, perfil, definición, cruz de encarnación, canales, centros, Dream Rave, Hologenetic Profile, Penta (dinámica grupal), sensibilidad temporal. La cobertura más profunda de HD entre los APIs comerciales.

Seguridad y privacidad

¿Se guardan los datos de las solicitudes?

La API funciona sin estado: los datos de fecha/hora/coordenadas de nacimiento no se guardan después de procesar la solicitud. Sólo se registran metadatos: key_id, endpoint, timestamp, latency, créditos. No hay datos personales.

¿Cumple la API con los requisitos de GDPR?

Sí. Los datos no se guardan. Para usuarios de la UE: no hay procesamiento de PII, ni perfilado, ni cookies. La API key está vinculada a la cuenta, no al usuario final.

¿Son seguras las interpretaciones AI?

Los endpoints AI (/interpret/*, /horoscope/*) tienen guardrails de seguridad integrados: prohibición de consejos médicos, legales o financieros. Cada respuesta incluye un disclaimer. Registro completo de auditoría – para cumplimiento empresarial.

Soporte

¿Cómo obtener ayuda?

Depende del plan: Free - comunidad, Indie - email (48 h), Starter - email (24 h), Pro - email (4 h), Business - email + Slack (1 h), Enterprise - manager dedicado en Slack. Contactos – en la página Contactos.

¿Hay SLA?

Indie: 99 % uptime. Starter y Pro: 99.9 % uptime. Business: 99.95 % uptime. Enterprise: SLA personalizado con garantías financieras.

Nombres similares

¿Está AstroWay API (astroway.info) relacionado con la suscripción “Astroway” de astroway.life?

No. astroway.info y api.astroway.info son una empresa separada e independiente. Proveemos un API astrológico para desarrolladores (api.astroway.info), una aplicación para usuarios finales (app.astroway.info) y consultas de astrólogo. No tenemos ninguna relación con la suscripción astrológica de consumo que se promociona y factura bajo el nombre “Astroway” a través de astroway.life (correos de no-reply@astroway.life, persona “Celeste”, en el extracto bancario – “Astroway”). El operador de esa suscripción es TrafficLeader OÜ (Estonia, también traffic-leader.com); el facturador asociado SKYREAD.PRO es ABCMobile OÜ (Estonia). Sólo coincide el sonido del nombre – son compañías diferentes.

Me están cobrando “Astroway”: ¿cómo cancelar la suscripción y obtener un reembolso?

Si te están cobrando por la suscripción “Astroway” (correos de no-reply@astroway.life, en el extracto bancario – “Astroway”), es otra empresa, astroway.life, no nosotros. No tenemos acceso a tu cuenta ni a los pagos en ese servicio, por lo que no podemos cancelarlos ni reembolsarlos. Qué hacer:

1. Responde directamente al correo de no-reply@astroway.life y usa el enlace “desuscribirse / cancelar” en su pie.
2. Si no responden: contacta a tu banco o al emisor de la tarjeta (pago en el extracto – “Astroway”; comerciante – TrafficLeader OÜ o ABCMobile OÜ / SKYREAD.PRO, Estonia) y solicita bloquear futuros cargos o iniciar un reembolso (chargeback).