AstroWay/api v2.254.12 · pl
wszystkie systemy w normie

// sdk · official clients

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

Oficjalni klienci z pełną typizacją, retry-logiką, intelligent rate-limiting. Zapytanie w 4 wierszach kodu - bez ręcznej pracy z cURL i nagłówkami. W przygotowaniu: Ruby, Rust. Wszystkie generowane z OpenAPI 3.1.

Wydanego

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

Hostowane MCP - brak instalacji dla Claude Web / Desktop / Cursor

Hostowany punkt końcowy HTTP pod adresem mcp.astroway.info/mcp - ten sam katalog ponad 700 narzędzi co w pakiecie npm, bez lokalnej instalacji. Jedna URL, jeden nagłówek Bearer i twój klient AI widzi cały ekosystem AstroWay. Wielo-użytkownikowy: punkty pobierane są z konta, które posiada twój klucz Bearer.

https://mcp.astroway.info/mcp przeczytaj przewodnik SDK →
mcp wydane

Serwer MCP (stdio) dla Claude / Cursor / GPT

Oficjalny @astroway/mcp: udostępnia wszystkie 700+ punktów końcowych API AstroWay jako narzędzia dla agentów AI. Działa z klientami MCP Claude Desktop, Cursor, GPT. Tryb stdio - twój klucz pozostaje na twoim urządzeniu, bez skoków sieciowych. W przypadku scenariuszy bez instalacji użyj zamiast tego hostowanego punktu końcowego.

npx -y @astroway/mcp przeczytaj przewodnik SDK →
typescript wydane

SDK TypeScript dla API AstroWay

Oficjalne @astroway/sdk - cienka warstwa nad openapi-fetch (~6 KB czasu wykonywania). Autouzupełnianie ścieżek + typy żądania/odpowiedzi w Twoim IDE dla wszystkich 771+ punktów końcowych. Hierarchia błędów w stylu Stainless, wbudowane ponawianie przy 408/409/429/5xx, OIDC + SLSA L3 pochodzenie.

npm install @astroway/sdk przeczytaj przewodnik SDK →
python wydane

SDK Python dla API AstroWay

Oficjalne astroway na PyPI - Astroway (sync) + AsyncAstroway (async) na podstawie httpx. Identyczna powierzchnia - ta sama API na obu klientach. Hierarchia błędów w stylu Stainless, ponowne wykonywanie przy 408/409/429/5xx, pakiet PEP 561 z typami. Python 3.9+, Zaufany Wydawca OIDC.

pip install astroway przeczytaj przewodnik SDK →
php wydane

Zestaw SDK PHP dla API AstroWay

Oficjalny astroway/sdk na Packagist - zbudowany na Guzzle 7 + PSR-18. PHP 8.1+ (właściwości tylko do odczytu, promocja konstruktora). Hierarchia błędów w stylu Stainless, wbudowane środowisko retry dla 408/409/429/5xx, dwa schematy uwierzytelniania (X-Api-Key domyślnie lub Bearer).

composer require astroway/sdk przeczytaj przewodnik SDK →
react wydane

Towarzysz React dla @astroway/sdk

Oficjalne @astroway/react na npm - cienka otoczka w stylu Stripe nad @astroway/sdk. AstrowayProvider podnosi klienta do kontekstu React; hooki useAstroway, useAstrowayQuery, useNatalChart zwracają potrójne { data, error, loading } w stylu SWR z zerowymi zależnościami zewnętrznymi. Działa z React 18+, Next.js App Router (za pomocą "use client"), Vite, CRA.

npm install @astroway/react @astroway/sdk react przeczytaj przewodnik SDK →
ui wydane

AstroWay komponenty internetowe (alpha)

Koło natalne, faza księżyca, kompatybilność, tarot i horoskop jako zwykłe elementy HTML dla każdej strony: jeden znacznik <script> z CDN lub npm install. Wykresy są rysowane tym samym kodem co API, więc koło na twojej stronie odpowiada temu, co zwraca /v1/render. Alpha: nazwy atrybutów mogą się jeszcze zmienić przed 1.0.

npm install @astroway/ui@alpha przeczytaj przewodnik SDK →
symfony wydane

Pakiet Symfony dla API AstroWay

Oficjalny astroway/sdk-symfony na Packagist - pakiet oparty na astroway/sdk. Auto-rejestracja za pomocą Symfony Flex, konfigurowany przez standardowy config/packages/astroway.yaml, udostępnia autowire'owalną usługę Astroway\Astroway do wstrzyknięcia w dowolny kontroler lub usługę. Kompatybilny z Symfony 6.4 LTS i 7.x, PHP 8.1+.

composer require astroway/sdk-symfony:^0.1.0-alpha przeczytaj przewodnik SDK →
laravel wydane

Dostawca usług Laravel dla API AstroWay

Oficjalny astroway/sdk-laravel na Packagist - dostawca usług + fasada na podstawie astroway/sdk. Automatycznie wykrywany za pomocą composer.json extra.laravel.providers, Astroway\Astroway zarejestrowany jako singleton kontenera, konfiguracja opublikowana za pomocą php artisan vendor:publish. Wstrzyknij do kontrolerów lub użyj fasady Astroway::post("/chart", ...) . Działa z Laravel 10/11/12, PHP 8.1+.

composer require astroway/sdk-laravel:^0.1.0-alpha przeczytaj przewodnik SDK →
go wydane

SDK Go dla API AstroWay

Oficjalny moduł AstroWay dla Go: każdy endpoint API jako metoda, np. aw.Chart.Compute, z context przy każdym wywołaniu. Ponowienia przy 408/409/429/5xx respektują Retry-After, a POST zachowuje jeden Idempotency-Key, więc ponowione wywołanie nie jest obciążane dwa razy. Błędy testujesz przez errors.Is, a odpowiedź dekoduje się do twojego własnego typu. Tylko biblioteka standardowa, Go 1.22+.

go get github.com/astroway/astroway-go przeczytaj przewodnik SDK →
csharp wydane

C# SDK dla API AstroWay

Pakiet Astroway.Sdk: każdy endpoint API jako metoda async, np. aw.Chart.ComputeAsync, anulowalna przy użyciu CancellationToken. Ponowne próby przy 408/409/429/5xx respektują Retry-After, każdy rodzaj błędu ma własny wyjątek, a odpowiedź deserializuje się do twoich rekordów. .NET Standard 2.0 i .NET 8: .NET Framework 4.7.2+, .NET 6/8/9, Unity.

dotnet add package Astroway.Sdk przeczytaj przewodnik SDK →

4 wiersze do pierwszego zapytania

// TypeScript · ten sam wzorzec w Python, PHP, Laravel, Symfony, React
npm install @astroway/sdk pełny przykład →
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

Wkrótce

// roadmap · powiadomimy, gdy wyjdzie

Własna otoczka

// OpenAPI 3.1 · twój język, twoje konwencje

Nie znaleziono swojego języka na liście? Wszystkie endpointy opisane są w standardzie OpenAPI 3.1 spec - wygeneruj własnego klienta za pomocą openapi-generator lub stainless.