태어난 별자리 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 | 렌더링 경로에 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 | 아니오 | 문자열 | paper | 허용 값: night, day, aurora, paper, obsidian, sunset, zenith, mono. | | 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.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.

맞춤형 모드 예시 (권장)¶

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 예제¶

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

열대성 정점 예제¶

천문학적 오비디언 예제¶