# Texty natální karty

`GET /v1/natal-texts` vrací připravené texty výkladů pro pozice mapy. Texty jsou napsány a předem upraveny, při požadavku se nic negeneruje.

## Požadavek

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

- `keys`: až 64 různých klíčů oddělených čárkou.
  - planeta ve znamení: `sun.aries`, také `chiron.leo`, `ascendant.virgo`;
  - planeta v domě: `moon.h4`;
  - aspekt mezi dvěma z Sun..Pluto: `sun_moon.trine` (conjunction, sextile, square, trine, opposition). Pořadí páru není důležité, `moon_sun` se stane `sun_moon`.
- `lang`: povinný, jeden ze 20 jazyků webu.

## Odpověď

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

Text, který není dostupný v požadovaném jazyce, končí v `missing`. Jiný jazyk nenahrazujeme. `body` je obyčejný text, odstavce jsou odděleny prázdným řádkem.

## Co už je

Planeta ve znamení: 144 textů ve dvaceti jazycích. Planeta v domě a aspekty se zapisují a budou se objevovat v tomto stejném endpointu.

## Cena a cache

`/v1/natal-texts` stojí jako jeden běžný volání (10 kreditů), bez ohledu na počet klíčů. Odpovědi s klíčem nejsou cachovány na CDN (`Cache-Control: no-store`), takže si ukládejte texty u sebe podle klíče a jazyka: text se mění jen po úpravě.