메인 개발자 포털

천문 API · v1

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

700+ 엔드포인트, 자체 SDK 3개, Swiss Ephemeris 정밀도. 익명 요금제 - 키 없이 시작하세요.

$ curl "…/v1/embed/daily-horoscope?sign=virgo"

{
  "sign":         "virgo",
  "horoscope":    "Сьогодні сприятливий…",
  "lucky_number": 7
}

빠른 시작

API 키 없이 매일 운세 받아보기:

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

회원가입하여 무료 키를 받으십시오

무료 키 받기 - 월 10K 크레딧, 카드 없이

첫 번째 요청이 당신의 키로 전송되었습니다

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"

요금을(를) 참조하세요. 요금제 한도 및 대출 비용에 대한 엔드포인트별 세부 정보가 제공됩니다.

인증

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

요금제	인증	제한	물결 무늬
익명	없음	/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 플러그인 ↗ 설치 - 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 ↗ · npm ↗

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 ↗ · PyPI ↗

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 ↗ · Packagist ↗

PHP 8.2+ · PSR-18 HTTP 클라이언트 · Guzzle 프라미스

WordPress

WordPress 사이트인가요? 무료 플러그인 AstroWay для WordPress ↗이(가)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 ↗를 게시하여 AI 에이전트 탐지를 수행합니다. /v1/context/* 엔드포인트군은 ChatGPT / Claude / Gemini 통합에서 직접 소비할 수 있도록 LLM 최적화된 XML을 반환합니다.

MCP 서버 (Pro+)

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