API ซาจู › API จื่อเวยโต่วซู่

API จื่อเวยโต่วซู่

เมื่อส่งวันเดือนปีและเวลาเกิดเข้ามา ระบบจะคำนวณผังดวงจื่อเวยโต่วซู่ แล้วส่งคืน 12 วัง ดาวหลัก 14 ดวงและดาวเสริม (รวมความสว่างและสี่การแปรของปีเกิด) กองธาตุ ตำแหน่งวังชะตา·วังกาย และช่วงใหญ่·ปีจรของวันที่อ้างอิงในรูปแบบ JSON ชื่อสินค้าคือ “ผังดวงจื่อเวยโต่วซู่” ข้อมูลนำเข้าเหมือนกันจะได้ผลลัพธ์เหมือนกัน

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

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

แนบย่อหน้าคำทำนาย

หากส่ง readings: true จะมีย่อหน้าคำทำนายของชุดดาวหลักในวังชะตา 7 หัวข้อ และดาวหลักในวังทรัพย์·วังการงาน·วังคู่ครอง·วังสุขภาพแนบมาด้วย กรณีนี้มีค่าบริการเพิ่ม จำนวนเงินอยู่ในเอกสารอ้างอิง

หากไม่มีเวลาเกิด

จื่อเวยโต่วซู่ไม่สามารถตั้งผังดวงได้หากไม่มีเวลาเกิด หากไม่ใส่ hour จะส่งคืน 400 birth_time_required เป็นการตอบกลับข้อผิดพลาดจึงไม่หักเครดิต

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

{
  "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30,
  "gender": "female", "referenceDate": "2026-10-08", "lang": "ko"
}

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

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

{
  "success": true,
  "data": {
    "engineVersion": 1,
    "lang": "ko",
    "referenceDate": "2026-10-08",
    "clock": {
      "inputSolarDate": "1990-05-15", "inputTime": "14:30",
      "correctedSolarDate": "1990-05-15", "correctedTime": "14:30",
      "correctionMinutes": 0, "dstApplied": false, "basis": null,
      "hourBranch": { "key": "wei", "label": "미" }
    },
    "chart": {
      "engine": { "name": "iztro", "version": "2.6.1", "config": { ... } },
      "solarDate": "1990-05-15",
      "lunarDate": { "year": 1990, "month": 4, "day": 21, "isLeapMonth": false },
      "yearGanzhi": "경오",
      "yearBasisNote": null,
      "fiveElementsClass": { "key": "earth5", "label": "토오국" },
      "soulPalaceBranch": { "key": "xu", "label": "술" },
      "bodyPalaceBranch": { "key": "zi", "label": "자" },
      …

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

ราคา

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

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

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

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

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

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