API ซาจู › API ปฏิทินหมื่นปี

API ปฏิทินหมื่นปี

เมื่อส่งวันเดือนปีและเวลาเกิด (พร้อมเพศและเขตเวลา) เข้ามา ระบบจะส่งคืนผังดวงซาจู 4 เสาตามจุดเปลี่ยนฤดู การวิเคราะห์ผังดวง และวัยจร 10 ปี·ดวงรายปีในรูปแบบ JSON ชื่อสินค้าคือ “ปฏิทินหมื่นปี” และอัตลักษณ์ซาจู (identity) ก็อยู่ในการตอบกลับเดียวกัน คำนวณตามกฎ ข้อมูลนำเข้าเหมือนกันจึงได้ผลลัพธ์เหมือนกัน

คู่มือเริ่มต้นใช้งาน ทดลองโดยไม่ต้องใช้คีย์ ตารางราคา

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

เมื่อไม่ทราบเวลาเกิด

ละ hour·minute ได้ หากละ hour ระบบจะไม่สมมติว่าเป็นเวลาเที่ยงวัน แต่จะตัดเสายามออก ฟิลด์วิเคราะห์อย่างธาตุช่วย·รูปแบบดวง·ความแข็ง-อ่อนของดวงจะคำนวณจาก 3 เสา ปี·เดือน·วัน แล้วส่งคืนตามนั้น และใน birthHour ของการตอบกลับจะมีเครื่องหมายระบุว่าคำนวณจาก 3 เสา

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

curl -X POST https://api.hrum.ai/api/v1/partners/v1/manseryeok \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2000, "month": 1, "day": 15, "hour": 14, "minute": 30,
    "gender": "male", "calendar": "solar", "timezone": "Asia/Seoul"
  }'

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

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

{
  "success": true,
  "data": {
    "wonkuk": {
      "year": {
        "stem": "기", "branch": "묘", "stemHanja": "己", "branchHanja": "卯",
        "ohaeng": "토", "stemSipsin": "정관", "branchSipsin": "상관",
        "jijanggan": ["갑", "을"], "chunghyung": [], "hapPosition": ["半合(반합)"],
        "ungSung": "사", "napEum": "성두토",
        "majorSinsal": ["장성살"],
        "minorSinsal": ["천을귀인", "귀문관살", "원진살", "현침살", "육해살"]
      },
      "month": { ... },
      "day": { ... },
      "hour": { ... }
    },
    "trueSolarTime": null,
    "ohaengBalance": { "목": 1, "화": 2, "토": 3, "금": 1, "수": 1 },
    "yongshin": "수",
    "johuYongshin": "화",
    "yongshinDetail": {
      "method": "억부",
      "primary": "수",
      "secondary": ["금"],
      "reasoning": ["일간 임(수) 신약", "신약 + root 있음(8) → 비겁(수)"],
      "shin": { "yongshin": "수", "huishin": "금", "gishin": "토", "gushin": "화", "hanshin": "목" },
      "favorable_sipsin": ["편인", "정인", "비견", "겁재"],
      "unfavorable_sipsin": ["편관", "정관", "편재", "정재", "식신", "상관"],
      "element_states": { "목": { "count": 1, "state": "lack", "effect": "neutral" }, "...": "5오행" }
    },
    "eokbuYongshin": "수",
    "ilganSummary": "壬水 — 큰 바다의 기운. 지혜롭고 포용력이 넓어요.",
    …

นี่คือส่วนต้นของการตอบกลับคำขอเพศชาย 2000-01-15 14:30 การตอบกลับฉบับเต็มที่มีครบทั้งวัยจร 10 ปี·ดวงรายปี·รูปแบบดวง·ความแข็ง-อ่อนของดวงและคำอธิบายฟิลด์อยู่ในเอกสารอ้างอิง

ราคา

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

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

ตารางราคาทั้งหมด · แม้ไม่มีคีย์ก็ทดลองได้ที่ Playground สูงสุดเดือนละ 5 ครั้งต่อ IP

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

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

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