# Teksty karty natalnej

`GET /v1/natal-texts` zwraca gotowe teksty interpretacji dla pozycji w horoskopie. Teksty są pisane i redagowane z góry, nic nie jest generowane na żądanie.

## Zapytanie

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

- `keys`: do 64 różnych kluczy oddzielonych przecinkami.
  - planeta w znaku: `sun.aries`, również `chiron.leo`, `ascendant.virgo`;
  - planeta w domu: `moon.h4`;
  - aspekt między dwoma planetami z zakresu Sun..Pluto: `sun_moon.trine` (conjunction, sextile, square, trine, opposition). Kolejność pary nie ma znaczenia, `moon_sun` zostanie zmienione na `sun_moon`.
- `lang`: obowiązkowy, jeden z 20 języków serwisu.

## Odpowiedź

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

Tekst, którego nie ma w żądanym języku, trafia do `missing`. Nie wstawiamy innego języka. `body` to zwykły tekst, akapity oddzielone pustą linią.

## Co już jest

Planeta w znaku: 144 tekstów w dwudziestu językach. Planeta w domu oraz aspekty są pisane i pojawią się w tym samym endpointcie.

## Cena i cache

`/v1/natal-texts` kosztuje jak jeden zwykły wywołanie (10 kredytów), niezależnie od liczby kluczy. Odpowiedzi z kluczem nie są buforowane na CDN (`Cache-Control: no-store`), więc przechowuj teksty u siebie według klucza i języka: tekst zmienia się tylko po edycji.