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

// sdk · official clients

SDK для 11 мов.

Офіційні клієнти з повною типізацією, retry-логікою, intelligent rate-limiting. Запит у 4 рядках коду — без ручної роботи з cURL і headers. 8 мов в production, 3 — у роботі, всі генеруються з 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 для всіх {endpoints}+ ендпоінтів. 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 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 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',
  },
});

console.log(chart.angles.asc);

Coming soon

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

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

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

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