API ซาจู › API กราฟดวงชะตา

API กราฟดวงชะตา

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

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

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

วิธีอ่านค่าแกนตั้ง

ค่าแกนตั้งคือ “คะแนนฝั่งก้านวันเกิดเมื่อเพิ่มอักษรดวงจร” เป็นค่าที่นำคะแนนรวมความแข็ง-อ่อนของผังดวง มาบวกกับส่วนแบ่งที่ให้คะแนนอักษรดวงจรแต่ละตัวด้วยตารางคะแนนต่ออักษรแบบเดียวกับผังดวง (การสนับสนุน·การควบคุม·ก้านแฝง·ราก) แล้วตัดไว้ที่ ±100 ไม่ได้วัดว่าดวงดีหรือร้าย ชื่อดวงแข็ง·สมดุล·ดวงอ่อนใช้ตามผังดวงเดิม ดวงรายเดือนไม่มีเส้นสะสม ให้เฉพาะส่วนแบ่งดวงของเดือนนั้น (delta)

ช่วงเวลาและดวงรายเดือน

กำหนดช่วงของดวงรายปี (ปีปฏิทินสากล สูงสุด 101 ปี) ด้วย range แนะนำให้รับข้อมูลตั้งแต่ปีเกิดถึงปีเกิด+100 ไว้ครั้งเดียว แล้วตัดใช้บนหน้าจอ monthsOfYear คือปีซาจู (ตั้งแต่วันเริ่มฤดูใบไม้ผลิ (ลี่ชุน) ของปีนั้นจนถึงก่อนวันเริ่มฤดูใบไม้ผลิของปีถัดไป) ที่จะใช้คำนวณดวงรายเดือน 12 ช่อง หากละไว้จะใช้ปีซาจูที่เวลาปัจจุบัน (เวลาเกาหลี) อยู่ และหากเป็น null จะไม่มีชั้นดวงรายเดือน

เวลาเกิด·เพศ·สถานที่เกิด

หากไม่มี birthTime จะถือว่าไม่ทราบเสายาม คำนวณจาก 6 อักษร และแนบ hourKnown: false หากไม่มี gender จะไม่มีชั้นวัยจร 10 ปี สถานที่เกิด (birthLatitude·birthLongitude·country) เป็นฟิลด์เดียวกับ API ปฏิทินหมื่นปี และปรับแก้เป็นเวลาสุริยะจริงด้วยวิธีเดียวกัน ต้องส่งตำแหน่งที่ส่งให้ปฏิทินหมื่นปีมาให้กราฟดวงชะตาแบบเดียวกัน ผลลัพธ์ทั้งสองจึงจะใช้ผังดวงเดียวกัน

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

{
  "birthDate": "1990-05-15",
  "birthTime": "14:30",
  "calendar": "solar",
  "gender": "male",
  "timezone": "Asia/Seoul",
  "range": { "fromYear": 1990, "toYear": 2090 },
  "monthsOfYear": 2026
}

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

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

{
  "success": true,
  "data": {
    "engineVersion": "saju-flow-6",
    "kbVersion": "2026.10.11-7",
    "hourKnown": true,
    "natalAmbiguous": null,
    "natal": {
      "score": -37, "result": "중화", "level": "약약",
      "breakdown": { "season": -30, "support": 36, "control": -28, "hidden": -5, "root": 5 },
      "primaryYongshin": "토",
      "shin": { "yongshin": "토", "huishin": "화", "gishin": "목", "gushin": "수", "hanshin": "금" },
      "ruleIds": ["R-SAJU-STR-001", "R-SAJU-STR-018", "R-SAJU-STR-019", "R-SAJU-YONG-170"]
    },
    "daeun": [
      { "startYear": 1997, "endYear": 2006, "startAge": 7,
        "chars": [
          { "pos": "stem", "char": "임", "hanja": "壬", "ohaeng": "수", "sipsin": "식신", "shinRole": "gushin",
            "share": { "support": 0, "control": -8, "hidden": 0, "root": 0, "total": -8 } },
          { "pos": "branch", "char": "오", "hanja": "午", "ohaeng": "화", "sipsin": "정관", "shinRole": "huishin",
            "share": { "support": 0, "control": -10, "hidden": -5, "root": 0, "total": -15 } }
        ],
        "delta": -23, "line": { "value": -60, "clamped": false },
        …

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

ราคา

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

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

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

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

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

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