API ซาจู › API โหราศาสตร์ตะวันตก

API โหราศาสตร์ตะวันตก

เมื่อส่งวันเวลาเกิดและพิกัดเข้ามา ระบบจะคำนวณดาว 10 ดวงตั้งแต่ดวงอาทิตย์ถึงดาวพลูโต จุดโหนดของดวงจันทร์ มุมหลัก 4 มุม เรือน มุมสัมพันธ์ และศักดิ์ของดาว แล้วส่งคืนพร้อมย่อหน้าคำทำนายที่ HRUM เขียนเตรียมไว้ในรูปแบบ JSON ในครั้งเดียว ชื่อสินค้าคือ “โหราศาสตร์ตะวันตกแบบครบชุด” และไม่ใช้ LLM

คู่มือเริ่มต้นใช้งาน Playground ตารางราคา

สิ่งที่ส่งคืน

• แผนภูมิกำเนิด (Natal chart) — ตำแหน่งดาว·ราศี·องศา·เรือน มุมหลัก มุมสัมพันธ์ ศักดิ์ของดาว (natal)
• ย่อหน้าคำทำนาย — ย่อหน้าที่เขียนเตรียมไว้สำหรับศักดิ์ของดาว·มุมสัมพันธ์ แนบมาด้วยเสมอโดยไม่มีค่าใช้จ่ายเพิ่ม (readings)
• ดาวจร·การโปรเกรสชันแบบทุติยภูมิ — เมื่อแนบ timing มากับคำขอ (timing)
• ซินแนสทรี (Synastry) — เมื่อแนบ partner มากับคำขอ จะได้มุมและความสัมพันธ์ของราศีระหว่างสองคน (synastry)

ค่าที่ต้องเลือกเอง

ระบบเรือนค่าเริ่มต้นคือ Placidus และเปลี่ยนได้ด้วย houseSystems ส่วนออร์บของดาวจร·โปรเกรสชัน (timing.orbDegrees) แต่ละตำราใช้ค่าต่างกันจึงไม่มีค่าเริ่มต้น หากส่ง timing ต้องใส่ค่านี้ด้วยเสมอ หากเว้นว่างจะได้ 400

สิ่งที่ไม่ได้ให้บริการ

ไม่ส่งคืนศักดิ์ของดาวรอง·รีเซปชัน มุมหลักแบบโปรเกรสชัน (ASC·MC แบบโปรเกรสชัน) และการซ้อนเรือนของซินแนสทรี รายการทั้งหมดอยู่ในเอกสารอ้างอิง

หากกำลังใช้ /natal-chart อยู่

แผนภูมิกำเนิด (/natal-chart) สิ้นสุดการจำหน่ายแล้ว หากเชื่อมต่อใหม่ ให้ใช้ /astrology ที่รับข้อมูลเกิดแบบเดียวกัน

ตัวอย่างคำขอ

{
  "birthDate": "1990-05-15",
  "birthTime": "14:30",
  "birthTimePrecision": "exact",
  "birthLatitude": 37.5665,
  "birthLongitude": 126.978,
  "houseSystems": ["placidus", "whole_sign"]
}

การยืนยันตัวตนใช้เฮดเดอร์ X-Partner-Api-Key ที่อยู่พื้นฐานคือ https://api.hrum.ai/api/v1/partners/v1 ตัวอย่าง Python·JavaScript และการจัดการข้อผิดพลาดอยู่ในคู่มือเริ่มต้นใช้งาน

ตัวอย่างการตอบกลับ (บางส่วน)

{
  "success": true,
  "data": {
    "natal": {
      "utc": "1990-05-15T05:30:00.000Z",
      "timePrecision": "exact",
      "timeKnown": true,
      "zodiac": "tropical",
      "lang": "ko",
      "bodies": [
        { "id": "Sun", "longitude": 54.1347, "sign": "Taurus", "signKey": "tau", "signName": "황소자리", "degreeInSign": 24.1347, "speed": 0.9643, "retrograde": false, "dignities": [], "house": { "placidus": 9, "whole_sign": 9 } },
        { "id": "Moon", "longitude": 293.8244, "sign": "Capricorn", "signKey": "cap", "signName": "염소자리", "degreeInSign": 23.8244, "speed": 12.2943, "retrograde": false, "dignities": ["det"], "house": { "placidus": 4, "whole_sign": 5 } },
        …

นี่คือส่วนต้นของการตอบกลับคำขอข้างต้น การตอบกลับที่มีครบทั้งโหนด·มุมหลัก·เรือน·มุมสัมพันธ์และคำอธิบายฟิลด์อยู่ในเอกสารอ้างอิง

ราคา

โหราศาสตร์ตะวันตกแบบครบชุดมีราคา ₩50 ต่อการเรียก 1 ครั้ง (ไม่รวม VAT · รวม VAT ₩55) แม้แนบ timing·partner ไม่ว่าจะเลือกระบบเรือนใดหรือรวมมุมรองหรือไม่ ก็คิดราคาเท่ากันคือ 1 ครั้ง หักจากเครดิตแบบเติมเงินล่วงหน้าเฉพาะการเรียกที่สำเร็จ และไม่หักสำหรับการตอบกลับที่เป็นข้อผิดพลาด 4xx·5xx

ผลลัพธ์ที่ได้รับแล้วให้บันทึกเก็บไว้และนำกลับมาใช้ซ้ำ หากส่งคำขอเดิมอีกครั้งจะถูกคิดค่าบริการอีกครั้ง หากวันเดือนปีและเวลาเกิดเหมือนกันและตัวเลือกเหมือนกัน ผลการคำนวณจะเหมือนกัน จึงควรบันทึกการตอบกลับครั้งแรกไว้ใน DB (เช่น ใช้แฮชของเนื้อหาคำขอเป็นคีย์) แล้วใช้ค่าที่บันทึกไว้ในครั้งต่อไปโดยไม่มีค่าใช้จ่าย สำหรับผลลัพธ์ที่เปลี่ยนตามวันที่อย่างดวงวันนี้ ให้ใส่วันที่ลงในคีย์ด้วยและใช้ซ้ำเฉพาะภายในวันนั้น

ตารางราคาทั้งหมด

เอกสารอ้างอิงฉบับเต็ม

ตารางพารามิเตอร์ทั้งหมด คำอธิบายฟิลด์การตอบกลับ และรหัสข้อผิดพลาดอยู่ในเอกสารอ้างอิง: เอกสารอ้างอิง API โหราศาสตร์ตะวันตกแบบครบชุด สินค้าซาจูอื่นๆ ดูได้ที่ดู API ซาจูทั้งหมด

ติดต่อ: contact@float.do · ดำเนินการโดย: FLOAT Co., Ltd.