Documentación de la API de AstroWay

Hub de documentación técnica de AstroWay API. 761 endpoints basados en Swiss Ephemeris, OpenAPI compatible, colecciones listas para Postman e Insomnia, SDK oficiales para TypeScript, Python y PHP, MCP servidor para Claude/Cursor.

Referencia

API Reference Catálogo completo de 761 endpoints: parámetros, esquemas de respuesta, códigos de error. Generado con la especificación OpenAPI en cada lanzamiento.

OpenAPI specification Especificación compatible con máquinas. Importe en Postman/Insomnia o genere su SDK a través de openapi-generator.

Postman collection Colección lista para importar con ejemplos para cada endpoint.

Costo por endpoint Costo en créditos para cada endpoint - de 0 a 500 créditos.

Inicio

Inicio rápido Registrarse, obtener la clave, hacer la primera llamada en 5 minutos.

Autenticación X-Api-Key vs Bearer, vivo (aw_live_*) vs sandbox (aw_test_*), JWT para el panel de control.

Créditos y límites Pulsa créditos, cuotas mensuales, límites de velocidad según el plan.

Soporte de idiomas 21 idiomas activos. Localización de contenido a través de `Accept-Language` (contenido de texto).

SDK y integraciones

SDK de TypeScript Paquete oficial `@astroway/sdk` en npm. ESM, Node 20+, compatible con navegador.

SDK de Python Paquete oficial `astroway` en PyPI. Clientes sincrónicos y asíncronicos, Python 3.9+.

SDK de PHP Paquete oficial `astroway/sdk` en Packagist. PSR-18 HTTP, PHP 8.1+.

Servidor MCP `@astroway/mcp` - Servidor de protocolo de contexto para Claude Desktop, Cursor y otros agentes AI.

Ingeniería

Precisión de cálculos Swiss Ephemeris con precisión de segundos de arco. Pruebas de snapshot CI contra el catálogo de eclipses de NASA.

Errores Lista de códigos de error, estados HTTP y estructura de envoltura de error.

Idempotencia Cabecera `Idempotency-Key` para un retry seguro en POST.

Versiónamiento Cómo bompamos versiones, qué hace que la compatibilidad se rompa, cómo leer el changelog.

Escenarios y ejemplos

Resumen de productos Cuatro grupos de productos - Carta de nacimiento, Diseño humano, Sinestra, Horóscopo.

Astrología vedica 354+ endpoints para la Védica - Varjas, dashas (8 sistemas), Panchang, Shadbala, Yogas, Doshas.

Ejemplos de código Ejemplos de código para cartas de nacimiento, sinestras, transits, Diseño humano, MCP.

Escenarios de uso Escenarios de integración para aplicaciones de astrózastos, agentes AI y plataformas de citas.