Ir para o conteúdo

Imagem SVG do Mapa Astral¶

O endpoint Imagem SVG do Mapa Astral retorna a saída SVG da roda natal do motor interno, com suporte completo para renderização da roda.

Suporte a idiomas: Este endpoint, baseado no motor /api/v1/birth-chart/svg, atualmente suporta apenas inglês (lang=en).

Endpoint¶

Método	Caminho
`POST`	`https://api.numerologyapi.com/api/v1/birth-chart/svg`

Corpo da Requisição¶

Campos de Nível Superior¶

Nome	Obrigatório	Tipo	Exemplo	Descrição
`sign`	Não	string	`CANCER`	Signo do zodíaco. Permitido: `ARIES`, `TAURUS`, `GEMINI`, `CANCER`, `LEO`, `VIRGO`, `LIBRA`, `SCORPIO`, `SAGITTARIUS`, `CAPRICORN`, `AQUARIUS`, `PISCES`.
`target_date`	Não	string	`2026-04-08`	Data de fallback pública/assinatura (`YYYY-MM-DD`).
`birth`	Não	objeto	`{...}`	Bloco de nascimento nativo do motor (ver tabela aninhada).
`sections`	Não	array[string]	`["general"]`	Seções solicitadas.
`zodiac_system`	Não	string	`tropical`	Permitido: `sidereal`, `tropical`.
`ayanamsa`	Não	string	`lahiri`	Permitido: `lahiri`, `fagan_bradley`, `krishnamurti`, `raman`, `yukteswar`.
`house_system`	Não	string	`placidus`	Permitido: `placidus`, `whole_sign`, `equal`, `koch`.
`node_type`	Não	string	`true`	Permitido: `true`, `mean`.
`tenant_id`	Não	string	`docs-smoke`	Sobrescrita opcional de namespace de inquilino/cache.
`user_name`	Não	string	`Docs Smoke User`	Rótulo de usuário para renderização de gráfico.
`output_mode`	Não	string	`wheel_only`	Permitido: `full`, `report_only`, `wheel_only`.
`include_wheel_svg`	Não	booleano	`true`	Incluir artefato SVG da roda no caminho de renderização.
`split`	Não	booleano	`false`	`false`: Resposta SVG binária. `true`: Agrupar SVG em formato JSON, quando suportado.
`round_wheel_only`	Não	booleano	`true`	Renderizar apenas a roda circular.
`transparent_background`	Não	booleano	`true`	Modo de fundo transparente.
`svg_compression`	Não	string	`none`	Permitido: `none`, `gzip`.
`language`	Não	string	`en`	Chave da linguagem do motor (2 a 16 caracteres).
`locale`	Não	string	`en-US`	Chave de localidade do motor (2 a 20 caracteres).
`wheel`	Não	objeto	`{...}`	Opções de renderização da roda (ver tabela aninhada).
`theme`	Não	string	`classic`	Chave de compatibilidade legada, mapeada para `wheel.theme` (`classic->paper`, `light->day`, `dark->night`, `dark-high-contrast->obsidian`).
`lang`	Não	string	`en`	Chave de compatibilidade legada, mapeada para `language`.
`name`	Não	string	`User`	Alias legado para `user_name`.
`year`	Não	inteiro	`1992`	Ano de nascimento achatado (legado). Use com `month` e `day`.
`month`	Não	inteiro	`7`	Mês de nascimento achatado (legado).
`day`	Não	inteiro	`16`	Data de nascimento antiga, descompactada.
`hour`	Não	inteiro	`13`	Hora de nascimento antiga, descompactada.
`minute`	Não	inteiro	`45`	Minuto de nascimento antigo, descompactado.
`lat`	Não	número	`40.7128`	Latitude antiga, descompactada (deve ser combinada com `lng`).
`lng`	Não	número	`-74.0060`	Longitude antiga, descompactada (deve ser combinada com `lat`).
`tz_str`	Não	string	`America/New_York`	Alias de fuso horário antigo.
`city`	Não	string	`New York`	Campo de compatibilidade antigo.
`country`	Não	string	`US`	Campo de compatibilidade antigo.

`birth` Campos do Objeto¶

