نصوص خريطة الولادة

GET /v1/natal-texts يرجع نصوص تفسيرات جاهزة لمواقع الخريطة. النصوص مكتوبة ومعدلة مسبقًا، ولا يتم توليد شيء عند الطلب.

الطلب

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

• keys: حتى 64 مفتاحًا مختلفًا مفصولين بفواصل.
  • كوكب في البرج: sun.aries، أيضًا chiron.leo، ascendant.virgo;
  • كوكب في البيت: moon.h4;
  • جانب بين اثنين من Sun..Pluto: sun_moon.trine (conjunction, sextile, square, trine, opposition). ترتيب الزوج غير مهم، moon_sun سيصبح sun_moon.
• lang: إلزامي، واحدة من 20 لغة للموقع.

الاستجابة

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

النص الذي لا يتوفر باللغة المطلوبة يذهب إلى missing. لا نستبدل بلغة أخرى. body هو نص عادي، الفقرات مفصولة بسطر فارغ.

ما هو موجود بالفعل

كوكب في البرج: 144 نصًا بـ 20 لغة. كوكب في البيت والجانب تُكتب وتظهر في نفس الـ endpoint.

السعر والذاكرة المؤقتة

/v1/natal-texts تكلف مكالمة واحدة عادية (10 أرصدة)، بغض النظر عن عدد المفاتيح. الردود مع المفتاح لا تُخزن مؤقتًا على CDN (Cache-Control: no-store)، لذا احفظ النصوص عندك حسب المفتاح واللغة: النص يتغير فقط بعد التعديل.