Textes de la carte natale

GET /v1/natal-texts renvoie des textes d’interprétation prêts à l’emploi pour les positions de la carte. Les textes sont écrits et édités à l’avance, rien n’est généré à la demande.

Requête

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

• keys: jusqu’à 64 clés différentes, séparées par des virgules.
  • planète en signe : sun.aries, également chiron.leo, ascendant.virgo ;
  • planète en maison : moon.h4 ;
  • aspect entre deux de Sun..Pluto : sun_moon.trine (conjunction, sextile, square, trine, opposition). L’ordre de la paire n’est pas important, moon_sun deviendra sun_moon.
• lang: obligatoire, l’une des 20 langues du site.

Réponse

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

Le texte qui n’est pas disponible dans la langue requise est placé dans missing. Nous ne substituons pas d’autre langue. body est un texte simple, les paragraphes sont séparés par une ligne vide.

Ce qui est déjà disponible

Planète en signe : 144 textes en vingt langues. La planète en maison et les aspects sont en cours de rédaction et apparaîtront dans ce même endpoint.

Prix et cache

/v1/natal-texts coûte comme un appel normal (10 crédits), quel que soit le nombre de clés. Les réponses avec clé ne sont pas mises en cache sur le CDN (Cache-Control: no-store), alors stocke les textes chez toi par clé et par langue : le texte ne change qu’après édition.