# Budujte na astrologickém API AstroWay

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

Astrologický API · v1

700+ endpoints, tři vlastní SDK, přesnost Swiss Ephemeris. Anonymní sazba - začněte bez klíče.

[Získat bezplatný klíč](https://api.astroway.info/dashboard/sign-up) Rychlý start 10K kreditů/měsíc · bez karty

## Rychlý start

Získejte denní horoskop bez API klíče:

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

### Zaregistrujte bezplatný klíč

[Získat bezplatný klíč - 10K kreditů/měsíc, bez karty](https://api.astroway.info/dashboard/sign-up)

### První požadavek s vaším klíčem

```
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"
```

Podívejte se na [tarify](https://astroway.info/shop/) pro limity tarifů a cenu kreditů za koncový bod.

## Autentifikace

Tři tarify. Vyberte si svůj.

| Tarif | Autentifikace | Limity | Vodnář |
| --- | --- | --- | --- |
| **Anonymní** | bez klíče | jen /v1/embed/* · 30 požadavků/hodinu na IP | ano |
| **Bezplatný klíč** | `X-Api-Key: aw_live_…` | 10 tisíc kreditů/měsíc | ano |
| **Placený** | `X-Api-Key: aw_live_…` | Indie 50 tis. / Starter 200 tis. / Pro 800 tis. / Business 3,5 mil. | ne (Pro+) |

### Vazba na doménu

Placené klíče jsou při prvním požadavku vázány na jednu doménu. Můžete ji změnit samostatně v kabinetu, až 3krát za měsíc. Instalace WordPress pluginu automaticky odesílá hlavičku X-AstroWay-Site-URL - bez změny kódu.

### Zpracování chyb

- `401` — chybí nebo neplatný X-Api-Key
- `402` — tarif nezahrnuje tento endpoint (např. HD endpoint bez HD Pack)
- `403` — nesoulad domény (vázaná doména ≠ hlavička Origin)
- `429` — překročen limit požadavků nebo vyčerpány měsíční kredity (nastaven hlavička Retry-After)

## Vestavěné widgety

Přímý iframe - funguje na jakémkoliv HTML webu, bez JS načítacího skriptu. Anonymní tarifa, 30 požadavků/hodinu na IP návštěvníka.

### Denní horoskop

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

### Kolo nativního horoskopu

```
<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>
```

### Karta dne Tarot

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

### Fáze Měsíce

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

### Instalace pro WordPress

Nainstalujte [plugin AstroWay pro WP ↗](https://wordpress.org/plugins/astroway/) - widgety Tier 1 bez nastavení, shortcode pro kopírování, volitelný API klíč pro Tier 2/3.

## Oficiální SDK

Tři vlastní SDK. Plná typová bezpečnost, generované z OpenAPI 3.1. Licence MIT. S opakováním pokusů, idempotentní.

### 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 · vygenerováno 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 · modely 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+ · PSR-18 HTTP klient · promisy Guzzle

### WordPress

Web na WordPress? Bezplatný plugin [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) přidává narativní mapy, horoskopy, Tarot, numerologii a Human Design prostřednictvím shortkodů a bloků Gutenberg - bez kódu. Pracuje anonymně nebo s vaším API klíčem.

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

### LLM / AI-agenti

Publikujeme [/llms.txt ↗](https://api.astroway.info/llms.txt) pro detekci AI-agenty. Rodina endpointů `/v1/context/*` vrací XML optimalizovaný pro LLM pro přímé využití integracemi ChatGPT / Claude / Gemini.

### MCP-server (Pro+)

Nativní server Model Context Protocol na mcp.astroway.info – připojte Claude Desktop nebo jakýkoli MCP klient a dotazujte se na celé API v dialogovém režimu. Součástí tarifů Pro a Business.
