メイン開発者ポータル

アストロロジカル API · v1

アストロロジカル API で構築 AstroWay

700 以上のエンドポイント、3 つの独自 SDK、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"

登録して無料のキーを取得

無料キーの取得 - 1ヶ月あたり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"

料金プランを参照してください。料金プランの制限とエンドポイントごとのクレジットのコスト

認証

3つの料金プラン。あなたに合ったプランをお選びください。

料金プラン	認証	制限	ウォーターマーク
匿名	鍵なし	/v1/embed/* のみ · IPあたり30リクエスト/時	はい
無料鍵	`X-Api-Key: aw_live_…`	月10,000クレジット	はい
有料	`X-Api-Key: aw_live_…`	インディー 50K / スターター 200K / プロ 800K / ビジネス 3.5M	いいえ（Pro+）

ドメインへの紐付け

有料キーは最初のリクエスト時に1つのドメインに紐付けられます。変更は自身で管理画面から行え、月3回まで可能です。WordPressプラグインのインストールにより、コードを変更せずにヘッダーX-AstroWay-Site-URLが自動送信されます。

エラー処理

401 — X-Api-Key が欠けているか無効です
402 — この料金には、このエンドポイントは含まれていません（例：HDエンドポイントでHD Packを利用していない場合）
403 — ドメインの不一致 (ドメイン ≠ Origin ヘッダー)
429 — リクエストの制限を超過または月間クレジットを使用した (Retry-After ヘッダーが設定されています)

埋め込みウィジェット

直接埋め込み iframe - どの HTML サイトでも動作し、JS ローダーは不要です。匿名プラン、IP 訪問者あたり 1 時間あたり 30 リクエスト。

今日のホロスコープ

<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 へのインストール

WP 用 AstroWay プラグイン ↗ をインストール - 設定不要の Tier 1 ウィジェット、コピー用ショートコード、Tier 2/3 用オプション API キー。

Офіційні SDK

3つの独自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 ↗」が、ショートコードや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 プランに含まれています。