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

// sdk · client ufficiali

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

Client ufficiali con tipizzazione completa, logica di retry, rate-limiting intelligente. Richiesta in 4 righe di codice - senza lavoro manuale con cURL e header. In lavorazione: Ruby, Rust. Tutti generati da 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 →
ui rilasciato

AstroWay web components (alpha)

Ruota natale, fase lunare, compatibilità, tarocchi e oroscopo come semplici elementi HTML per qualsiasi sito: un tag <script> da un CDN, o npm install. I grafici sono generati dallo stesso codice dell'API, così una ruota nella tua pagina corrisponde a ciò che restituisce /v1/render. Alpha: i nomi degli attributi potrebbero ancora cambiare prima della 1.0.

npm install @astroway/ui@alpha 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:^0.1.0-alpha 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:^0.1.0-alpha leggi la guida SDK →
go rilasciato

SDK Go per l'API AstroWay

Il modulo Go ufficiale di AstroWay: ogni endpoint API come metodo, ad esempio aw.Chart.Compute, con un context in ogni chiamata. I retry su 408/409/429/5xx rispettano Retry-After, e un POST mantiene un Idempotency-Key, così una chiamata ritentata non viene addebitata due volte. Gli errori si verificano con errors.Is, e la risposta viene decodificata nel tuo tipo. Solo libreria standard, Go 1.22+.

go get github.com/astroway/astroway-go leggi la guida SDK →
csharp rilasciato

SDK C# per l'API AstroWay

Pacchetto Astroway.Sdk: ogni endpoint API come metodo async, ad esempio aw.Chart.ComputeAsync, annullabile con un CancellationToken. I retry su 408/409/429/5xx rispettano Retry-After, ogni tipo di errore ha la sua eccezione, e la risposta viene deserializzata nei tuoi record. .NET Standard 2.0 e .NET 8: .NET Framework 4.7.2+, .NET 6/8/9, Unity.

dotnet add package Astroway.Sdk 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',
  },
});

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

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.