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

// sdk · clienți oficiali

SDK pentru 11 limbaje.

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. 8 limbaje în producție, 3 — în curs, 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 {endpoints}-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 →
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 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 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',
  },
});

console.log(chart.angles.asc);

Î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.