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

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

{
  "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.