# Buduj na interfejsie API astrologicznym AstroWay

Source: https://astroway.info/pl/developers/
Language: pl
Updated: 2026-05-28

Interfejs API astrologicznego · v1

700+ punktów końcowych, trzy własne SDK, dokładność Swiss Ephemeris. Taryfa anonimowa - zacznij bez klucza.

[Pobierz bezpłatny klucz](https://api.astroway.info/dashboard/sign-up) Szybki start 10K kredytów/miesiąc · bez karty

## Szybki start

Otrzymaj dzienny horoskop bez klucza API:

```
curl "https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
```

### Zarejestruj darmowy klucz

[Uzyskaj darmowy klucz - 10K punktów/miesiąc, bez karty](https://api.astroway.info/dashboard/sign-up)

### Pierwsze zapytanie z Twoim kluczem

```
curl -G "https://api.astroway.info/v1/chart" \
-H "X-Api-Key: aw_live_…" \
--data-urlencode "datetime=1990-06-15T14:30:00+03:00" \
--data-urlencode "lat=50.45" --data-urlencode "lon=30.52"
```

Zobacz [taryfy](https://astroway.info/shop/) dla limitów taryf i kosztów kredytów za punkt końcowy.

## Uwierzytelnianie

Trzy taryfy. Wybierz swoją.

| Taryfa | Uwierzytelnianie | Limity | Znak wodny |
| --- | --- | --- | --- |
| **Anonimowy** | bez klucza | tylko /v1/embed/* · 30 zapytań/godz. na IP | tak |
| **Darmowy klucz** | `X-Api-Key: aw_live_…` | 10K punktów/miesiąc | tak |
| **Płatny** | `X-Api-Key: aw_live_…` | Indie 50K / Starter 200K / Pro 800K / Business 3,5M | nie (Pro+) |

### Przypisanie do domeny

Płatne klucze są przypisywane do jednej domeny podczas pierwszego żądania. Można ją zmienić samodzielnie w panelu użytkownika, do 3 razy w miesiącu. Instalacja wtyczki WordPress automatycznie wysyła nagłówek X-AstroWay-Site-URL - bez modyfikacji kodu.

### Obsługa błędów

- `401` — brak lub nieprawidłowy X-Api-Key
- `402` — taryfa nie obejmuje tego punktu końcowego (np. punktu końcowego HD bez pakietu HD)
- `403` — niezgodność domeny (przypisana domena ≠ nagłówek Origin)
- `429` — Przekroczono limit zapytań lub wyczerpane miesięczne limity (ustawiono nagłówek Retry-After).

## Wbudowane widżety

Bezpośredni iframe - działa na każdej stronie HTML bez ładowania JavaScript. Anonimowy pakiet, 30 zapytań/godz. na IP odwiedzającego.

### Dzienny horoskop

```
<iframe src="https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
width="100%" height="320" loading="lazy" frameborder="0"></iframe>
```

### Kołowy układ horoskopu urodzeniowego

```
<iframe src="https://api.astroway.info/v1/embed/natal-wheel?datetime=1990-06-15T14:30:00%2B03:00&lat=50.45&lon=30.52"
width="600" height="600" loading="lazy" frameborder="0"></iframe>
```

### Horoskop dnia Tarota

```
<iframe src="https://api.astroway.info/v1/embed/tarot-daily?deck=rider-waite"
width="400" height="500" loading="lazy" frameborder="0"></iframe>
```

### Faza Księżyca

```
<iframe src="https://api.astroway.info/v1/embed/moon-phase"
width="320" height="320" loading="lazy" frameborder="0"></iframe>
```

### Instalacja na WordPress

Ustaw [wtyczka AstroWay dla WP ↗](https://wordpress.org/plugins/astroway/) - widgety Tier 1 bez ustawień, skróty dla kopiowania, opcjonalny klucz API dla Tier 2/3.

## Oficjalne SDK

Trzy własne SDK. Pełna bezpieczeństwo typów, wygenerowane z OpenAPI 3.1. Licencja MIT. Z ponownymi próbami, idempotentne.

### TypeScript / JavaScript

@astroway/sdk · v1.1.0

```
npm install @astroway/sdk
```

```
import { AstroWayClient } from '@astroway/sdk';
const c = new AstroWayClient({ apiKey: process.env.ASTROWAY_KEY });
const chart = await c.natalChart({
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52
});
```

[GitHub ↗](https://github.com/astroway/astroway-typescript) · [npm ↗](https://www.npmjs.com/package/@astroway/sdk)

Node 22+ · ESM · wygenerowane z OpenAPI 3.1

### Python

astroway · v1.1.0

```
pip install astroway
```

```
from astroway import AstroWayClient
c = AstroWayClient(api_key="aw_live_…")
chart = c.natal_chart(
datetime="1990-06-15T14:30:00+03:00",
lat=50.45, lon=30.52,
)
```

[GitHub ↗](https://github.com/astroway/astroway-python) · [PyPI ↗](https://pypi.org/project/astroway/)

Python 3.10+ · sync + async · modele Pydantic · py.typed

### PHP

astroway/sdk · v1.1.0

```
composer require astroway/sdk
```

```
use AstroWay\AstroWayClient;
$c = new AstroWayClient(apiKey: 'aw_live_…');
$chart = $c->natalChart(
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52,
);
```

[GitHub ↗](https://github.com/astroway/astroway-php) · [Packagist ↗](https://packagist.org/packages/astroway/sdk)

PHP 8.2+ · klient HTTP PSR-18 · promesy Guzzle

### WordPress

Czy strona działa na WordPress? Darmowa wtyczka [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) dodaje mapy urodzeniowe, horoskopy, Tarota, numerologię i Human Design za pomocą skrótów i bloków Gutenberg - bez kodowania. Działa anonimowo lub z Twoim kluczem API.

```
[astroway_natal date="1990-06-15" time="14:30" lat="50.45" lon="30.52"]
```

### LLM / agenci AI

Publikujemy [/llms.txt ↗](https://api.astroway.info/llms.txt) w celu wykrywania przez agentów AI. Rodzina punktów końcowych `/v1/context/*` zwraca zoptymalizowany pod kątem LLM format XML do bezpośredniego wykorzystania przez integracje z ChatGPT, Claude lub Gemini.

### Serwer MCP (Pro+)

Natywna implementacja protokołu Model Context Protocol na mcp.astroway.info - podłącz aplikację Claude Desktop lub dowolnego klienta MCP, aby w trybie konwersacyjnym zapytywać całe API. Uwzględnione w pakietach Pro i Business.