# Construiți pe API-ul astrologic AstroWay

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

API astrologic · v1

700+ endpoint-urilor, trei SDK proprii, precizie Swiss Ephemeris. Tarif anonim - începeți fără cheie.

[Obțineți o cheie gratuită](https://api.astroway.info/dashboard/sign-up) Pornire rapidă 10K credite/lună · fără card

## Pornire rapidă

Obțineți horoscop zilnic fără cheie API:

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

### Înregistrați o cheie gratuită

[Obțineți cheia gratuită - 10K credite/lună, fără card](https://api.astroway.info/dashboard/sign-up)

### Prima cerere cu cheia dvs.

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

Consultați [tarife](https://astroway.info/shop/) pentru limitele tarifelor și costul creditelor pe endpoint.

## Autentificare

Trei tarife. Alege-ți unul.

| Tarif | Autentificare | Limite | Semn al Peștilor |
| --- | --- | --- | --- |
| **Anonim** | fără cheie | doar /v1/embed/* · 30 cereri/oră per IP | da |
| **Cheie gratuită** | `X-Api-Key: aw_live_…` | 10K credite/lună | da |
| **Plat** | `X-Api-Key: aw_live_…` | Indie 50K / Starter 200K / Pro 800K / Business 3.5M | nu (Pro+) |

### Legare la domeniul

Cheilele plătite sunt asociate cu un singur domeniu la prima solicitare. Puteți modifica acest singur în contul dvs., de până la 3 ori pe lună. Instalarea pluginului WordPress trimite automat antetul X-AstroWay-Site-URL - fără a modifica codul.

### Gestionarea erorilor

- `401` — X-Api-Key lipsă sau invalid
- `402` — tariful nu include acest endpoint (de ex. endpoint HD fără HD Pack)
- `403` — incoerență de domeniu (domeniu atașat ≠ antet Origin)
- `429` — Limita de cereri depășită sau creditele lunare epuizate (antetul Retry-After a fost setat)

## Widgeturi integrate

Iframe direct - works on any HTML site, without a JS loader. Anonymous plan, 30 requests/hour per visitor IP.

### Zilnic horoscop

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

### Rotița hărții natale

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

### Carte de astăzi Tarot

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

### Faza Lunii

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

### Instalare pe WordPress

Instalează [plugin AstroWay pentru WP ↗](https://wordpress.org/plugins/astroway/) - widgeturi Tier 1 fără setări, scurtcoduri pentru copiere, cheie API opțională pentru Tier 2/3.

## SDK-uri oficiale

Trei SDK-uri proprii. Siguranță completă a tipurilor, generate din OpenAPI 3.1. Licență MIT. Cu reîncercări, idempotente.

### 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 · generat din 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+ · PSR-18 HTTP-client · promisiuni Guzzle

### WordPress

Site pe WordPress? Pluginul gratuit [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) adaugă hărți natale, horoscop, Tarot, numerologie și Human Design prin shortcode-uri și blocuri Gutenberg - fără cod. Funcționează anonim sau cu cheia ta API.

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

### LLM / agenți AI

Publicăm [/llms.txt ↗](https://api.astroway.info/llms.txt) pentru a fi detectat de agenții AI. Familia de endpoint-uri `/v1/context/*` returnează XML optimizat pentru LLM pentru consum direct prin integrările ChatGPT / Claude / Gemini.

### MCP-server (Pro+)

Server nativ Model Context Protocol pe mcp.astroway.info - conectați-vă la Claude Desktop sau orice client MCP pentru a interoga întregul API în mod dialogal. Inclus în tarifele Pro și Business.
