誕生チャート SVG 画像¶

誕生チャート SVG 画像 エンドポイントは、社内エンジンから生成された完全なホイール/レンダリングオプションをサポートした、出生円のSVG出力を返します。

言語サポート: 全26言語をサポートしています。英語以外の応答は、翻訳ヘルパーによってリクエスト時に自動翻訳されます（既定はLibreTranslate。DeepL BYOK・MyMemory・Google はリクエストごとに選択可能）。

エンドポイント¶

リクエストボディ¶

トップレベルフィールド| 名前 | 必須 | タイプ | 例 | 説明 |¶

|---|---|---|---|---| | sign | いいえ | 文字列 | CANCER | 星座。許可値: ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES. | | target_date | いいえ | 文字列 | 2026-04-08 | 公開/代替サインの日付 (YYYY-MM-DD). | | birth | いいえ | オブジェクト | {...} | エンジン由来の誕生ブロック (ネストされたテーブルを参照). | | sections | いいえ | 文字列の配列 | ["general"] | 要求されるセクション。 | | zodiac_system | いいえ | 文字列 | tropical | 許可値: sidereal, tropical. | | ayanamsa | いいえ | 文字列 | lahiri | 許可値: lahiri, fagan_bradley, krishnamurti, raman, yukteswar. | | house_system | いいえ | 文字列 | placidus | 許可値: placidus, whole_sign, equal, koch. | | node_type | いいえ | 文字列 | true | 許可値: true, mean. | | tenant_id | いいえ | 文字列 | docs-smoke | オプションのテナント/キャッシュネームスペースのオーバーライド。 | | user_name | いいえ | 文字列 | Docs Smoke User | チャート表示用のユーザーラベル。 | | output_mode | いいえ | 文字列 | wheel_only | 許可値: full, report_only, wheel_only. || include_wheel_svg | いいえ | boolean | true | renderパスにwheelのSVGアセットを含める。 | | split | いいえ | boolean | false | false: 二進数形式のSVGレスポンス。 true: サポートされている場合、分割されたJSON形式のSVGバンドルを生成する。 | | round_wheel_only | いいえ | boolean | true | 円形のwheelのみをレンダリングする。 | | transparent_background | いいえ | boolean | true | 背景を透明にするモード。 | | svg_compression | いいえ | string | none | 許可される値: none, gzip。 | | language | いいえ | string | en | エンジン言語キー (2-16文字)。 | | locale | いいえ | string | en-US | エンジンローカレキー (2-20文字)。 | | wheel | いいえ | object | {...} | wheelのレンダリングオプション (ネストされたテーブルを参照)。 | | theme | いいえ | string | classic | Legacy互換性キーをwheel.themeにマッピング (classic->paper, light->day, dark->night, dark-high-contrast->obsidian)。 | | lang | いいえ | string | en | Legacy互換性キーをlanguageにマッピング。 | | name | いいえ | string | User | user_nameのLegacyエイリアス。 | | year | いいえ | integer | 1992 | Legacy形式の生まれた年 (monthとdayと共に使用)。 | | month | いいえ | integer | 7 | Legacy形式の生まれた月。 |--- REVISED TRANSLATION --- | day | いいえ | integer | 16 | 従来の平坦化された誕生日 | | hour | いいえ | integer | 13 | 従来の平坦化された誕生時間 | | minute | いいえ | integer | 45 | 従来の平坦化された分 | | lat | いいえ | 数値 | 40.7128 | 従来の平坦化された緯度 (lng とペアで使用) | | lng | いいえ | 数値 | -74.0060 | 従来の平坦化された経度 (lat とペアで使用) | | tz_str | いいえ | 文字列 | America/New_York | 従来の平坦化されたタイムゾーンエイリアス | | city | いいえ | 文字列 | New York | 従来の互換性フィールド | | country | いいえ | 文字列 | US | 従来の互換性フィールド |

birth オブジェクトのフィールド| 名前 | 必須 | タイプ | 例 | 説明 |¶

|---|---|---|---|---| | birth.date | はい (birth が提供されている場合) | 文字列 | 1992-07-16 | 生年月日 (YYYY-MM-DD)。 | | birth.time | いいえ | 文字列 | 13:45 | 出生日 (HH:MM, 24時間表記) | | birth.coordinates | いいえ | オブジェクト | { "latitude": 40.7128, "longitude": -74.006 } | 座標ブロック。 | | birth.coordinates.latitude | いいえ | 数値 | 40.7128 | 範囲: -90 から 90 まで。 | | birth.coordinates.longitude | いいえ | 数値 | -74.0060 | 範囲: -180 から 180 まで。 | | birth.timezone | いいえ | 文字列 | America/New_York | IANA 時区。 |

