Textos de la carta natal

Last updated 24 sept 2026 Ver como Markdown Configuración del agente

GET /v1/natal-texts devuelve textos de interpretaciones listos para las posiciones del mapa. Los textos están escritos y editados de antemano, no se genera nada por solicitud.

Solicitud

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

keys: hasta 64 claves diferentes separadas por comas.
- planeta en signo: sun.aries, también chiron.leo, ascendant.virgo;
- planeta en casa: moon.h4;
- aspecto entre dos de Sun..Pluto: sun_moon.trine (conjunction, sextile, square, trine, opposition). El orden del par no importa, moon_sun se convertirá en sun_moon.
lang: obligatorio, uno de los 20 idiomas del sitio.

Respuesta

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

El texto que no está disponible en el idioma solicitado se coloca en missing. No sustituimos otro idioma. body es texto plano, los párrafos están separados por una línea vacía.

Qué hay ya

Planeta en signo: 144 textos en veinte idiomas. Los planetas en casa y los aspectos se escriben y aparecerán en este mismo endpoint.

Precio y caché

/v1/natal-texts cuesta como una llamada normal (10 créditos), sin importar cuántas claves haya. Las respuestas con clave no se cachean en el CDN (Cache-Control: no-store), así que guarda los textos tú mismo por clave y por idioma: el texto solo cambia después de una edición.