# Χτίστε στο αστρολογικό API AstroWay

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

Αστρολογικό API · v1

700+ endpoints, τρία ιδιόκτητα SDK, ακρίβεια Swiss Ephemeris. Ανώνυμο πακέτο - ξεκινήστε χωρίς κλειδί

[Λάβετε δωρεάν κλειδί](https://api.astroway.info/dashboard/sign-up) Γρήγορη εκκίνηση 10K πίστωσης/μήνα · χωρίς κάρτα

## Γρήγορη εκκίνηση

Λάβετε την ημερήσια αστρολογική πρόβλεψη χωρίς κλειδί API:

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

### Εγγραφή για δωρεάν κλειδί

[Λάβετε δωρεάν κλειδί - 10K πιστώσεις/μήνα, χωρίς κάρτα](https://api.astroway.info/dashboard/sign-up)

### Πρώτο αίτημα με το κλειδί

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

Δείτε [Ταρίφες](https://astroway.info/shop/) για τα όρια των τιμολογίων και το κόστος των δανείων ανά endpoint.

## Αυθεντικοποίηση

Τρία πακέτα. Επιλέξτε το δικό σας.

| Ταράρι | Αυθεντικοποίηση | Όρια | Υδάτιο ζodiacίο |
| --- | --- | --- | --- |
| **Ανώνυμος** | χωρίς κλειδί | μόνο /v1/embed/* · 30 αιτήματα/ώρα ανά IP | ναι |
| **Δωρεάν κλειδί** | `X-Api-Key: aw_live_…` | 10K πίστωσης/μήνα | ναι |
| **Πληρωτικό** | `X-Api-Key: aw_live_…` | Δεν παρέχεται κείμενο για μετάφραση από ουκρανικά. | όχι (Pro+) |

### Σύνδεση με τομέα

Πληρωμένα κλειδιά συνδέονται με ένα domain κατά τον πρώτο αίτημα. Μπορείτε να το αλλάξετε μόνοι σας στο πίνακα ελέγχου, έως 3 φορές τον μήνα. Η εγκατάσταση του WordPress plugin στέλνει αυτόματα την κεφαλίδα X-AstroWay-Site-URL - χωρίς αλλαγή κώδικα.

### Διαχείριση σφαλμάτων

- `401` — Απών ή μη έγκυρο X-Api-Key
- `402` — η συνδρομή δεν περιλαμβάνει αυτό το endpoint (π.χ. HD endpoint χωρίς το πακέτο HD)
- `403` — Ασυμφωνία τομέα (συνδεδεμένος τομέας ≠ κεφαλίδα Origin)
- `429` — Εξαντλήθηκε το όριο αιτημάτων ή τα μηνιαία πιστώσεις (έχει οριστεί το κεφαλίδιο Retry-After)

## Ενσωματωμένα widgets

Άμεσος iframe - λειτουργεί σε οποιοδήποτε HTML site, χωρίς JS φορτωτή. Ανώνυμος τιμοκατάλογος, 30 αιτήματα/ώρα ανά IP επισκέπτη.

### Καθημερινό ωροσκόπιο

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

### Τροχός του γεννηματολογικού χάρτη

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

### Κάρτα της ημέρας Τάρο

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

### Φάση Σελήνης

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

### Εγκατάσταση σε WordPress

Εγκαταστήστε [πρόσθετο AstroWay για WP ↗](https://wordpress.org/plugins/astroway/) - widgets Tier 1 χωρίς ρυθμίσεις, shortcodes για αντιγραφή, προαιρετικό API κλειδί για Tier 2/3.

## Επίσημα SDK

Τρία δικά μας SDK. Πλήρης ασφάλεια τύπων, γεννημένα από το OpenAPI 3.1. Άδεια MIT. Με επαναλήψεις, ιδεμοποτεντικά.

### 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 · δημιουργήθηκε από 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 · 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 πελάτης · υποσχέσεις Guzzle

### WordPress

Ο ιστότοπός σας είναι σε WordPress; Η δωρεάν επέκταση [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) προσθέτει χάρτες γέννησης, ωροσκόπια, Ταρό, αριθμολογία και Human Design μέσω σύντομων κωδικών και μπλοκ Gutenberg - χωρίς κώδικα. Λειτουργεί ανώνυμα ή με το κλειδί API σας.

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

### LLM / AI-πράκτορες

Εκδίδουμε [/llms.txt ↗](https://api.astroway.info/llms.txt) για ανίχνευση από AI πράκτορες. Η οικογένεια endpoint `/v1/context/*` επιστρέφει XML βελτιστοποιημένο για LLM για άμεση κατανάλωση από ενσωματώσεις ChatGPT / Claude / Gemini.

### Διακομιστής MCP (Pro+)

Νατικός διακομιστής Πρωτοκόλλου Πλαισίου Μοντέλου (Model Context Protocol) στο mcp.astroway.info - συνδέστε το Claude Desktop ή οποιοδήποτε πελάτη MCP για να κάνετε ερωτήσεις σε ολόκληρο το API σε λειτουργία διαλόγου. Περιλαμβάνεται στις τιμολογήσεις Pro και Business.
