AstroWay/api v2.74.2 · it
tutti i sistemi sono operativi

// sdk · client ufficiali

SDK per 11 lingue.

Client ufficiali con tipizzazione completa, logica di retry, rate-limiting intelligente. Richiesta in 4 righe di codice — senza lavoro manuale con cURL e header. 8 lingue in produzione, 3 — in lavorazione, tutte generate con OpenAPI 3.1.

Rilasciati

// mantenuti da AstroWay · sincronizzazione OpenAPI dello stesso giorno
mcp-hosted rilasciato

Hosted MCP — installazione zero per Claude Web / Desktop / Cursor

Endpoint HTTP streamable ospitato su mcp.astroway.info/mcp — stesso catalogo di oltre 700 strumenti del pacchetto npm, senza installazione locale. Un solo URL, un solo header Bearer, e il tuo client AI vede l'intero ecosistema AstroWay. Multi-tenant: i crediti vengono prelevati dal account proprietario della tua chiave Bearer.

https://mcp.astroway.info/mcp leggi la guida SDK →
mcp rilasciato

Server MCP (stdio) per Claude / Cursor / GPT

Ufficiale @astroway/mcp: espone tutti i 700+ endpoint API di AstroWay come strumenti per agenti AI. Funziona con Claude Desktop, Cursor, client MCP GPT. Modalità stdio — la tua chiave rimane sul tuo dispositivo, senza trasferimenti di rete. Per scenari senza installazione usa l'endpoint ospitato.

npx -y @astroway/mcp leggi la guida SDK →
typescript rilasciato

SDK TypeScript per AstroWay API

Ufficiale `@astroway/sdk` — wrapper leggero su `openapi-fetch` (~6 KB runtime). Autocompletamento del percorso + tipi di richiesta/ricezione nel tuo IDE per tutti gli endpoint. Gerarchia degli errori in stile Stainless, ritento integrato per 408/409/429/5xx, OIDC + SLSA L3 provenienza.

npm install @astroway/sdk leggi la guida SDK →
python rilasciato

SDK Python per l'API AstroWay

Ufficiale `astroway` su PyPI — `Astroway` (sync) + `AsyncAstroway` (async) su `httpx`. Superficie identica — la stessa API su entrambi i client. Gerarchia degli errori in stile Stainless, ritento su 408/409/429/5xx, pacchetto tipizzato PEP 561. Python 3.9+, Editore attendibile OIDC.

pip install astroway leggi la guida SDK →
php rilasciato

SDK PHP per l'API AstroWay

Ufficiale `astroway/sdk` su Packagist — costruito su Guzzle 7 + PSR-18. PHP 8.1+ (proprietà readonly, promozione costruttore). Gerarchia degli errori in stile Stainless, middleware di ritento integrato su 408/409/429/5xx, due schemi di autenticazione (X-Api-Key predefinito o Bearer).

composer require astroway/sdk leggi la guida SDK →
react rilasciato

Companione React per @astroway/sdk

Ufficiale `@astroway/react` su npm — un wrapper sottile nello stile Stripe per `@astroway/sdk`. `AstrowayProvider` solleva il client nel contesto React; gli hook `useAstroway`, `useAstrowayQuery`, `useNatalChart` restituiscono una tripla `{ data, error, loading }` nello stile SWR con zero dipendenze esterne. Funziona con React 18+, Next.js App Router (via "use client"), Vite, CRA.

npm install @astroway/react @astroway/sdk react leggi la guida SDK →
symfony rilasciato

Bundle Symfony per l'API AstroWay

Ufficiale `astroway/sdk-symfony` su Packagist — un Bundle basato su `astroway/sdk`. Si registra automaticamente tramite Symfony Flex, configurato tramite il file `config/packages/astroway.yaml` standard, espone un servizio `Astroway\Astroway` autowireable per l'iniezione in qualsiasi controller o servizio. Compatibile con Symfony 6.4 LTS e 7.x, PHP 8.1+.

composer require astroway/sdk-symfony leggi la guida SDK →
laravel rilasciato

ServiceProvider di Laravel per l'API di AstroWay

Ufficiale `astroway/sdk-laravel` su Packagist — un ServiceProvider + facade sopra `astroway/sdk`. Auto-rilevato tramite `composer.json` `extra.laravel.providers`, `Astroway\Astroway` registrato come singleton nel container, config pubblicato con `php artisan vendor:publish`. Inietta nei controller o usa la facade `Astroway::post("/chart", ...)`. Funziona con Laravel 10/11/12, PHP 8.1+.

composer require astroway/sdk-laravel leggi la guida SDK →

4 righe per la prima richiesta

// TypeScript · stesso pattern in Python, PHP, Laravel, Symfony, React
npm install @astroway/sdk esempio 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',
  },
});

console.log(chart.angles.asc);

Prossimamente

// roadmap · ti avviseremo quando verrà rilasciato

La tua copertura

// OpenAPI 3.1 · la tua lingua, le tue convenzioni

Non hai trovato la tua lingua nella nostra lista? Tutti gli endpoint sono descritti nello standard OpenAPI 3.1 spec — genera il tuo client tramite openapi-generator o stainless.