# Embed-віджети

Публічні HTML-віджети `GET /v1/embed/*` віддають готовий iframe-фрагмент — SVG-колесо, гороскоп, нумерологію тощо. **Без API-ключа**, обмеження по IP хоста (30 запитів/годину), кеш `public, max-age=300`. Підходять для маркетингових сторінок; для high-traffic продакшну використовуйте [SDK](/examples/).

```html
<iframe src="https://api.astroway.info/v1/embed/wheel?date=1990-05-15&time=14:30&lat=50.45&lng=30.52&tz=2&theme=dark"
        width="460" height="560" style="border:0"></iframe>
```

## Галерея віджетів

Живий перегляд усіх 14 віджетів — перемкніть тему, скопіюйте готовий `<iframe>`.

<WidgetGallery lang="uk" client:only="react" />

## Спільні параметри

Приймають усі віджети:

| Параметр | Значення | За замовчуванням | Опис |
|---|---|---|---|
| `theme` | `dark` · `light` · `console` | `dark` | Кольорова схема. |
| `lang` | `uk` · `en` · +18 мов | `uk` | Мова контенту. Також читається із заголовка `Accept-Language`. |
| `disclaimer` | `1` · `true` · `yes` | вимкнено | Додає у футер оговорку про розважально-ознайомлювальний характер контенту (не медична, психологічна, фінансова чи юридична консультація). |

## Віджети

| Віджет | Endpoint | Специфічні параметри |
|---|---|---|
| Гороскоп дня | `GET /embed/daily-horoscope` | `sign`, `date` |
| Натальне колесо | `GET /embed/wheel` *(аліас `/embed/natal`)* | `date`, `time`, `lat`, `lng`, `tz`, `city` |
| Стрічка транзитів | `GET /embed/transit-timeline` | `date`, `days` (макс. 30) |
| Бодіграф (Human Design) | `GET /embed/bodygraph` | `date`, `time`, `lat`, `lng`, `tz` |
| Ведична кундлі | `GET /embed/kundli` | `date`, `time`, `lat`, `lng`, `tz` |
| Міні-карта | `GET /embed/mini-chart` | `date`, `time`, `lat`, `lng`, `tz`, `city` |
| Планета дня | `GET /embed/planet-of-day` | `date` |
| Фаза Місяця | `GET /embed/moon-phase` | `date` |
| Таро дня | `GET /embed/daily-tarot` | `date` |
| Місячний прогноз | `GET /embed/monthly-forecast` | `sign`, `month` (`YYYY-MM`) |
| Транзити неба | `GET /embed/transit` | `date` |
| Нумерологія | `GET /embed/numerology` | `name`, `date`, `system` (`pythagorean` · `chaldean`) |
| Панчанг | `GET /embed/panchang` | `date`, `lat`, `lng`, `tz` *(координати обовʼязкові)* |
| Синастрія | `GET /embed/synastry` | `date_a`, `time_a`, `lat_a`, `lng_a`, `tz_a`, `date_b`, `time_b`, `lat_b`, `lng_b`, `tz_b` |

Формати: дата — `YYYY-MM-DD`, час — `HH:MM`, `tz` — зсув від UTC у годинах. Незадані параметри підставляються розумним дефолтом (поточна дата, полудень, екватор).