wheel オブジェクトフィールド¶

カスタムホイールテーマ（theme: "custom" + theme_palette）¶

ホイールの色と透明度は完全にカスタマイズできます。wheel.theme を custom に設定し、theme_palette オブジェクトを渡します。指定したキーのみが 上書きされ、それ以外はすべてダークな night ベースパレットにフォールバックします。

{
  "wheel": {
    "theme": "custom",
    "accent_color": "#3ddd77",
    "theme_palette": {
      "bg_0": "#0b1730",
      "bg_1": "#101d38",
      "bg_2": "#0a1326",
      "panel_fill": "#0c1730",
      "panel_opacity": 0.78,
      "sign_line": "#2b3f63",
      "ring_inner": "#34486a",
      "center_fill": "#0d1832",
      "center_stroke": "#1e2f4a",
      "divider": "#2a3f64",
      "subtitle": "#8fa2c2",
      "text": "#dbe7f8",
      "soft_text": "#9fb0cd"
    }
  }
}

theme_palette キー¶

ルール¶

• 部分的な上書き — 指定したキーのみが適用され、残りは テーマのベースパレットにフォールバックします（custom はダークな night ベースを使用）。
• 色の値は7桁の16進数 (#rrggbb) である必要があります。panel_opacity は [0, 1] の範囲の小数である必要があります。不明なキーや無効な値は 422 バリデーションエラーになります。
• theme が "custom" の場合、theme_palette は必須です。
• 名前付きテーマ（例: paper）では、theme_palette は部分的な上書きとして機能します。
• 変更されるのはホイールの視覚的要素のみです。チャートの計算、位置、 アスペクトは決して影響を受けません。

カスタムテーマの例¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/birth-chart/svg" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "birth": {
    "date": "1992-07-16",
    "time": "13:45",
    "coordinates": { "latitude": 40.7128, "longitude": -74.006 },
    "timezone": "America/New_York"
  },
  "wheel": {
    "theme": "custom",
    "accent_color": "#3ddd77",
    "theme_palette": {
      "bg_0": "#0b1730",
      "bg_1": "#101d38",
      "bg_2": "#0a1326",
      "panel_fill": "#0c1730",
      "panel_opacity": 0.78,
      "sign_line": "#2b3f63",
      "ring_inner": "#34486a",
      "center_fill": "#0d1832",
      "center_stroke": "#1e2f4a",
      "divider": "#2a3f64",
      "subtitle": "#8fa2c2",
      "text": "#dbe7f8",
      "soft_text": "#9fb0cd"
    }
  }
}'

このエンドポイントでのLegacy theme の優先順位¶

従来のトップレベル theme フィールドは引き続きサポートされます。

1. 明示的なトップレベル theme（例: "theme": "dark"）が優先されます。
2. それ以外の場合、wheel.theme（例: "custom" + theme_palette）が使用されます。
3. それ以外の場合、従来のデフォルトである classic (→ paper) が適用されます。

レガシーエイリアス: classic → paper, light → day, dark → night, dark-high-contrast → obsidian。

パーソナライズモードの例（推奨）¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/birth-chart/svg" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "sign": "CANCER",
  "target_date": "2026-04-08",
  "zodiac_system": "tropical",
  "ayanamsa": "lahiri",
  "house_system": "placidus",
  "node_type": "true",
  "tenant_id": "docs-smoke",
  "user_name": "Docs Smoke User",
  "output_mode": "wheel_only",
  "include_wheel_svg": true,
  "split": false,
  "round_wheel_only": true,
  "transparent_background": true,
  "svg_compression": "none",
  "language": "en",
  "locale": "en-US",
  "birth": {
    "date": "1992-07-16",
    "time": "13:45",
    "coordinates": { "latitude": 40.7128, "longitude": -74.006 },
    "timezone": "America/New_York"
  },
  "wheel": {
    "preset_id": "minimal_app",
    "theme": "paper",
    "panel_layout": "bottom",
    "size": 720
  }
}'

公開モードの例（一般的なサインに基づく）¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/birth-chart/svg" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "sign": "CANCER",
  "target_date": "2026-04-08",
  "output_mode": "wheel_only",
  "split": false,
  "round_wheel_only": true,
  "language": "en",
  "locale": "en-US",
  "wheel": { "preset_id": "minimal_app", "theme": "paper", "size": 720 }
}'

サンプルレスポンス¶

レンダリングされたSVGの例¶

プリントプリセット (マージオーバーライド) とアスペクトラインを有効化¶

トロピカルゼニスの例¶

シデリアルオブラシアンの例¶