# 점성술 API를 구축하십시오. AstroWay

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

천문 API · v1

700+ 엔드포인트, 자체 SDK 3개, 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/)을(를) 참조하세요. 요금제 한도 및 대출 비용에 대한 엔드포인트별 세부 정보가 제공됩니다.

## 인증

세 가지 요금제. 선택하세요.

| 요금제 | 인증 | 제한 | 물결 무늬 |
| --- | --- | --- | --- |
| **익명** | 없음 | /v1/embed/* · 30 요청/시간당 IP당 | так |
| **무료 키** | `X-Api-Key: aw_live_…` | 10K 크레딧/월 | так |
| **유료** | `X-Api-Key: aw_live_…` | 50K / 200K / 800K / 3.5M | 아니요 |

### 도메인 바인딩

유료 키는 첫 번째 요청 시 하나의 도메인에 바인딩됩니다. 계정에서 직접 변경할 수 있으며, 한 달에 최대 3회까지 가능합니다. 워드프레스 플러그인을 설치하면 코드 변경 없이 X-AstroWay-Site-URL 헤더가 자동으로 전송됩니다.

### 오류 처리

- `401` — 누락 또는 잘못된 X-Api-Key
- `402` — 이 엔드포인트는 요금제에 포함되지 않음 (예: HD 엔드포인트 без HD Pack)
- `403` — 도메인 불일치 (바인딩된 도메인 ≠ Origin 헤더)
- `429` — 요청 한도 초과 또는 월별 크레딧 소진 (Retry-After 헤더 설정됨)

## 내장 위젯

직접 iframe - 자바스크립트 로더 없이 모든 HTML 사이트에서 동작합니다. 익명 요금제, 방문자 IP당 시간당 30회 요청.

### 일일 운세

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

### natal 차트 바퀴

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

### 타로 daily 차트

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

[WP용 AstroWay 플러그인 ↗](https://wordpress.org/plugins/astroway/) 설치 - Tier 1 위젯은 별도 설정 없이 즉시 사용 가능하며, 복사 가능한 숏코드와 Tier 2/3용 선택적 API 키를 제공합니다.

## 공식 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+ · 동기 + 비동기 · 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/)이(가)natal chart(출생 차트), horoscope(호로스코프), 타로, numerology(수비학), Human Design을 shortcode와 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 에이전트 탐지를 수행합니다. `/v1/context/*` 엔드포인트군은 ChatGPT / Claude / Gemini 통합에서 직접 소비할 수 있도록 LLM 최적화된 XML을 반환합니다.

### MCP 서버 (Pro+)

네이티브 서버 Model Context Protocol이 mcp.astroway.info에 있습니다. Claude Desktop 또는 모든 MCP 클라이언트를 연결하여 대화형으로 전체 API에 질의하세요. Pro 및 Business 요금제에 포함됩니다.