API ซาจู › API ดวงวันนี้

API ดวงวันนี้

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

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

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

ตัวเลือกวันที่และสภาพอากาศ

หากละ date จะใช้วันนี้ตามเวลาเกาหลี หากส่ง temperatureC จะมีคำแนะนำการแต่งกายแนบมา และหากส่ง weather·humidity มาด้วย จะมีความเห็นเรื่องสภาพอากาศหนึ่งบรรทัดแยกตามช่วงเวลาแนบมาด้วย หากไม่ทราบเวลาเกิดจะคำนวณที่เวลาเที่ยงวันและแนบ birthHour มา

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

{
  "year": 1990, "month": 5, "day": 15, "hour": 12, "minute": 0,
  "timezone": "Asia/Seoul", "gender": "male",
  "date": "2026-10-10",
  "temperatureC": 16, "weather": "cloudy", "humidity": 60,
  "mbtiBehavior": true
}

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

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

{
  "success": true,
  "data": {
    …
    "omen": {
      "relation": { "type": "GEUK", "label": "조율의 날" },
      "color": { "name": "주황", "hex": "#FFA45B", "ohaeng": "화" },
      "food": "고추장비빔밥",
      "keyword": "공개",
      "message": "표현하고 싶은 마음과 주변 반응이 엇갈릴 수 있는 날이에요. 즉흥적인 말보다 한 박자 늦춘 표현이 좋아요.",
      "luckyHour": "오전 11시 ~ 오후 1시",
      "avoidHour": "밤 11시 이후",
      "activity": "칭찬 먼저 하기"
      …

ดึงเฉพาะส่วนดวงวันนี้จากการตอบกลับของคำขอข้างต้น (2026-10-10) การตอบกลับฉบับเต็มและคำอธิบายฟิลด์อยู่ในเอกสารอ้างอิง

ราคา

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

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

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

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

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

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