AstroWay/api v2.201.7 · sdks
усі системи в нормі

// sdk · official clients

SDK для TypeScript, Python, PHP.

Офіційні клієнти з повною типізацією, retry-логікою, intelligent rate-limiting. Запит у 4 рядках коду - без ручної роботи з cURL і headers. У роботі: Go, Ruby, Rust. Усі генеруються з OpenAPI 3.1.

Released

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

Hosted MCP - zero-install для Claude Web / Desktop / Cursor

Hosted Streamable HTTP endpoint на mcp.astroway.info/mcp - той самий каталог 700+ інструментів, що і npm-пакет, але без локальної установки. Один URL, один Bearer header - і AI-клієнт бачить всю AstroWay-екосистему. Multi-tenant: кредити списуються з акаунта вашого ключа.

https://mcp.astroway.info/mcp read SDK guide →
mcp released

MCP сервер (stdio) для Claude / Cursor / GPT

Офіційний @astroway/mcp: експонує всі 700+ endpoint-ів AstroWay API як інструменти для AI-агентів. Працює з Claude Desktop, Cursor, GPT MCP-клієнтами. Stdio mode - ключ залишається на вашій машині, без мережевих хопів. Альтернатива - hosted endpoint без npm install.

npx -y @astroway/mcp read SDK guide →
typescript released

TypeScript SDK для AstroWay API

Офіційний @astroway/sdk - обгортка над openapi-fetch (~6 КБ runtime). Path autocomplete + типи запитів і відповідей з вашої IDE для всіх 760+ ендпоінтів. Stainless-style ієрархія помилок, вбудований retry на 408/409/429/5xx, OIDC + SLSA L3 provenance.

npm install @astroway/sdk read SDK guide →
python released

Python SDK для AstroWay API

Офіційний astroway на PyPI - Astroway (sync) + AsyncAstroway (async) на базі httpx. Identical surface - той самий API в обох клієнтах. Stainless-style ієрархія помилок, retry на 408/409/429/5xx, PEP 561 typed package. Python 3.9+, Trusted Publisher OIDC.

pip install astroway read SDK guide →
php released

PHP SDK для AstroWay API

Офіційний astroway/sdk на Packagist - побудований на Guzzle 7 + PSR-18. PHP 8.1+ (readonly properties, constructor promotion). Stainless-style ієрархія помилок, вбудований retry middleware на 408/409/429/5xx, два auth-схеми (X-Api-Key default або Bearer).

composer require astroway/sdk read SDK guide →
react released

React companion для @astroway/sdk

Офіційний @astroway/react на npm - тонка обгортка над @astroway/sdk у Stripe-стилі. AstrowayProvider піднімає клієнт через React context, хуки useAstroway, useAstrowayQuery, useNatalChart повертають SWR-подібний { data, error, loading } без зовнішніх залежностей. Працює з React 18+, Next.js App Router (через "use client"), Vite, CRA.

npm install @astroway/react @astroway/sdk react read SDK guide →
symfony released

Symfony Bundle для AstroWay API

Офіційний astroway/sdk-symfony на Packagist - Bundle поверх astroway/sdk. Auto-реєстрація через Symfony Flex, конфіг через стандартний config/packages/astroway.yaml, autowireable сервіс Astroway\Astroway для inject у будь-який контролер чи service. Працює із Symfony 6.4 LTS та 7.x, PHP 8.1+.

composer require astroway/sdk-symfony:^0.1.0-alpha read SDK guide →
laravel released

Laravel ServiceProvider для AstroWay API

Офіційний astroway/sdk-laravel на Packagist - ServiceProvider + facade поверх astroway/sdk. Auto-discovered через composer.json extra.laravel.providers, Astroway\Astroway як singleton у контейнері, конфіг публікується через php artisan vendor:publish. Inject у controller або через facade Astroway::post("/chart", ...). Працює із Laravel 10/11/12, PHP 8.1+.

composer require astroway/sdk-laravel:^0.1.0-alpha read SDK guide →

4 рядки до першого запиту

// TypeScript · той самий патерн у Python, PHP, Laravel, Symfony, React
npm install @astroway/sdk повний приклад →
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

Coming soon

// roadmap · сповістимо коли вийде

Своя обгортка

// OpenAPI 3.1 · ваша мова, ваші конвенції

Не знайшли свою мову серед нашого списку? Усі ендпоінти описані у стандартизованому OpenAPI 3.1 spec - згенеруйте власний клієнт через openapi-generator або stainless.