Nome	Obrigatório	Tipo	Exemplo	Descrição
`birth.date`	Sim (se `birth` for fornecido)	string	`1992-07-16`	Data de nascimento (`YYYY-MM-DD`).
`birth.time`	Não	string	`13:45`	Hora de nascimento (`HH:MM`, 24h).
`birth.coordinates`	Não	objeto	`{ "latitude": 40.7128, "longitude": -74.006 }`	Bloco de coordenadas.
`birth.coordinates.latitude`	Não	número	`40.7128`	Intervalo: `-90` a `90`.
`birth.coordinates.longitude`	Não	número	`-74.0060`	Intervalo: `-180` a `180`.
`birth.timezone`	Não	string	`America/New_York`	Fuso horário IANA.

`wheel` Campos do Objeto¶

Nome	Obrigatório	Tipo	Exemplo	Descrição
`wheel.preset_id`	Não	string	`minimal_app`	Permitido: `minimal_app`, `editorial_full`, `print_clean`.
`wheel.preset_override_mode`	Não	string	`merge`	Permitido: `merge`, `preset_only`.
`wheel.size`	Não	inteiro	`720`	Faixa: `720` a `2400`.
`wheel.theme`	Não	string	`paper`	Permitido: `night`, `day`, `aurora`, `paper`, `obsidian`, `sunset`, `zenith`, `mono`.
`wheel.panel_layout`	Não	string	`bottom`	Permitido: `right`, `bottom`.
`wheel.accent_color`	Não	string	`#3ddd77`	Cor hexadecimal.
`wheel.background_gradient`	Não	array[string]	`["#0b1020", "#111b3b", "#1b2f6d"]`	Sobrescrita opcional de gradiente de 3 cores.
`wheel.panel_opacity`	Não	número	`0.78`	Faixa: `0.2` a `1.0`.
`wheel.aspect_line_opacity`	Não	número	`0.58`	Faixa: `0.1` a `1.0`.
`wheel.show_aspect_lines`	Não	booleano	`true`	Mostrar linhas de aspecto.
`wheel.show_house_cusps`	Não	booleano	`true`	Mostrar marcadores de ponta de casa.
`wheel.show_house_numbers`	Não	booleano	`true`	Mostrar números de casa.
`wheel.show_sign_symbols`	Não	booleano	`true`	Mostrar símbolos do zodíaco.
`wheel.show_sign_names`	Não	booleano	`true`	Mostrar rótulos do zodíaco.
`wheel.show_degree_ticks`	Não	booleano	`true`	Mostrar marcações de graus.
`wheel.show_degree_labels`	Não	booleano	`true`	Mostrar rótulos de graus.
`wheel.degree_tick_interval`	Não	inteiro	`5`	Intervalo: `1` a `30`.
`wheel.show_planet_symbols`	Não	booleano	`true`	Mostrar símbolos planetários.
`wheel.planet_symbol_size`	Não	número	`15.0`	Intervalo: `10.0` a `30.0`.
`wheel.planet_marker_size`	Não	número	`6.3`	Intervalo: `3.0` a `12.0`.
`wheel.show_planet_table`	Não	booleano	`true`	Mostrar painel da tabela de planetas.
`wheel.show_aspect_table`	Não	booleano	`true`	Mostrar painel da tabela de aspectos.
`wheel.show_sign_legend`	Não	booleano	`true`	Mostrar legenda de signos.
`wheel.show_element_balance`	Não	booleano	`true`	Mostrar painel de equilíbrio de elementos.
`wheel.show_metadata`	Não	booleano	`true`	Mostrar painel de metadados.
`wheel.show_title`	Não	booleano	`true`	Mostrar título/subtítulo.
`wheel.show_angle_markers`	Não	booleano	`true`	Mostrar marcadores de ASC/MC.
`wheel.show_center_signature`	Não	booleano	`true`	Mostrar texto de assinatura do centro.
`wheel.title`	Não	string	`Docs SVG`	Título opcional do círculo.
`wheel.subtitle`	Não	string	`Expanded parity example`	Subtítulo opcional do círculo.
`wheel.custom_planet_colors`	Não	objeto	`{ "Sun": "#ffbb33" }`	Mapa de correspondência entre nome do planeta e cor hexadecimal.

Exemplo no Modo Personalizado (Recomendado)¶

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

Exemplo no Modo Público (Geral, Baseado em Sinais)¶

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

Exemplo de Resposta¶

{
  "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"
}

Exemplos de SVG Renderizados¶

Predefinição de Impressão (Mesclar Override) Com Linhas de Aspecto Ativadas¶

Predefinição de impressão com linhas de aspecto

Exemplo de Zenith Tropical¶

Exemplo de zenith tropical

Exemplo de Obsidiana Sidereal¶

Exemplo de obsidiana sidereal