# Építs az asztrológiai API-n AstroWay

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

Asztrológiai API · v1

700+ végpont, három saját SDK, Swiss Ephemeris pontosság. Anonim csomag - kezdjen kulcs nélkül.

[Kapj ingyenes kulcsot](https://api.astroway.info/dashboard/sign-up) Gyors indítás 10K kredit/hónap · kártya nélkül

## Gyors indítás

Kapjon napi horoszkópot API-kulcs nélkül:

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

### Regisztrálj ingyenes kulcsot

[Kapj ingyenes kulcsot - 10K kredit/hónap, kártya nélkül](https://api.astroway.info/dashboard/sign-up)

### Első kérés az Ön kulcsával

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

Nézze [díjak](https://astroway.info/shop/) a díjkorlátok és hitelköltségek végponton.

## Hitelesítés

Három tarif. Válassza ki az övét.

| díjcsomag | Hitelesítés | Limit | Víz jegy |
| --- | --- | --- | --- |
| **Anonim** | kulcs nélkül | Csak /v1/embed/* · 30 kérés/óra IP-nként | igen |
| **Ingyenes kulcs** | `X-Api-Key: aw_live_…` | 10K kredit/hónap | igen |
| **Fizetős** | `X-Api-Key: aw_live_…` | Indie 50K / Kezdő 200K / Pro 800K / Vállalati 3.5M | nem (Pro+) |

### Domain kötés

Prémium kulcsok egyetlen domainhez kötődnek az első kérés során. A domain megváltoztatható önállóan a felhasználói felületen, havonta legfeljebb 3 alkalommal. A WordPress bővítmény telepítése automatikusan elküldi az X-AstroWay-Site-URL fejlécet - kód módosítása nélkül.

### Hibakezelés

- `401` — Hiányzó vagy érvénytelen X-Api-Key
- `402` — Díjcsomag nem tartalmazza ezt a végpontot (pl. HD-végpont HD Csomag nélkül)
- `403` — tartományeltérés (kötött tartomány ≠ Origin fejléc)
- `429` — Kérési korlát túllépve vagy havi kredsek kimerültek (Retry-After fejléc beállítva)

## Beépített widgetek

Közvetlen iframe - működik bármilyen HTML oldalon, JS-letöltő nélkül. Anonim csomag, 30 kérés/óra IP címenként.

### Napi horoszkóp

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

### Születési horoszkóp keréke

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

### Napi Tarot lap

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

### Holdfázis

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

### Telepítés a WordPressre

Állítsd be [AstroWay plugin a WP-hez ↗](https://wordpress.org/plugins/astroway/) - Tier 1 widgetek beállítások nélkül, másolható shortcodes, opcionális API-kulcs a Tier 2/3-hoz.

## Hivatalos SDK

Három saját SDK. Teljes típusbiztonság, OpenAPI 3.1-ből generálva. MIT licenc. Újrapróbálkozással, idempotens.

### 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 · generálva ezzel 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 · Pydantic modellek · 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-kliens · promise-ok Guzzle

### WordPress

Saját WordPress weboldal? A(z) [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) ingyenes bővítmény natalis chartokat, horoszkópokat, Tarotot, numerológiát és Human Design-t ad hozzá shortcode-ok és Gutenberg blokkok segítségével - kódolás nélkül. Anonim módban vagy saját API kulcsoddal működik.

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

### LLM / MI-ügynökök

Mi publikáljuk [/llms.txt ↗](https://api.astroway.info/llms.txt)-t az AI ügynökök által történő észleléshez. A(z) `/v1/context/*` végpontcsalád az LLM-ek számára optimalizált XML-t ad vissza közvetlen felhasználásra a ChatGPT / Claude / Gemini integrációk számára.

### MCP-szerver (Pro+)

Natív Model Context Protocol szerver a mcp.astroway.info címen - csatlakozzon a Claude Desktophoz vagy bármely MCP klienshez, hogy API-t kérdezzen párbeszéd módban. Be van építve a Pro és Business tarifákba.
