誕生チャート SVG 画像¶

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

言語サポート: このエンジンによる/api/v1/birth-chart/svg エンドポイントは、現在英語のみをサポートしています (lang=en)。

エンドポイント¶

リクエストボディ¶

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

|---|---|---|---|---| | 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 オブジェクトフィールド¶

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

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 }
}'

サンプルレスポンス¶

{
  "content_type": "image/svg+xml",
  "content_length": 31774,
  "preview": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"538\" height=\"538\" viewBox=\"0 0 538 538\"><g transform=\"translate(-111.25 -13.97)\"><circle cx=\"380.00\" cy=\"282.72\" r=\"214.32\" fill=\"none\" stroke=\"#3ddd77\" stroke-width=\"3.1\" /><circle cx=\"380.00\" cy=\"282.72\" r=\"144.40\" fill=\"none\" stroke=\"#ad9478\" stroke-width=\"2.3\" /><circle cx=\"380.00\" cy=\"282.72\" r=\"90.97\" fill=\"#f0e7d8\" stroke=\"#c4ad92\" stroke-width=\"1.0\" opacity=\"0.95\" /><line x1=\"380.00\" y1=\"65.19\" x2=\"380.00\" y2=\"55.11\" stroke=\"#c7b399\" stroke-width=\"1.4\" opacity=\"0.86\" /><text x=\"380.00\" y=\"49.11\" text-anchor=\"middle\" dominant-baseline=\"middle\" font-size=\"10.0\" font-family=\"'Menlo','Consolas','SFMono-Regular','DejaVu Sans Mono','Liberation Mono',monospace\" fill=\"#745f47\">0\u00b0</text><line x1=\"398.77\" y1=\"68.15\" x2=\"399.33\" y2=\"61.74\" stroke"
}

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

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

トロピカルゼニスの例¶

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