AstroWay/api v2.254.12 · ro
toate sistemele sunt în stare normală

// sdk · clienți oficiali

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

Clienți oficiali cu tipare complete, logică de retry, rate-limiting inteligent. O cerere în 4 linii de cod - fără lucru manual cu cURL și headere. În lucru: Ruby, Rust. Toate generate din OpenAPI 3.1.

Lansate

// întreținute de AstroWay · sincronizare OpenAPI în aceeași zi
mcp-hosted lansat

Hosted MCP - instalare zero pentru Claude Web / Desktop / Cursor

Endpoint HTTP streamabil găzduit la mcp.astroway.info/mcp - același catalog de 700+ instrumente ca și pachetul npm, fără instalare locală. Un singur URL, un singur header Bearer, iar clientul tău AI vede întregul ecosistem AstroWay. Multi-tenant: creditele sunt deduse din contul care deține cheia ta Bearer.

https://mcp.astroway.info/mcp citeste ghidul SDK →
mcp lansat

Server MCP (stdio) pentru Claude / Cursor / GPT

@astroway/mcp oficial: expune fiecare dintre cele peste 700 de endpoint-uri ale API-ului AstroWay ca instrumente pentru agenți AI. Funcționează cu clienții MCP ai lui Claude Desktop, Cursor și GPT. Modul stdio - cheia ta rămâne pe dispozitivul tău, fără salturi pe rețea. Pentru scenarii fără instalare folosește în schimb endpoint-ul găzduit.

npx -y @astroway/mcp citeste ghidul SDK →
typescript lansat

TypeScript SDK pentru AstroWay API

Oficial @astroway/sdk - wrapper subțire peste openapi-fetch (~6 KB runtime). Autocompletare a căilor + tipuri de cereri/răspunsuri în IDE-ul dvs. pentru toate 771-endpoints. Ierarhie de erori în stil Stainless, reluare încorporată la 408/409/429/5xx, OIDC + SLSA L3 proveniență.

npm install @astroway/sdk citeste ghidul SDK →
python lansat

Python SDK pentru AstroWay API

Oficial astroway pe PyPI - Astroway (sync) + AsyncAstroway (async) pe httpx. Suprafață identică - aceeași API pe ambele client. Ierarhie de erori în stil Stainless, retry la 408/409/429/5xx, pachet tipizat PEP 561. Python 3.9+, Editor de încredere OIDC.

pip install astroway citeste ghidul SDK →
php lansat

PHP SDK pentru AstroWay API

Oficial astroway/sdk pe Packagist - construit pe Guzzle 7 + PSR-18. PHP 8.1+ (proprietăți doar pentru citire, promovare constructor). Ierarhie de erori în stil Stainless, middleware de retry încorporat pe 408/409/429/5xx, două scheme de autentificare (X-Api-Key implicit sau Bearer).

composer require astroway/sdk citeste ghidul SDK →
react lansat

Companion React pentru @astroway/sdk

Oficial @astroway/react pe npm - un wrapper subțire în stil Stripe pentru @astroway/sdk. AstrowayProvider ridică clientul în contextul React; hook-urile useAstroway, useAstrowayQuery, useNatalChart returnează o triplă { data, error, loading } în stil SWR cu zero dependențe externe. Funcționează cu React 18+, Next.js App Router (prin "use client"), Vite, CRA.

npm install @astroway/react @astroway/sdk react citeste ghidul SDK →
ui lansat

Componente web AstroWay (alpha)

Roata natală, faza lunii, compatibilitate, tarot și horoscop ca elemente HTML simple pentru orice site: un tag <script> de la un CDN, sau npm install. Graficele sunt desenate cu același cod ca API-ul, așa că roata de pe pagina ta se potrivește cu ce returnează /v1/render. Alpha: numele atributelor pot să se schimbe încă înainte de 1.0.

npm install @astroway/ui@alpha citeste ghidul SDK →
symfony lansat

Pachet Symfony pentru API AstroWay

Oficial astroway/sdk-symfony pe Packagist - un pachet construit pe astroway/sdk. Se auto-registrează prin Symfony Flex, configurat prin fișierul standard config/packages/astroway.yaml, oferă un serviciu Astroway\Astroway autowireable pentru injectare în orice controlor sau serviciu. Compatibil cu Symfony 6.4 LTS și 7.x, PHP 8.1+.

composer require astroway/sdk-symfony:^0.1.0-alpha citeste ghidul SDK →
laravel lansat

Laravel ServiceProvider pentru AstroWay API

Oficial astroway/sdk-laravel pe Packagist - un ServiceProvider + facade deasupra astroway/sdk. Descoperit automat prin composer.json extra.laravel.providers, Astroway\Astroway înregistrat ca singleton de container, configurație publicată prin php artisan vendor:publish. Injectați în controlori sau folosiți facade-ul Astroway::post("/chart", ...). Funcționează cu Laravel 10/11/12, PHP 8.1+.

composer require astroway/sdk-laravel:^0.1.0-alpha citeste ghidul SDK →
go lansat

SDK Go pentru API-ul AstroWay

Modulul oficial AstroWay Go: fiecare endpoint API ca metodă, de exemplu aw.Chart.Compute, cu un context la fiecare apel. Reîncercările la 408/409/429/5xx respectă Retry-After, iar un POST păstrează un Idempotency-Key, deci un apel reîncercat nu se taxează de două ori. Erorile se verifică cu errors.Is, iar răspunsul se decodează în propriul tău tip. Standard library only, Go 1.22+.

go get github.com/astroway/astroway-go citeste ghidul SDK →
csharp lansat

SDK C# pentru API-ul AstroWay

Pachetul Astroway.Sdk: fiecare endpoint API ca metodă async, precum aw.Chart.ComputeAsync, anulabilă cu un CancellationToken. Reîncercările la 408/409/429/5xx respectă Retry-After, fiecare tip de eșec are propria excepție, iar răspunsul se deserializează în propriile tale recorduri. .NET Standard 2.0 și .NET 8: .NET Framework 4.7.2+, .NET 6/8/9, Unity.

dotnet add package Astroway.Sdk citeste ghidul SDK →

4 linii până la prima cerere

// TypeScript · același model în Python, PHP, Laravel, Symfony, React
npm install @astroway/sdk exemplu complet →
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

În curând

// roadmap · vom anunța la lansare

Propria ta împachetare

// OpenAPI 3.1 · limbajul tău, convențiile tale

Nu ai găsit limbajul tău în lista noastră? Toate endpointurile sunt descrise în specificația standardizată OpenAPI 3.1 - generează-ți propriul client prin openapi-generator sau stainless.