ข้ามไปที่เนื้อหา

ภาพรวม API รายงานโหราศาสตร์

สร้างผลิตภัณฑ์โหราศาสตร์บนเครื่องยนต์ที่ขับเคลื่อนด้วย Swiss Ephemeris ที่ออกแบบมาสำหรับแอปพลิเคชันระดับการผลิต

คุณภาพเครื่องยนต์ รูปแบบการนำเสนอ โหมด ภาษาของรายงาน

API นี้รองรับสองโหมดการนำเสนอที่มีคุณค่าสูง:

  • Public mode สำหรับผลลัพธ์ที่มั่นคงตามสัญญาณในระดับขนาดใหญ่
  • Personalized mode สำหรับรายงานการนำเสนอที่ใช้ข้อมูลวันเกิด พร้อมเวกเตอร์ที่ละเอียด (เช่น บ้าน, มุม, การเปลี่ยนแปลงตามเวลา)

หมายเหตุ: จุดปลายของเครื่องยนต์ที่รองรับ /api/v1/horoscope/reports/* ปัจจุบันรองรับภาษาอังกฤษเท่านั้น (lang=en) จุดปลายที่ไม่ใช่การนำเสนอ อาจรองรับตัวเลือกภาษาผู้ช่วยแปลตามที่ระบุไว้

ความชัดเจนของระบบราศี

เมื่อคุณเลือก zodiac_system: "tropical" การคำนวณรายงานยังคงเป็นแบบทรอปิคอล เมื่อคุณเลือก zodiac_system: "sidereal" การคำนวณรายงานยังคงเป็นแบบไซเดอเรียล

หากไม่มี zodiac_system ในเนื้อหาคำขอ เครื่องยนต์จะใช้ค่าเริ่มต้นคือ tropical

คุณอาจยังคงเห็นฟิลด์ที่เกี่ยวข้องกับทรอปิคอล, ไซเดอเรียล และ อัยนาัมสา ในข้อมูลเมตาของคำตอบ แม้ว่าคุณจะเลือกโหมดใดก็ตาม ข้อมูลเหล่านี้ถูกส่งกลับเพื่อเปรียบเทียบ, ความโปร่งใส และการตรวจสอบเท่านั้น ข้อมูลเหล่านี้ไม่ได้เปลี่ยนแปลงหรือแก้ไขการคำนวณรายงานจริงสำหรับระบบโหราศาสตร์ที่เลือก

สถิติ UI ของแอปประจำวัน Spotlight

จุดปลายประจำวันที่ปรับแต่งได้หลักเผยให้เห็นสถิติที่เป็นมิตรกับ UI ที่มีรายละเอียดใน data.daily_personalized_stats

สถิติ UI ของแอป การใช้งาน ข้อมูล ชุดแผนภูมิ

สถิติประจำวันที่ปรับแต่งได้ประกอบด้วย:

  • overall_pulse
  • archetype_scores
  • harmony_discord
  • elemental_balance
  • momentum_channels
  • confidence ต่อบล็อก

ใช้ daily_stats_detail: "full" | "compact" เพื่อควบคุมความหนาแน่นของข้อมูลสำหรับลูกค้าบนมือถือ/เว็บ

สถาปัตยกรรม

สถาปัตยกรรมเครื่องยนต์แบบเต็ม

สถาปัตยกรรมเครื่องยนต์โหราศาสตร์แบบเต็ม

สถาปัตยกรรม Request to Response

สถาปัตยกรรม Horoscope Request-to-Response

การแบ่งส่วนการทำงาน

เครื่องยนต์โหราศาสตร์ในสภาพแวดล้อมจริงใช้กระบวนการที่เป็นลำดับ:

  1. API Gateway ตรวจสอบการยืนยัน, ขีดจำกัด และนโยบายคำขอ
  2. แอป FastAPI ตรวจสอบสัญญาและตรวจสอบแคช
  3. HoroscopeService กำหนดค่า sign, ช่วงเวลา, ephemeris และโหมด
  4. EphemerisEngine คำนวณตำแหน่ง, มุม, บ้าน, rising sign
  5. AggregationEngine ดึงข้อมูลเหตุการณ์ช่วงเวลา, ตัวชี้วัด และปัจจัยขับเคลื่อนที่จัดอันดับ
  6. InterpretationEngine สร้างแผนผัง factor stacks ไปยังผลลัพธ์ทาง editorial พร้อมการติดตาม
  7. รวบรวมคำตอบ, ห่อด้วย metadata และแคช

สถาปัตยกรรมนี้ให้ผลลัพธ์ที่สามารถทำซ้ำได้สำหรับ payload ที่เหมือนกัน ในขณะที่ยังคงเปิดโอกาสให้มีการปรับแต่งอย่างลึกซึ้งสำหรับประสบการณ์ของแอปแบบเสียเงิน

รูปแบบความน่าเชื่อถือ: Core ปิด + Open Source Lite

เครื่องยนต์หลักของเราเป็น open-source และได้รับการปรับปรุงประสิทธิภาพสำหรับการรายงานที่แน่นอนระดับองค์กร, ชั้น editorial ระดับพรีเมียม และความน่าเชื่อถือในการใช้งานจริง

เพื่อส่งเสริมความโปร่งใสและความไว้วางใจของนักพัฒนา เรายังคงรักษาระบบ open-source ที่มีน้ำหนักเบา:

ใช้ OpAstro เพื่อประเมินคุณภาพของเครื่องได้อย่างรวดเร็ว จากนั้นขยายไปยังเส้นทางการใช้งาน NumerologyAPI สำหรับรายงานที่ละเอียดขึ้น ครอบคลุมจุดปลายที่หลากหลาย และการดำเนินงานในสภาพแวดล้อมจริง

เริ่มต้นใช้งาน

วิธีการเริ่มต้นอย่างรวดเร็ว: รายงานประจำวัน + สถิติแอป

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/reports/today?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "dob": "1992-07-16",
  "timezone": "America/New_York",
  "birth_time": "13:45",
  "birth_latitude": 40.7128,
  "birth_longitude": -74.0060,
  "birth_timezone": "America/New_York",
  "daily_stats_detail": "compact"
}'

ฟังก์ชันนี้จะคืนค่ารายงานประจำวันที่สด พร้อมกับ data.daily_personalized_stats สำหรับบัตรและโมดูลแนวโน้มของแอป

คู่มือการเลือกเส้นทางการใช้งาน

เป้าหมาย กลุ่ม Endpoint ที่แนะนำ
รายงานประจำวันตามสัญญาณ (ทั่วไป) /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday
รายงานประจำวันที่ปรับแต่งได้ + แผนภูมิสถิติแอป เส้นทางหลักประจำวัน พร้อม birth_time, พิกัด และ daily_stats_detail
รายงานทั่วไปเป็นระยะ /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly
รายงานเฉพาะส่วน (อาชีพ, สุขภาพ, เงิน, การสื่อสาร, มิตรภาพ, ไลฟ์สไตล์, ความรัก) เส้นทางสำหรับช่วงเวลาต่างๆ
รายงานบรรณาธิการที่เน้นดาวเคราะห์ เส้นทางดาวเคราะห์
รายงานบรรณาธิการที่เน้นมุมสัมพันธ์ เส้นทางมุมสัมพันธ์
รายงานบรรณาธิการที่เน้นการโคจร เส้นทางโคจร
รายงานส่วนตัวที่เน้นบ้าน เส้นทางบ้าน
รายงานส่วนตัวที่เน้นดาวเคราะห์และบ้าน เส้นทางดาวเคราะห์และบ้าน
แผนภูมิเกิด + สิ่งประดิษฐ์วงล้อ เส้นทางแผนภูมิเกิด

แผนที่ Endpoint

ใช้แผนนี้เพื่อไปยังกลุ่มเส้นทางที่ถูกต้องตามความต้องการของผลิตภัณฑ์ของคุณโดยตรง

แผนภูมิเกิดและรากฐาน

โหรประจำวัน

ดวงรายสัปดาห์

Horoscope เดือน

Horoscope ปี

Horoscope ความรัก

รายงานดาวเคราะห์, มุม, การโคจร และบ้าน

คำอธิบายเกี่ยวกับเครื่องหมายดวงชะ (ไม่ใช่รายงานแบบเรียลไทม์)

จุดปลายเหล่านี้ /api/v1/horoscope/sign/* ส่งคืนความหมายของรูปแบบเครื่องหมายดวงชะ, ไม่ใช่รายงานโหราศาสตร์แบบเรียลไทม์ ใช้ /api/v1/horoscope/reports/* สำหรับการสร้างรายงานแบบเรียลไทม์

ความเข้ากันได้และสารานุกรม

เหมาะสำหรับ

  • แอปพลิเคชันมือถือและเว็บด้านโหราศาสตร์
  • ฟีดรายงานประจำวันและการส่งจดหมายข่าวส่วนบุคคล
  • ผลิตภัณฑ์เกี่ยวกับความเข้ากันได้และความสัมพันธ์
  • แผงควบคุมเพื่อสุขภาพ, การฝึกสอน และจิตวิญญาณ
  • การบูรณาการสำหรับองค์กรที่ต้องการความสอดคล้อง

ขับเคลื่อนโดย NumerologyAPI.com