태어난 별자리 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 | 렌더링 경로에 wheel SVG 아티팩트를 포함합니다. | | split | 예 | boolean | false | false: 이진형 SVG 응답. true: 지원되는 경우 분할된 JSON SVG 번들을 생성합니다. | | round_wheel_only | 예 | boolean | true | 원형 휠만 렌더링합니다. | | transparent_background | 예 | boolean | true | 투명 배경 모드를 활성화합니다. | | svg_compression | 예 | 문자열 | none | 허용 값: none, gzip. | | language | 예 | 문자열 | en | 엔진 언어 키 (2~16 문자). | | locale | 예 | 문자열 | en-US | 엔진 로케일 키 (2~20 문자). | | wheel | 예 | 객체 | {...} | 휠 렌더링 옵션 (중첩된 테이블 참조). | | theme | 예 | 문자열 | classic | 기존 호환성 키를 wheel.theme에 매핑합니다. (classic->paper, light->day, dark->night, dark-high-contrast->obsidian). | | lang | 예 | 문자열 | en | 기존 호환성 키를 language에 매핑합니다. | | name | 예 | 문자열 | User | user_name의 기존 별칭입니다. | | year | 예 | 정수 | 1992 | 기존 평탄화된 생년월일을 사용합니다 (month 및 day와 함께). | | month | 예 | 정수 | 7 | 기존 평탄화된 생년월일을 사용합니다. || day | No | integer | 16 | Legacy flattened birth day. | | hour | No | integer | 13 | Legacy flattened birth hour. | | minute | No | integer | 45 | Legacy flattened birth minute. | | lat | No | number | 40.7128 | Legacy flattened latitude (must pair with lng). | | lng | No | number | -74.0060 | Legacy flattened longitude (must pair with lat). | | tz_str | No | string | America/New_York | Legacy flattened timezone alias. | | city | No | string | New York | Legacy compatibility field. | | country | No | string | US | Legacy compatibility field. |

birth Object Fields| 이름 | 필수 | 유형 | 예시 | 설명 |¶

|---|---|---|---|---| | 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 객체 필드| 이름 | 필수 | 유형 | 예시 | 설명 |¶

|---|---|---|---|---| | wheel.preset_id | 아니오 | 문자열 | minimal_app | 허용 값: minimal_app, editorial_full, print_clean. | | wheel.preset_override_mode | 아니오 | 문자열 | merge | 허용 값: merge, preset_only. | | wheel.size | 아니오 | 정수 | 720 | 범위: 720 ~ 2400. | | wheel.theme | 아니오 | 문자열 | custom | 허용 값: night, day, aurora, paper, obsidian, sunset, zenith, mono, custom. custom을 wheel.theme_palette와 함께 사용하면 색상을 완전히 제어할 수 있습니다. | | wheel.panel_layout | 아니오 | 문자열 | bottom | 허용 값: right, bottom. | | wheel.accent_color | 아니오 | 문자열 | #3ddd77 | 16진 색상 코드. | | wheel.background_gradient | 아니오 | 문자열 배열 | ["#0b1020", "#111b3b", "#1b2f6d"] | 선택적인 3색 그라데이션 설정 (선택 사항). | | wheel.panel_opacity | 아니오 | 숫자 | 0.78 | 범위: 0.2 ~ 1.0. | | wheel.theme_palette | 아니오 | 객체 | { "center_fill": "#0d1832", "panel_opacity": 0.78 } | 선택적 사용자 지정 테마 팔레트 오버라이드 (사용자 지정 휠 테마 참조). 모든 테마에서 부분 오버라이드가 허용되며, theme이 custom인 경우 필수입니다. | | wheel.aspect_line_opacity | 아니오 | 숫자 | 0.58 | 범위: 0.1 ~ 1.0. | | wheel.show_aspect_lines | 아니오 | 불리언 | true | 측면 선 표시 여부 설정. | | wheel.show_house_cusps | 아니오 | 불리언 | true | 하우스 쿠스 마커 표시 여부 설정. | | wheel.show_house_numbers | 아니오 | 불리언 | true | 하우스 번호 표시 여부 설정. | | wheel.show_sign_symbols | 아니오 | 불리언 | true | 천문학적 기호 표시 여부 설정. | | wheel.show_sign_names | 아니오 | 불리언 | true | 천문학적 레이블 표시 여부 설정. |--- REVISED TRANSLATION --- | wheel.show_degree_ticks | 아니요 | boolean | true | 도표 눈금 표시 여부 | | wheel.show_degree_labels | 아니요 | boolean | true | 도표 레이블 표시 여부 | | wheel.degree_tick_interval | 아니요 | 정수 | 5 | 범위: 1 ~ 30 | | wheel.show_planet_symbols | 아니요 | boolean | true | 행 기호 표시 여부 | | wheel.planet_symbol_size | 아니요 | 숫자 | 15.0 | 범위: 10.0 ~ 30.0 | | wheel.planet_marker_size | 아니요 | 숫자 | 6.3 | 범위: 3.0 ~ 12.0 | | wheel.show_planet_table | 아니요 | boolean | true | 행 테이블 패널 표시 여부 | | wheel.show_aspect_table | 아니요 | boolean | true | 측면 테이블 패널 표시 여부 | | wheel.show_sign_legend | 아니요 | boolean | true | 기호 설명 표시 여부 | | wheel.show_element_balance | 아니요 | boolean | true | 요소 균형 패널 표시 여부 | | wheel.show_metadata | 아니요 | boolean | true | 메타데이터 패널 표시 여부 | | wheel.show_title | 아니요 | boolean | true | 제목/부제목 표시 여부 | | wheel.show_angle_markers | 아니요 | boolean | true | ASC/MC 마커 표시 여부 | | wheel.show_center_signature | 아니요 | boolean | true | 중심 서명 텍스트 표시 여부 | | wheel.title | 아니요 | 문자열 | Docs SVG | 선택적 휠 제목 | | wheel.subtitle | 아니요 | 문자열 | Expanded parity example | 선택적 휠 부제목 | | wheel.custom_planet_colors | 아니요 | 객체 | { "Sun": "#ffbb33" } | 행 이름 - 헥스 색상 매핑This endpoint returns SVG (image/svg+xml) by default. It can return split JSON SVG parts when split=true.

사용자 지정 휠 테마 (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] 범위의 float여야 합니다. 알 수 없는 키나 잘못된 값은 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"
    }
  }
}'

이 엔드포인트에서의 기존 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 예제¶

프리셋 (병합 오버라이드) - 어스펙트 라인 활성화¶

열대성 정점 예제¶

천문학적 오비디언 예제¶