Obraz SVG z horoskopem urodzeniowym¶

Endpoint Obraz SVG z horoskopem urodzeniowym zwraca wynik w formacie SVG koła urodzeniowego, generowany przez wewnętrzny silnik, z pełną obsługą opcji renderowania.

Obsługa języków: Ten endpoint, wykorzystujący /api/v1/birth-chart/svg, obecnie obsługuje tylko język angielski (lang=en).

Endpoint¶

Treść żądania¶

Pola na najwyższym poziomie| Nazwa | Wymagane | Typ | Przykład | Opis ||------|----------|------|---------|-------------|¶

| sign | Nie | string | CANCER | Znaczenie znaku zodiaku. Dopuszczalne wartości: ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES. || target_date | Nie | string | 2026-04-08 | Data awaryjnego logowania (YYYY-MM-DD). || birth | Nie | obiekt | {...} | Blok urodowy natywny dla silnika (patrz wbudowana tabela). || sections | Nie | array[string] | ["general"] | Żądane sekcje. || zodiac_system | Nie | string | tropical | Dopuszczalne: sidereal, tropical. || ayanamsa | Nie | string | lahiri | Dopuszczalne: lahiri, fagan_bradley, krishnamurti, raman, yukteswar. || house_system | Nie | string | placidus | Dopuszczalne: placidus, whole_sign, equal, koch. || node_type | Nie | string | true | Dopuszczalne: true, mean. || tenant_id | Nie | string | docs-smoke | Opcjonalne przeoczenie nazwy użytkownika/przestrzeni nazw dla pamięci podręcznej. |

---| user_name | Nie | string | Docs Smoke User | Etykieta użytkownika do renderowania wykresu. || output_mode | Nie | string | wheel_only | Dopuszczalne: full, report_only, wheel_only. || include_wheel_svg | Nie | boolean | true | Włącz SVG koła jako element renderowania. | | split | Nie | boolean | false | false: Binarny odpowiedź w formacie SVG. true: Podziel pakiet SVG w formacie JSON, jeśli jest obsługiwany. | | round_wheel_only | Nie | boolean | true | Renderuj tylko okrągłe koło. | | transparent_background | Nie | boolean | true | Tryb transparentnego tła. | | svg_compression | Nie | string | none | Dopuszczalne wartości: none, gzip. | | language | Nie | string | en | Klucz języka silnika (2-16 znaków). | | locale | Nie | string | en-US | Klucz lokalizacji silnika (2-20 znaków). | | wheel | Nie | obiekt | {...} | Opcje renderowania koła (patrz wbudowaną tabelę). | | theme | Nie | string | classic | Klucz kompatybilności ze starszymi wersjami, przypisany do wheel.theme (classic->paper, light->day, dark->night, dark-high-contrast->obsidian). | | lang | Nie | string | en | Klucz kompatybilności ze starszymi wersjami, przypisany do language. | | name | Nie | string | User | Stara nazwa dla user_name. | | year | Nie | integer | 1992 | Spłaszczona data urodzenia (używaj z month i day). | | month | Nie | integer | 7 | Spłaszczony miesiąc urodzenia. || day | Nie | integer | 16 | Dzień urodzenia w starym, uproszczonym formacie. || hour | No | integer | 13 | Legacy flattened birth hour. | | minute | Nie | integer | 45 | Stara, zredukowana minuta urodzenia. || lat | Nie | liczba | 40.7128 | Szerokość geograficzna w formacie "legacy" (musi być dopasowana do lng). || lng | Nie | liczba | -74.0060 | Stara, zredukowana współrzędna długości (musi być powiązana z lat). || tz_str | Nie | string | America/New_York | Stara, zredukowana nazwa strefy czasowej. || city | Nie | string | New York | Pole kompatybilności ze starszymi wersjami. || country | Nie | string | US | Pole kompatybilności ze starszymi wersjami. |

birth Pola Obiektu¶

wheel Pola Obiektu| Nazwa | Wymagane | Typ | Przykład | Opis |¶

