# API Playground

:::tip[Playground vs Пісочниця]
**Playground** (ця сторінка) — форма з випадаючим списком усіх {siteMeta.endpoints} ендпоінтів, для швидкого HTTP-запиту без написання коду.
**[Пісочниця](/sandbox/)** — TypeScript-редактор з `AstrowayClient`, для коду. Результат — `console.log` + посилання, яким можна поділитися.
:::

Готовий запит з прикладом параметрів — досить натиснути **Надіслати**. API-ключ вводиться один раз і зберігається у `localStorage` твого браузера (нікуди не йде окрім самого AstroWay API).

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

## Як це працює

- Випадаючий список ендпоінтів — усі {siteMeta.endpoints} ендпоінтів з [OpenAPI-спеку](/v1/openapi.json), згруповані за тегами
- При виборі підставляється `example` зі спеку або захардкоджений дефолт (для `/chart`, `/synastry`, `/transits`)
- API-ключ зберігається у localStorage. Очисти поле — видалиться зі сховища.
- Запит іде з твого браузера прямо на `https://api.astroway.info/v1` — без проксі, відповідь показується як є.
- Публічні ендпоінти (`/v1/public/*`) працюють без ключа — кнопка **Надіслати** пройде з порожнім полем.

## Sandbox-ключі

Для тестування використовуй ключі з префіксом `aw_test_` — вони не списують кредити. Створити — у [dashboard → API Keys](/dashboard/keys), натисни «Create key» → mode «Test».

## Ліміти

CORS дозволяє запити з `api.astroway.info` (тут) і з `localhost`. З інших origins браузер заблокує preflight — це нормально для serverless інтеграцій (там CORS не застосовується).