# Astrolojik API üzerinde inşa edin AstroWay

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

Astrolojik API · v1

700+ endpoint, üç özel SDK, Swiss Ephemeris doğruluğu. Anonim tarife - anahtarsız başlayın.

[Ücretsiz anahtar al](https://api.astroway.info/dashboard/sign-up) Hızlı başlangıç 10K kredisi/ay · kart gerekmez

## Hızlı başlangıç

API anahtarı olmadan günlük burç alın:

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

### Ücretsiz anahtarı kaydedin

[Ücretsiz anahtar al - 10K kredi/ay, kart gerekmez](https://api.astroway.info/dashboard/sign-up)

### Anahtarınızla ilk istek

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

Uç nokta başına kredi limitleri ve maliyetleri için [tarifler](https://astroway.info/shop/)'ye bakın.

## Kimlik Doğrulama

Üç tarif. Seçiminizi yapın.

| Tarif | Kimlik Doğrulama | Sınırlar | Yengeç |
| --- | --- | --- | --- |
| **Anonim** | anahtar olmadan | sadece /v1/embed/* · 30 istek/saat IP başına | evet |
| **Ücretsiz anahtar** | `X-Api-Key: aw_live_…` | 10K kredisi/ay | evet |
| **Ücretli** | `X-Api-Key: aw_live_…` | Indie 50K / Başlangıç 200K / Pro 800K / İş 3.5M | hayır (Pro+) |

### Alan adı bağlama

Ücretli anahtarlar, ilk istek sırasında tek bir domaine bağlanır. Bunu, ayda en fazla 3 kez, hesabınızda kendiniz değiştirebilirsiniz. WordPress eklentisinin kurulumu, kod değişikliği olmadan X-AstroWay-Site-URL başlığını otomatik olarak gönderir.

### Hata işleme

- `401` — X-Api-Key eksik veya geçersiz
- `402` — tarif bu uç noktayı kapsamaz (örn. HD uç noktası HD Pack olmadan)
- `403` — alan adı uyuşmazlığı (bağlı alan adı ≠ Origin başlığı)
- `429` — İstek sınırı aşıldı veya aylık krediler tükendi (Retry-After başlığı ayarlandı)

## Yerleşik widget'lar

Doğrudan iframe - herhangi bir HTML sitesinde çalışır, JS yükleme gerektirmez. Anonim tarife, ziyaretçi başına IP adresine göre 30 istek/saat.

### Günlük burç yorumu

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

### Natal haritanın tekerleği

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

### Günlük Tarot kartı

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

### Ay Evresi

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

### WordPress'e Kurulum

Kurun [AstroWay WP eklentisi ↗](https://wordpress.org/plugins/astroway/) - Tier 1 widget'leri ayar gerektirmez, kopyalamak için kısa kodlar, Tier 2/3 için isteğe bağlı API anahtarı.

## Resmi SDK'lar

Üç yerel SDK. OpenAPI 3.1'den üretilen tam tip güvenliği. MIT lisansı. Tekrar denemelerle, idempotent.

### 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'den oluşturuldu

### 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+ · senkron + asenkron · Pydantic modelleri · 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 istemcisi · Guzzle vaatleri

### WordPress

WordPress sitesi mi? [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) ücretsiz eklentisi, doğum haritaları, burç yorumları, Tarot, numeroloji ve Human Design'i kısa kodlar ve Gutenberg blokları aracılığıyla ekler - kod yazmadan. Anonim olarak veya kendi API anahtarınızla çalışır.

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

### LLM / AI ajanları

[/llms.txt ↗](https://api.astroway.info/llms.txt)'yi AI ajanlarının tespit etmesi için yayınlıyoruz. `/v1/context/*` uç nokta ailesi, ChatGPT / Claude / Gemini entegrasyonlarının doğrudan tüketimi için LLM'ler için optimize edilmiş XML döndürür.

### MCP sunucusu (Pro+)

mcp.astroway.info üzerindeki yerel Model Context Protocol sunucusu - Claude Desktop veya herhangi bir MCP istemcisi bağlayarak tüm API'yi sohbet modunda sorgulayın. Pro ve Business planlarında dahildir.