|---|---|---|---|---| | wheel.preset_id | Nie | string | minimal_app | Dopuszczalne wartości: minimal_app, editorial_full, print_clean. | | wheel.preset_override_mode | Nie | string | merge | Dopuszczalne wartości: merge, preset_only. | | wheel.size | Nie | integer | 720 | Zakres: od 720 do 2400. | | wheel.theme | Nie | string | paper | Dopuszczalne wartości: night, day, aurora, paper, obsidian, sunset, zenith, mono. | | wheel.panel_layout | Nie | string | bottom | Dopuszczalne wartości: right, bottom. | | wheel.accent_color | Nie | string | #3ddd77 | Kolor szesnastkowy (hex). | | wheel.background_gradient | Nie | array[string] | ["#0b1020", "#111b3b", "#1b2f6d"] | Opcjonalny gradient z 3 kolorami. | | wheel.panel_opacity | Nie | number | 0.78 | Zakres: od 0.2 do 1.0. | | wheel.aspect_line_opacity | Nie | number | 0.58 | Zakres: od 0.1 do 1.0. | | wheel.show_aspect_lines | Nie | boolean | true | Wyświetlaj linie aspektu (aspect lines). | | wheel.show_house_cusps | Nie | boolean | true | Wyświetlaj znaczniki wierzchołków domów. | | wheel.show_house_numbers | Nie | boolean | true | Wyświetlaj numery domów. | | wheel.show_sign_symbols | Nie | boolean | true | Wyświetlaj symbole znaku zodiaku. | | wheel.show_sign_names | Nie | boolean | true | Wyświetlaj etykiety znaków zodiaku. |markdown | `wheel.show_degree_ticks` | Nie | boolean | `true` | Wyświetlaj oznaczenia stopni. | | `wheel.show_degree_labels` | Nie | boolean | `true` | Wyświetlaj etykiety stopni. | | `wheel.degree_tick_interval` | Nie | integer | `5` | Zakres: od `1` do `30`. | | `wheel.show_planet_symbols` | Nie | boolean | `true` | Wyświetlaj symbole planet. | | `wheel.planet_symbol_size` | Nie | number | `15.0` | Zakres: od `10.0` do `30.0`. | | `wheel.planet_marker_size` | Nie | number | `6.3` | Zakres: od `3.0` do `12.0`. | | `wheel.show_planet_table` | Nie | boolean | `true` | Wyświetlaj panel tabeli planet. | | `wheel.show_aspect_table` | Nie | boolean | `true` | Wyświetlaj panel tabeli aspektów. | | `wheel.show_sign_legend` | Nie | boolean | `true` | Wyświetl legendę znaków. | | `wheel.show_element_balance` | Nie | boolean | `true` | Wyświetlaj panel równowagi elementów. | | `wheel.show_metadata` | Nie | boolean | `true` | Wyświetlaj panel metadanych. | | `wheel.show_title` | Nie | boolean | `true` | Wyświetl tytuł/podtytuł. | | `wheel.show_angle_markers` | Nie | boolean | `true` | Wyświetlaj znaczniki ASC/MC. | | `wheel.show_center_signature` | Nie | boolean | `true` | Wyświetl tekst podpisu środka. | | `wheel.title` | Nie | string | `Docs SVG` | Opcjonalny tytuł koła. | | `wheel.subtitle` | Nie | string | `Expanded parity example` | Opcjonalny podtytuł koła. | | `wheel.custom_planet_colors` | Nie | object | `{ "Sun": "#ffbb33" }` | Mapa dopasowania nazwy planety do koloru szesnastkowego. |Ten punkt końcowy domyślnie zwraca plik SVG (image/svg+xml). Może zwracać podzielone części SVG w formacie JSON, gdy jest używany tryb "Personalized" (split=true).

Przykład trybu "Personalized" (Zalecany)¶

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

Przykład trybu "Public" (Ogólny, oparty na znakach)¶

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

Przykładowa odpowiedź¶

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

Przykładowe pliki SVG¶

Preset druku (Scalanie z nadpisywaniem) Z włączonymi liniami proporcji¶

Przykład Tropical Zenith¶

Przykład Sidereal Obsidian¶