Documentación de AstroWay API

Last updated 25 sept 2026 Ver como Markdown Configuración del agente

Centro de la documentación técnica de AstroWay API. 865 endpoints basados en Swiss Ephemeris, una especificación OpenAPI legible por máquinas, colecciones listas para Postman e Insomnia, SDKs oficiales para TypeScript, Python y PHP, y un servidor MCP para Claude/Cursor.

Referencia

API Reference Catálogo completo de 865 endpoints: parámetros, esquemas de respuesta, códigos de error. Se genera a partir de la especificación OpenAPI en cada release.

OpenAPI specification Especificación legible por máquinas. Impórtala en Postman/Insomnia o genera tu propio SDK con openapi-generator.

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

Per-endpoint cost Coste en créditos de cada endpoint, de 0 a 500 créditos.

Primeros pasos

Inicio rápido Regístrate, obtén una clave y haz la primera llamada en 5 minutos.

Autenticación X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT para el dashboard.

Créditos y límites Pool de créditos, cuotas mensuales, rate limits por plan.

Idiomas 21 idiomas activos. Localización de las respuestas mediante `Accept-Language` (contenido de texto).

SDK e integraciones

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

Python SDK Paquete oficial `astroway` en PyPI. Clientes sync y async, Python 3.9+.

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

MCP server `@astroway/mcp`: servidor Model Context Protocol para Claude Desktop, Cursor y otros agentes de IA.

Ingeniería

Precisión de los cálculos Precisión de segundo de arco con Swiss Ephemeris. Tests de snapshot en CI contra el NASA Eclipse Catalog.

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

Idempotency Cabecera `Idempotency-Key` para reintentos seguros en POST.

Versionado Cómo subimos las versiones, qué rompe la compatibilidad y cómo leer el changelog.

Casos de uso y ejemplos

Resumen de productos Cuatro grupos de productos: Birth Chart, Human Design, Synastry, Horoscope.

Astrología védica Más de 354 endpoints para Vedic: Vargas, dashas (8 sistemas), Panchang, Shadbala, Yogas, Doshas.

Ejemplos de código Snippets listos para carta natal, sinastría, tránsitos, Human Design, MCP.

Use cases Escenarios de integración para apps de astrología, agentes de IA y plataformas de citas.

Sugerir edición