# Testi della carta natale

`GET /v1/natal-texts` restituisce testi di interpretazione pronti per le posizioni della carta. I testi sono scritti e pre‑modificati in anticipo, nulla viene generato per la richiesta.

## Richiesta

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

- `keys`: fino a 64 chiavi diverse separate da virgola.
  - pianeta nel segno: `sun.aries`, anche `chiron.leo`, `ascendant.virgo`;
  - pianeta nella casa: `moon.h4`;
  - aspetto tra due da Sun..Pluto: `sun_moon.trine` (conjunction, sextile, square, trine, opposition). L'ordine della coppia non è importante, `moon_sun` diventerà `sun_moon`.
- `lang`: obbligatorio, una delle 20 lingue del sito.

## Risposta

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

Il testo che non è disponibile nella lingua richiesta finisce in `missing`. Non sostituiamo con un'altra lingua. `body` è un semplice testo, i paragrafi sono separati da una riga vuota.

## Cosa c'è già

Pianeta nel segno: 144 testi in venti lingue. Pianeta nella casa e gli aspetti sono scritti e appariranno nello stesso endpoint.

## Prezzo e cache

`/v1/natal-texts` costa come una chiamata normale (10 crediti), indipendentemente dal numero di chiavi. Le risposte con chiave non sono memorizzate nella cache sul CDN (`Cache-Control: no-store`), quindi conserva i testi localmente per chiave e lingua: il testo cambia solo dopo una modifica.