AstroWay/api v2.254.12 · es
todos los sistemas funcionando con normalidad

// sdk · official clients

SDK para TypeScript, Python, PHP, Go, C# / .NET.

Clientes oficiales con tipado completo, lógica de reintentos, limitación de tasa inteligente. Solicitud en 4 líneas de código - sin trabajo manual con cURL y headers. En desarrollo: Ruby, Rust. Todos generados desde OpenAPI 3.1.

Lanzado

// maintained by AstroWay · same-day OpenAPI sync
mcp-hosted lanzado

Hosted MCP - sin instalación para Claude Web / Desktop / Cursor

Punto final HTTP streamable alojado en mcp.astroway.info/mcp - mismo catálogo de más de 700 herramientas que el paquete npm, sin instalación local. Una sola URL, un solo encabezado Bearer, y tu cliente de IA ve todo el ecosistema AstroWay. Multiinquilino: los créditos se extraen de la cuenta que posee tu clave Bearer.

https://mcp.astroway.info/mcp leer guía del SDK →
mcp lanzado

Servidor MCP (stdio) para Claude / Cursor / GPT

Oficial @astroway/mcp: expone cada uno de los más de 700 endpoints de la API de AstroWay como herramientas para agentes de IA. Funciona con clientes MCP de Claude Desktop, Cursor y GPT. Modo stdio - tu clave permanece en tu máquina, sin saltos por la red. Para escenarios sin instalación, usa el endpoint alojado.

npx -y @astroway/mcp leer guía del SDK →
typescript lanzado

SDK TypeScript para AstroWay API

Oficial @astroway/sdk - envoltura delgada sobre openapi-fetch (~6 KB de tiempo de ejecución). Autocompletado de ruta + tipos de solicitud/respuesta en su IDE para todos los endpoint. Jerarquía de errores al estilo Stainless, reintento integrado para 408/409/429/5xx, OIDC + SLSA L3 procedencia.

npm install @astroway/sdk leer guía del SDK →
python lanzado

SDK de Python para la API de AstroWay

Oficial astroway en PyPI - Astroway (síncrono) + AsyncAstroway (asíncrono) sobre httpx. Superficie idéntica - la misma API en ambos clientes. Jerarquía de errores al estilo Stainless, reintento en 408/409/429/5xx, paquete tipificado PEP 561. Python 3.9+, Editor de confianza OIDC.

pip install astroway leer guía del SDK →
php lanzado

SDK PHP para la API AstroWay

Oficial astroway/sdk en Packagist - construido sobre Guzzle 7 + PSR-18. PHP 8.1+ (propiedades de solo lectura, promoción del constructor). Jerarquía de errores al estilo Stainless, middleware de reintento integrado en 408/409/429/5xx, dos esquemas de autenticación (X-Api-Key predeterminado o Bearer).

composer require astroway/sdk leer guía del SDK →
react lanzado

Compañero React para @astroway/sdk

Oficial @astroway/react en npm - un envoltorio delgado al estilo Stripe para @astroway/sdk. AstrowayProvider eleva el cliente al contexto React; los ganchos useAstroway, useAstrowayQuery, useNatalChart devuelven una triple { data, error, loading } al estilo SWR con cero dependencias externas. Funciona con React 18+, Next.js App Router (via "use client"), Vite, CRA.

npm install @astroway/react @astroway/sdk react leer guía del SDK →
ui lanzado

Componentes web de AstroWay (alpha)

Rueda natal, fase lunar, compatibilidad, tarot y horóscopo como elementos HTML simples para cualquier sitio: una etiqueta <script> de un CDN, o npm install. Los gráficos se dibujan con el mismo código que la API, así que una rueda en tu página coincide con lo que devuelve /v1/render. Alpha: los nombres de atributos pueden cambiar antes de la 1.0.

npm install @astroway/ui@alpha leer guía del SDK →
symfony lanzado

Bundle de Symfony para la API AstroWay

Oficial astroway/sdk-symfony en Packagist - un Bundle construido sobre astroway/sdk. Se registra automáticamente a través de Symfony Flex, configurado a través del archivo config/packages/astroway.yaml estándar, expone un servicio Astroway\Astroway inyectable para inyectar en cualquier controlador o servicio. Compatible con Symfony 6.4 LTS y 7.x, PHP 8.1+.

composer require astroway/sdk-symfony:^0.1.0-alpha leer guía del SDK →
laravel lanzado

ServiceProvider de Laravel para la API de AstroWay

Oficial astroway/sdk-laravel en Packagist - un ServiceProvider + fachada sobre astroway/sdk. Auto-detectado mediante composer.json extra.laravel.providers, Astroway\Astroway registrado como singleton en el contenedor, config publicado con php artisan vendor:publish. Inyecta en controladores o usa la fachada Astroway::post("/chart", ...). Funciona con Laravel 10/11/12, PHP 8.1+.

composer require astroway/sdk-laravel:^0.1.0-alpha leer guía del SDK →
go lanzado

SDK de Go para la API de AstroWay

El módulo oficial de AstroWay Go: cada endpoint de la API como método, como aw.Chart.Compute, con un context en cada llamada. Reintentos en 408/409/429/5xx respetan Retry-After, y un POST mantiene una Idempotency-Key, así que una llamada reintentada no se cobra dos veces. Los errores se prueban con errors.Is, y la respuesta se decodifica en tu propio tipo. Solo biblioteca estándar, Go 1.22+.

go get github.com/astroway/astroway-go leer guía del SDK →
csharp lanzado

SDK C# para la API de AstroWay

Paquete Astroway.Sdk: cada endpoint de la API como un método async, como aw.Chart.ComputeAsync, cancelable con un CancellationToken. Reintentos en 408/409/429/5xx respetan Retry-After, cada tipo de error tiene su propia excepción, y la respuesta se deserializa en tus propios registros. .NET Standard 2.0 y .NET 8: .NET Framework 4.7.2+, .NET 6/8/9, Unity.

dotnet add package Astroway.Sdk leer guía del SDK →

4 líneas para la primera solicitud

// TypeScript · el mismo patrón en Python, PHP, Laravel, Symfony, React
npm install @astroway/sdk ejemplo completo →
import { Astroway } from '@astroway/sdk';

const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const { data: chart } = await aw.client.POST('/chart', {
  body: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  },
});

// aw.client.POST is the raw typed fetch, so `chart` is the { ok, data } envelope
console.log(chart.data.houses.ascendant);  // 212.0952574979425

Próximamente

// roadmap · te avisaremos cuando esté disponible

Tu propia envoltura

// OpenAPI 3.1 · tu lenguaje, tus convenciones

¿No encontraste tu lenguaje en nuestra lista? Todos los endpoints están descritos en el estándar OpenAPI 3.1 spec - genera tu propio cliente a través de openapi-generator o stainless.