ネイタルチャートのテキスト

GET /v1/natal-texts は、チャートの位置に対する解説テキストを返します。テキストは事前に作成・編集されており、リクエストに応じて生成されるものではありません。

リクエスト

GET /v1/natal-texts?keys=sun.aries,moon.h4,sun_moon.trine&lang=uk HTTP/1.1
X-Api-Key: aw_live_...

• keys: カンマで区切った最大64個の異なるキー。
  • 星座内の惑星: sun.aries、また chiron.leo、ascendant.virgo;
  • ハウス内の惑星: moon.h4;
  • 太陽から冥王星までの2つの天体間のアスペクト: sun_moon.trine (conjunction, sextile, square, trine, opposition)。ペアの順序は重要ではなく、moon_sun は sun_moon になります。
• lang: 必須。サイトの20言語のいずれか。

レスポンス

{
  "lang": "uk",
  "texts": {
    "sun.aries": { "title": "Сонце в Овні", "body": "…", "kind": "planet_in_sign" }
  },
  "missing": ["moon.h4", "sun_moon.trine"]
}

要求された言語で利用できないテキストは missing に含まれます。他の言語に置き換えることはありません。body は通常のテキストで、段落は空行で区切られています。

現在利用可能なもの

星座内の惑星: 20言語で144のテキスト。ハウス内の惑星とアスペクトも作成中で、同じエンドポイントに追加されます。

価格とキャッシュ

/v1/natal-texts は、キーの数に関係なく1回の通常呼び出し（10クレジット）と同じ価格です。キーを含むレスポンスはCDNでキャッシュされません（Cache-Control: no-store）、そのためキーと言語ごとにテキストを自分で保存してください。テキストは編集されるまで変更されません。