จุดเชื่อมต่อ API

สำรวจจุดเชื่อมต่อทั้งหมดและพารามิเตอร์

URL ฐาน

https://api.trace-line.site/v1
POST

/v1/palm/analyze

วิเคราะห์ภาพฝ่ามือและตรวจจับเส้นหัวใจ เส้นสมอง และเส้นชีวิต

ส่วนหัวคำขอ

ส่วนหัวจำเป็นDescription
X-API-Keyใช่API key ของ Traceline
Content-Typeใช่ต้องเป็น application/json

เนื้อหาคำขอ

{
  "image": "<base64-encoded-image>"
}
  • image (จำเป็น) — ภาพ JPEG หรือ PNG แบบ Base64 ขนาดสูงสุด: 5MB

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

curl -X POST https://api.trace-line.site/v1/palm/analyze \
  -H "X-API-Key: trl_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"image": "<base64-encoded-image>"}'

การตอบกลับ

การตอบกลับที่สำเร็จจะส่งคืนอ็อบเจกต์ JSON พร้อมผลการวิเคราะห์

{
  "id": "req_abc123",
  "object": "palm.analysis",
  "created": 1700000000,
  "model": "traceline-v1",
  "results": {
    "overlay": "<base64-overlay-image>",
    "masks": {
      "heart": "<base64-mask>",
      "head": "<base64-mask>",
      "life": "<base64-mask>"
    },
    "stats": {
      "heart": {
        "pixels": 1842,
        "confidence": 0.94
      },
      "head": {
        "pixels": 1567,
        "confidence": 0.91
      },
      "life": {
        "pixels": 2103,
        "confidence": 0.96
      }
    }
  },
  "usage": {
    "requests_used": 42,
    "requests_limit": 100
  }
}

ฟิลด์การตอบกลับ

  • id — ตัวระบุคำขอที่ไม่ซ้ำ
  • object — เป็น "palm.analysis" เสมอ
  • created — Unix timestamp ของคำขอ
  • model — เวอร์ชันโมเดลที่ใช้
  • results.overlay — JPEG แบบ Base64 ที่มีเส้นที่ตรวจจับ
  • results.masks — มาสก์ PNG แยกสำหรับแต่ละเส้น
  • results.stats — สถิติการตรวจจับต่อเส้น
  • usage — ข้อมูลแผนและโควตาปัจจุบัน

ส่วนหัวการตอบกลับ

  • X-Monthly-Quota-Limit — โควตารายเดือนทั้งหมด
  • X-Monthly-Quota-Remaining — คำขอที่เหลือในเดือนนี้
GET

/v1/palm/health

ตรวจสอบว่าบริการ API ทำงานอยู่ ไม่ต้องยืนยันตัวตน

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

curl https://api.trace-line.site/v1/palm/health

การตอบกลับ

{
  "status": "ok"
}