SVG-изображение натальной карты¶

Конечная точка SVG-изображение натальной карты возвращает SVG-вывод натальной колеса от внутреннего движка с полной поддержкой отображения/рендеринга.

Поддержка языков: поддерживаются все 26 языков. Ответы на неанглийском языке переводятся на лету помощником перевода (по умолчанию LibreTranslate; DeepL BYOK, MyMemory или Google можно выбрать для каждого запроса).

Конечная точка¶

Тело запроса¶

Верхнеуровневые поля```markdown¶

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````markdown¶

| `wheel.show_degree_ticks` | Нет | boolean | `true` | Отображать деления градуса. |
| `wheel.show_degree_labels` | Нет | boolean | `true` | Отображать метки градусов. |
| `wheel.degree_tick_interval` | Нет | integer | `5` | Диапазон: от `1` до `30`. |
| `wheel.show_planet_symbols` | Нет | boolean | `true` | Отображать символы планет. |
| `wheel.planet_symbol_size` | Нет | number | `15.0` | Диапазон: от `10.0` до `30.0`. |
| `wheel.planet_marker_size` | Нет | number | `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` | Нет | string | `Docs SVG` | Необязательный заголовок колеса. |
| `wheel.subtitle` | Нет | string | `Expanded parity example` | Необязательный подзаголовок колеса. |
| `wheel.custom_planet_colors` | Нет | object | `{ "Sun": "#ffbb33" }` | Карта соответствия имени планеты и шестнадцатеричного цвета. |---
Этот эндпоинт по умолчанию возвращает SVG (`image/svg+xml`). Он может возвращать разделенные JSON-части SVG, когда `split=true`.

## Пользовательские темы колеса (`theme: "custom"` + `theme_palette`)

Цвета и прозрачность колеса полностью настраиваются: установите `wheel.theme` в
`custom` и передайте объект `theme_palette`. Переопределяются только ключи, которые
вы указываете, — всё остальное возвращается к темной базовой палитре `night`.

```json
{
  "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-символьными hex (#rrggbb); panel_opacity должен быть числом с плавающей точкой в диапазоне [0, 1]. Неизвестные ключи или недопустимые значения → ошибка проверки 422.
• theme_palette обязателен, когда theme равен "custom".
• На именованных темах (например, 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¶

Предустановка печати (Слияние с переопределением) с включенными линиями пропорций¶

Пример тропического зенита¶

Пример сидериального обсидиана¶