# Bangun dengan API Astrologi AstroWay

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

API Astrologi · v1

700+ endpoint, tiga SDK pribadi, akurasi Swiss Ephemeris. Tarif anonim - mulai tanpa kunci.

[Dapatkan kunci gratis](https://api.astroway.info/dashboard/sign-up) Mulai cepat 10K kredit/bulan · tanpa kartu

## Mulai cepat

Dapatkan horoskop harian tanpa kunci API:

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

### Daftarkan kunci gratis

[Dapatkan kunci gratis - 10K kredit/bulan, tanpa kartu](https://api.astroway.info/dashboard/sign-up)

### Permintaan pertama dengan kunci Anda

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

Lihat [tarif](https://astroway.info/shop/) untuk batas tarif dan biaya kredit per endpoint.

## Autentikasi

Tiga paket. Pilih milik Anda.

| Tarif | Autentikasi | Batas | Tanda Air |
| --- | --- | --- | --- |
| **Anonim** | tanpa kunci | hanya \/v1\/embed\/* · 30 permintaan\/jam per IP | ya |
| **Kunci gratis** | `X-Api-Key: aw_live_…` | 10K kredit\/bulan | ya |
| **Berbayar** | `X-Api-Key: aw_live_…` | Indie 50K \/ Starter 200K \/ Pro 800K \/ Business 3.5M | tidak (Pro+) |

### Pengikatan ke domain

Kunci berbayar diikat ke satu domain pada permintaan pertama. Anda dapat mengubahnya sendiri di panel, hingga 3 kali per bulan. Instalasi plugin WordPress secara otomatis mengirim header X-AstroWay-Site-URL - tanpa mengubah kode.

### Penanganan kesalahan

- `401` — X-Api-Key tidak ada atau tidak valid
- `402` — tarif tidak mencakup endpoint ini (misalnya endpoint HD tanpa HD Pack)
- `403` — ketidakcocokan domain (domain yang terhubung tidak sama dengan header Origin)
- `429` — melebihi batas permintaan atau kredit bulan habis (diatur header Retry-After)

## Widget yang disematkan

Iframe langsung - bekerja di setiap situs HTML, tanpa pemuat JS. Tarif anonim, 30 permintaan\/jam pada IP pengunjung.

### Ramalan Harian

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

### Rodakarta lahir

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

### Kartu harian Tarot

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

### Fase Bulan

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

### Pasang di WordPress

Pasang [plugin AstroWay untuk WP ↗](https://wordpress.org/plugins/astroway/) - widget Tier 1 tanpa konfigurasi, shortcode untuk menyalin, kunci API opsional untuk Tier 2\/3.

## SDK Resmi

Tiga SDK asli. Keamanan tipe penuh, dihasilkan dari OpenAPI 3.1. Lisensi MIT. Dengan percobaan ulang, idempoten.

### 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 · dihasilkan dari 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+ · sinkron + asinkron · model 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+ · Klien HTTP PSR-18 · promise Guzzle

### WordPress

Situs WordPress? Plugin gratis [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) menambahkan bagan kelahiran, horoskop, Tarot, numerologi, dan Human Design melalui shortcode dan blok Gutenberg - tanpa kode. Berfungsi secara anonim atau dengan kunci API Anda.

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

### LLM / Agen AI

Kami mempublikasikan [/llms.txt ↗](https://api.astroway.info/llms.txt) untuk deteksi oleh agen AI. Keluarga endpoint `/v1/context/*` mengembalikan XML yang dioptimalkan untuk LLM untuk konsumsi langsung oleh integrasi ChatGPT / Claude / Gemini.

### Server MCP (Pro+)

Server native Model Context Protocol di mcp.astroway.info - hubungkan Claude Desktop atau klien MCP apa pun untuk menanyakan seluruh API dalam mode dialog. Termasuk dalam paket Pro dan Business.
