# Тексти натальної карти

`GET /v1/natal-texts` повертає готові тексти тлумачень для положень карти. Тексти написані й відредаговані заздалегідь, під запит нічого не генерується.

## Запит

```http
GET /v1/natal-texts?keys=sun.aries,moon.h4,sun_moon.trine&lang=uk HTTP/1.1
X-Api-Key: aw_live_...
```

- `keys`: до 64 різних ключів через кому.
  - планета в знаку: `sun.aries`, також `chiron.leo`, `ascendant.virgo`;
  - планета в домі: `moon.h4`;
  - аспект між двома з Sun..Pluto: `sun_moon.trine` (conjunction, sextile, square, trine, opposition). Порядок пари не важливий, `moon_sun` стане `sun_moon`.
- `lang`: обов'язковий, одна з 20 мов сайту.

## Відповідь

```json
{
  "lang": "uk",
  "texts": {
    "sun.aries": { "title": "Сонце в Овні", "body": "…", "kind": "planet_in_sign" }
  },
  "missing": ["moon.h4", "sun_moon.trine"]
}
```

Текст, якого немає потрібною мовою, потрапляє в `missing`. Іншу мову ми не підставляємо. `body` це звичайний текст, абзаци розділені порожнім рядком.

## Що вже є

Планета в знаку: 144 тексти двадцятьма мовами. Планета в домі та аспекти пишуться й з'являтимуться в цьому ж ендпоінті.

## Ціна і кеш

`/v1/natal-texts` коштує як один звичайний виклик (10 кредитів), скільки б ключів не було. Відповіді з ключем не кешуються на CDN (`Cache-Control: no-store`), тож зберігайте тексти у себе за ключем і мовою: текст змінюється лише після редагування.