👤🔍 ระบบจดจำและตรวจจับใบหน้า API

0.1 - 0.3 ICต่อคำขอ (ขึ้นอยู่กับการดำเนินการ)

v1.3.0 Active POST /v3/store/ekyc/face-recognition

ภาพรวม

iApp Face Recognition API คือโซลูชันการจดจำใบหน้าที่ครอบคลุม ให้ความสามารถในการตรวจจับ จดจำ เปรียบเทียบใบหน้า และจัดการฐานข้อมูล สร้างขึ้นบนโมเดล Deep Learning ที่ทันสมัย API ของเรามอบความแม่นยำสูงและการประมวลผลที่รวดเร็วสำหรับการใช้งานที่หลากหลาย รวมถึงการรักษาความปลอดภัย การยืนยันตัวตน และการตรวจสอบบุคคล

ทดลองใช้ Demo!

Face Recognition API Demo

Test our face recognition endpoints with real-time results

API Key

Log in to use your API keys or Create an account

Base URL *

Current Endpoint

Endpoint changes based on selected tab

cURL Command

Recognizes the most prominent face in an image and matches it against your company's face database.

Upload Image *

Supported: JPG, JPEG, PNG (max 2MB)

Company Name *

คุณสมบัติหลัก

ความสามารถหลัก

• การตรวจจับใบหน้า (Face Detection): ตรวจจับใบหน้าเดียวหรือหลายใบหน้าในรูปภาพพร้อมพิกัดกล่องขอบเขต (bounding box)
• การจดจำใบหน้า (Face Recognition): ระบุบุคคลที่รู้จักจากฐานข้อมูลใบหน้าของคุณ
• การเปรียบเทียบใบหน้า (Face Comparison): เปรียบเทียบใบหน้าสองใบหน้าเพื่อพิจารณาว่ามาจากบุคคลเดียวกันหรือไม่
• การจัดการฐานข้อมูล (Database Management): เพิ่ม ลบ นำเข้า และส่งออกบันทึกใบหน้า
• เกณฑ์ที่กำหนดค่าได้ (Configurable Thresholds): ปรับแต่งความไวในการตรวจจับและการจดจำ
• รองรับหลายใบหน้า (Multi-face Support): ประมวลผลรูปภาพที่มีหลายใบหน้าพร้อมกัน

คุณสมบัติทางเทคนิค

• การตรวจจับใบหน้าที่แม่นยำสูง (99%+ สำหรับใบหน้าตรง)
• เวลาประมวลผลที่รวดเร็ว (โดยทั่วไป 0.3-1.0 วินาที)
• รองรับรูปแบบรูปภาพที่หลากหลาย (JPEG, JPG, PNG)
• ขนาดไฟล์สูงสุด: 2MB
• ฐานข้อมูลใบหน้าเฉพาะของบริษัท
• การจับคู่ตามคะแนนพร้อมเกณฑ์ที่กำหนดค่าได้
• RESTful API พร้อมการผสานรวมที่ง่าย

เริ่มต้นใช้งาน

ข้อกำหนดเบื้องต้น

• API Key: รับจาก iApp API Portal
• บัญชีบริษัท (Company Account): ลงทะเบียนบริษัทของคุณเพื่อจัดการฐานข้อมูลใบหน้า
• ข้อกำหนดเกี่ยวกับรูปภาพ:
  • รูปแบบ: JPEG, JPG, PNG
  • ขนาดสูงสุด: 2MB
  • ความละเอียดขั้นต่ำ: 600x400 พิกเซล
  • ขนาดใบหน้าขั้นต่ำ: 112x112 พิกเซล

ตัวอย่างการเริ่มต้นใช้งานอย่างรวดเร็ว

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/single \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@photo.jpg" \
  -F "company=iApp"

วิธีรับ API Key?

กรุณาไปที่หน้า API Key Management เพื่อดู API Key ที่มีอยู่ของคุณ หรือขอรับ API Key ใหม่

API Endpoints

Endpoints การจดจำใบหน้า (Recognition Endpoints)

Endpoint	Method	คำอธิบาย	ค่าบริการ
/v3/store/ekyc/face-recognition/single	POST	จดจำใบหน้าที่เด่นที่สุด	0.3 IC

| /v3/store/ekyc/face-recognition/multi | POST | จดจำใบหน้าทั้งหมดในรูปภาพ | 0.3 IC | | /v3/store/ekyc/face-recognition/add | POST | เพิ่มใบหน้าใหม่ในฐานข้อมูล | 0.1 IC | | /v3/store/ekyc/face-recognition/remove | POST | ลบใบหน้าออกจากฐานข้อมูล | 0 IC | | /v3/store/ekyc/face-recognition/check | POST | ตรวจสอบสถานะฐานข้อมูล | 0.3 IC | | /v3/store/ekyc/face-recognition/import | POST | นำเข้าคุณลักษณะใบหน้า (CSV) | 0 IC | | /v3/store/ekyc/face-recognition/export | POST | ส่งออกคุณลักษณะใบหน้า | 0 IC |

Endpoints การตรวจจับใบหน้า (Detection Endpoints)

Endpoint	Method	คำอธิบาย	ค่าบริการ
/v3/store/ekyc/face-detection/single	POST	ตรวจจับใบหน้าเดียวพร้อมกล่องขอบเขต	0.3 IC
/v3/store/ekyc/face-detection/multi	POST	ตรวจจับใบหน้าทั้งหมดในรูปภาพ	0.3 IC

Endpoint การเปรียบเทียบใบหน้า (Comparison Endpoint)

Endpoint	Method	คำอธิบาย	ค่าบริการ
/v3/store/ekyc/face-comparison	POST	เปรียบเทียบใบหน้าสองใบหน้าเพื่อดูความเหมือน	0.3 IC

Endpoints การตั้งค่า (Configuration Endpoints)

Endpoint	Method	คำอธิบาย	ค่าบริการ
/v3/store/ekyc/face-recognition/config	POST	ตั้งค่าเกณฑ์การตรวจจับ/จดจำ	0 IC
/v3/store/ekyc/face-recognition/password/change	POST	เปลี่ยนรหัสผ่านบริษัท	0 IC

Endpoints ผู้ดูแลระบบ (Admin Endpoints)

Endpoint	Method	คำอธิบาย	ค่าบริการ
/v3/store/ekyc/face-recognition/admin/import	POST	ผู้ดูแลระบบ: นำเข้าคุณลักษณะ	0 IC
/v3/store/ekyc/face-recognition/admin/export	POST	ผู้ดูแลระบบ: ส่งออกคุณลักษณะ	0 IC
/v3/store/ekyc/face-recognition/admin/config	POST	ผู้ดูแลระบบ: ตั้งค่าเกณฑ์	0 IC
/v3/store/ekyc/face-recognition/admin/check	POST	ผู้ดูแลระบบ: ตรวจสอบฐานข้อมูล	0 IC
/v3/store/ekyc/face-recognition/admin/password/change	POST	ผู้ดูแลระบบ: เปลี่ยนรหัสผ่าน	0 IC

---

อ้างอิง API

Endpoints การจดจำใบหน้า (Recognition Endpoints)

การจดจำใบหน้าเดียว (Single Face Recognition)

Endpoint: POST /v3/store/ekyc/face-recognition/single

จดจำใบหน้าที่เด่นที่สุดในรูปภาพ และจับคู่กับฐานข้อมูลใบหน้าของบริษัทของคุณ

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
file	File	ใช่	ไฟล์รูปภาพ (JPEG, JPG, PNG, สูงสุด 2MB)
company	String	ใช่	รหัสระบุบริษัทของคุณ

รูปแบบการตอบกลับ (Response Format):

{
  "message": "successfully performed",
  "company": "YOUR_COMPANY",
  "name": "John Doe",
  "recognition_score": 0.8523,
  "detection_score": 0.9998,
  "bbox": {
    "xmin": 154.39,
    "ymin": 155.49,
    "xmax": 255.45,
    "ymax": 282.88
  },
  "process_time": 0.4776
}

ฟิลด์การตอบกลับ (Response Fields):

• name: ชื่อบุคคลที่ระบุ (หรือ "unknown" หากไม่พบการจับคู่)
• recognition_score: คะแนนความมั่นใจในการจดจำ (0-1)
• detection_score: คะแนนความมั่นใจในการตรวจจับใบหน้า (0-1)
• bbox: พิกัดกล่องขอบเขตของใบหน้า
• process_time: เวลาประมวลผลเป็นวินาที

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/single \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@face.jpg" \
  -F "company=iApp"

---

การจดจำหลายใบหน้า (Multi-Face Recognition)

Endpoint: POST /v3/store/ekyc/face-recognition/multi

จดจำใบหน้าทั้งหมดในรูปภาพ ส่งคืนอาร์เรย์ของผลลัพธ์สำหรับใบหน้าแต่ละใบหน้าที่ตรวจจับได้

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
file	File	ใช่	ไฟล์รูปภาพ (JPEG, JPG, PNG, สูงสุด 2MB)
company	String	ใช่	รหัสระบุบริษัทของคุณ

รูปแบบการตอบกลับ (Response Format):

{
  "message": "successfully performed",
  "company": "YOUR_COMPANY",
  "faces": [
    {
      "name": "John Doe",
      "recognition_score": 0.8523,
      "detection_score": 0.9998,
      "bbox": {
        "xmin": 154.39,
        "ymin": 155.49,
        "xmax": 255.45,
        "ymax": 282.88
      }
    },
    {
      "name": "Jane Smith",
      "recognition_score": 0.7891,
      "detection_score": 0.9995,
      "bbox": {
        "xmin": 350.12,
        "ymin": 180.34,
        "xmax": 450.67,
        "ymax": 310.23
      }
    }
  ],
  "process_time": 0.6234
}

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/multi \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@group_photo.jpg" \
  -F "company=iApp"

---

เพิ่มใบหน้าในฐานข้อมูล (Add Face to Database)

Endpoint: POST /v3/store/ekyc/face-recognition/add

เพิ่มใบหน้าใหม่ในฐานข้อมูลการจดจำของบริษัทของคุณ เป็นการลงทะเบียนบุคคลเพื่อการจดจำในอนาคต

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
file	File	ใช่	รูปภาพใบหน้าที่ชัดเจน (JPEG, JPG, PNG, สูงสุด 2MB)
company	String	ใช่	รหัสระบุบริษัทของคุณ
name	String	ใช่	ชื่อบุคคลสำหรับการระบุตัวตน
password	String	ใช่	รหัสผ่านบริษัทสำหรับการยืนยันตัวตน

รูปแบบการตอบกลับ (Response Format):

{
  "message": "successfully performed",
  "company": "YOUR_COMPANY",
  "name": "John Doe",
  "face_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "detection_score": 0.9998
}

ฟิลด์การตอบกลับ (Response Fields):

• face_id: ตัวระบุที่ไม่ซ้ำกันสำหรับใบหน้าที่เพิ่มเข้ามา
• detection_score: คะแนนคุณภาพของรูปภาพใบหน้า
• name: ชื่อบุคคลที่ลงทะเบียน

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/add \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@john_doe.jpg" \
  -F "company=iApp" \
  -F "name=John Doe" \
  -F "password=iApp"

รหัสผ่าน Demo

สำหรับบริษัท Demo "iApp" รหัสผ่านคือ "iApp" คุณสามารถใช้รหัสนี้เพื่อทดสอบ API endpoints การจดจำใบหน้า

แนวทางปฏิบัติที่ดีที่สุด (Best Practices):

• ใช้รูปภาพใบหน้าที่ชัดเจน ด้านหน้า
• ตรวจสอบให้แน่ใจว่ามีแสงสว่างเพียงพอ
• หลีกเลี่ยงรูปภาพเบลอหรือคุณภาพต่ำ
• หนึ่งใบหน้าต่อหนึ่งรูปภาพ
• บุคคลควรหันหน้าเข้ากล้อง

---

ลบใบหน้าออกจากฐานข้อมูล (Remove Face from Database)

Endpoint: POST /v3/store/ekyc/face-recognition/remove

ลบบันทึกใบหน้าออกจากฐานข้อมูลของบริษัทของคุณ

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
company	String	ใช่	รหัสระบุบริษัทของคุณ
name	String	ใช่	ชื่อบุคคลที่ต้องการลบ
password	String	ใช่	รหัสผ่านบริษัทสำหรับการยืนยันตัวตน
face_id	String	ไม่	ID ใบหน้าที่ต้องการลบ (หากมีหลายรายการ)

รูปแบบการตอบกลับ (Response Format):

{
  "message": "face removed successfully",
  "company": "YOUR_COMPANY",
  "name": "John Doe",
  "removed_count": 1
}

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/remove \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "name=John Doe" \
  -F "password=iApp"

พร้อม ID ใบหน้าเฉพาะ:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/remove \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "name=John Doe" \
  -F "face_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -F "password=iApp"

---

ตรวจสอบฐานข้อมูลใบหน้า (Check Face Database)

Endpoint: POST /v3/store/ekyc/face-recognition/check

ตรวจสอบสถานะและเนื้อหาของฐานข้อมูลใบหน้าของบริษัทของคุณ ส่งคืนสถิติ และส่งออกไฟล์รายงานตามต้องการ

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
company	String	ใช่	รหัสระบุบริษัทของคุณ
password	String	ใช่	รหัสผ่านบริษัทสำหรับการยืนยันตัวตน
save_file	String	ไม่	ตั้งค่าเป็น "True" หรือ "1" เพื่อส่งออกไฟล์รายงาน

รูปแบบการตอบกลับ (Response Format) (ไม่ส่งออกไฟล์):

{
  "message": "successfully performed",
  "company": "YOUR_COMPANY",
  "total_faces": 145,
  "total_persons": 145,
  "database_size": "2.3 MB",
  "last_updated": "2025-01-15T10:30:00Z"
}

รูปแบบการตอบกลับ (Response Format) (ส่งออกไฟล์):

ส่งคืนไฟล์ CSV ที่มีรายงานฐานข้อมูลใบหน้า

ตัวอย่าง:

# รับสถิติฐานข้อมูล
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/check \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp"

# ส่งออกรายงานฐานข้อมูล
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/check \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp" \
  -F "save_file=True" \
  -o database_report.csv

---

นำเข้าคุณลักษณะใบหน้า (Import Face Features)

Endpoint: POST /v3/store/ekyc/face-recognition/import

นำเข้าคุณลักษณะใบหน้าที่คำนวณไว้ล่วงหน้าจากไฟล์ CSV ลงในฐานข้อมูลของบริษัทของคุณ มีประโยชน์สำหรับการนำเข้าจำนวนมากหรือการย้ายฐานข้อมูล

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
file	File	ใช่	ไฟล์ CSV ที่มีคุณลักษณะใบหน้า
company	String	ใช่	รหัสระบุบริษัทของคุณ
password	String	ใช่	รหัสผ่านบริษัทสำหรับการยืนยันตัวตน

รูปแบบไฟล์ CSV (CSV File Format):

ไฟล์ CSV ควรมีเวกเตอร์คุณลักษณะใบหน้า โดยมีคอลัมน์: name, face_id, feature_vector (ค่าทศนิยมคั่นด้วยจุลภาค)

รูปแบบการตอบกลับ (Response Format):

{
  "message": "successfully performed",
  "company": "YOUR_COMPANY",
  "imported_count": 50,
  "failed_count": 0,
  "total_processed": 50
}

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/import \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@face_features.csv" \
  -F "company=iApp" \
  -F "password=iApp"

หมายเหตุ: การนำเข้าไม่พร้อมใช้งานสำหรับบัญชี Demo

---

ส่งออกคุณลักษณะใบหน้า (Export Face Features)

Endpoint: POST /v3/store/ekyc/face-recognition/export

ส่งออกคุณลักษณะใบหน้าจากฐานข้อมูลของบริษัทของคุณไปยังไฟล์ รองรับรูปแบบ CSV และ Excel

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
company	String	ใช่	รหัสระบุบริษัทของคุณ
password	String	ใช่	รหัสผ่านบริษัทสำหรับการยืนยันตัวตน
type_file	String	ใช่	รูปแบบการส่งออก: "csv" หรือ "excel"

การตอบกลับ:

ส่งคืนไฟล์ดาวน์โหลดพร้อมคุณลักษณะใบหน้าที่ส่งออก

ตัวอย่าง:

# ส่งออกเป็น CSV
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/export \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp" \
  -F "type_file=csv" \
  -o face_features.csv

# ส่งออกเป็น Excel
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/export \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp" \
  -F "type_file=excel" \
  -o face_features.xlsx

หมายเหตุ: การส่งออกไม่พร้อมใช้งานสำหรับบัญชี Demo

---

Endpoints การตรวจจับใบหน้า (Detection Endpoints)

การตรวจจับใบหน้าเดียว (Single Face Detection)

Endpoint: POST /v3/store/ekyc/face-detection/single

ตรวจจับใบหน้าที่เด่นที่สุดในรูปภาพ และส่งคืนพิกัดกล่องขอบเขตโดยไม่ต้องทำการจดจำ

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
file	File	ใช่	ไฟล์รูปภาพ (JPEG, JPG, PNG, สูงสุด 2MB)
company	String	ไม่	รหัสระบุบริษัท (ไม่บังคับ)

รูปแบบการตอบกลับ (Response Format):

{
  "message": "successfully performed",
  "detection_score": 0.9998,
  "bbox": {
    "xmin": 154.39,
    "ymin": 155.49,
    "xmax": 255.45,
    "ymax": 282.88
  },
  "process_time": 0.2134
}

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-detection/single \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@photo.jpg"

---

การตรวจจับหลายใบหน้า (Multi-Face Detection)

Endpoint: POST /v3/store/ekyc/face-detection/multi

ตรวจจับใบหน้าทั้งหมดในรูปภาพ และส่งคืนพิกัดกล่องขอบเขตสำหรับใบหน้าแต่ละใบโดยไม่ต้องทำการจดจำ

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
file	File	ใช่	ไฟล์รูปภาพ (JPEG, JPG, PNG, สูงสุด 2MB)
company	String	ไม่	รหัสระบุบริษัท (ไม่บังคับ)

รูปแบบการตอบกลับ (Response Format):

{
  "message": "successfully performed",
  "faces": [
    {
      "detection_score": 0.9998,
      "bbox": {
        "xmin": 154.39,
        "ymin": 155.49,
        "xmax": 255.45,
        "ymax": 282.88
      }
    },
    {
      "detection_score": 0.9995,
      "bbox": {
        "xmin": 350.12,
        "ymin": 180.34,
        "xmax": 450.67,
        "ymax": 310.23
      }
    }
  ],
  "total_faces": 2,
  "process_time": 0.3567
}

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-detection/multi \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@group_photo.jpg"

---

Endpoint การเปรียบเทียบใบหน้า (Comparison Endpoint)

เปรียบเทียบใบหน้าสองใบหน้า (Compare Two Faces)

Endpoint: POST /v3/store/ekyc/face-comparison

เปรียบเทียบรูปภาพใบหน้าสองใบหน้าเพื่อพิจารณาว่ามาจากบุคคลเดียวกันหรือไม่ ส่งคืนคะแนนความเหมือน

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
file1	File	ใช่	รูปภาพใบหน้าแรก (JPEG, JPG, PNG, สูงสุด 2MB)
file2	File	ใช่	รูปภาพใบหน้าสอง (JPEG, JPG, PNG, สูงสุด 2MB)
company	String	ไม่	รหัสระบุบริษัท (ไม่บังคับ)
min_score	Float	ไม่	เกณฑ์ความเหมือนขั้นต่ำ (0-1)

รูปแบบการตอบกลับ (Response Format):

{
  "message": "successfully performed",
  "status": {
    "face1_detected": true,
    "face2_detected": true,
    "match": true
  },
  "similarity_score": 0.8734,
  "comparison_score": 0.8734,
  "face1_bbox": {
    "xmin": 154.39,
    "ymin": 155.49,
    "xmax": 255.45,
    "ymax": 282.88
  },
  "face2_bbox": {
    "xmin": 180.23,
    "ymin": 170.12,
    "xmax": 280.56,
    "ymax": 295.34
  },
  "process_time": 0.5423
}

ฟิลด์การตอบกลับ (Response Fields):

• match: Boolean บ่งชี้ว่าใบหน้าตรงกันหรือไม่ (ตามเกณฑ์)
• similarity_score: คะแนนความเหมือนระหว่างใบหน้า (0-1)
• status: สถานะการตรวจจับสำหรับใบหน้าทั้งสอง
• face1_bbox, face2_bbox: กล่องขอบเขตสำหรับใบหน้าที่ตรวจจับได้

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-comparison \
  -H "apikey: YOUR_API_KEY" \
  -F "file1=@person1.jpg" \
  -F "file2=@person2.jpg"

พร้อมเกณฑ์คะแนนขั้นต่ำ:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-comparison \
  -H "apikey: YOUR_API_KEY" \
  -F "file1=@person1.jpg" \
  -F "file2=@person2.jpg" \
  -F "min_score=0.8"

---

Endpoints การตั้งค่า (Configuration Endpoints)

การตั้งค่าเกณฑ์ (Configure Thresholds)

Endpoint: POST /v3/store/ekyc/face-recognition/config

ตั้งค่าเกณฑ์คะแนนการตรวจจับและการจดจำสำหรับบริษัทของคุณ เกณฑ์เหล่านี้กำหนดคะแนนความมั่นใจขั้นต่ำที่จำเป็นสำหรับการตรวจจับและการจดจำใบหน้าที่สำเร็จ

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
company	String	ใช่	รหัสระบุบริษัทของคุณ
password	String	ใช่	รหัสผ่านบริษัทสำหรับการยืนยันตัวตน
detection	Float	ไม่	เกณฑ์การตรวจจับ (0-100 หรือ 0-1)
comparison	Float	ไม่	เกณฑ์การเปรียบเทียบ (0-100 หรือ 0-1)
recognition	Float	ไม่	เกณฑ์การจดจำ (0-100 หรือ 0-1)

รูปแบบการตอบกลับ (Response Format):

{
  "message": "the minimum score of detection, comparison and recognition has been successfully configured.",
  "company": "YOUR_COMPANY",
  "detection_score": 0.75,
  "comparison_score": 0.80,
  "recognition_score": 0.85
}

ตัวอย่าง:

# ตั้งค่าเกณฑ์ทั้งหมด
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/config \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp" \
  -F "detection=75" \
  -F "comparison=80" \
  -F "recognition=85"

# รับเกณฑ์ปัจจุบัน (ละเว้นพารามิเตอร์คะแนน)
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/config \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp"

# ตั้งค่าเฉพาะเกณฑ์การจดจำ
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/config \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp" \
  -F "recognition=90"

แนวทางการตั้งค่าเกณฑ์ (Threshold Guidelines):

• การตรวจจับ (default ~0.75): ความมั่นใจขั้นต่ำสำหรับการตรวจจับใบหน้า

  • ต่ำลง: ตรวจจับใบหน้ามากขึ้น (อาจรวมถึง false positives)
  • สูงขึ้น: ตรวจจับเฉพาะใบหน้าที่ชัดเจน (อาจพลาดบางใบหน้า)

• การเปรียบเทียบ (default ~0.80): ความเหมือนขั้นต่ำสำหรับการจับคู่ใบหน้า

  • ต่ำลง: การจับคู่ที่ผ่อนปรนมากขึ้น (อาจจับคู่กับบุคคลที่แตกต่างกัน)
  • สูงขึ้น: การจับคู่ที่เข้มงวดมากขึ้น (อาจปฏิเสธบุคคลเดียวกัน)

• การจดจำ (default ~0.85): ความมั่นใจขั้นต่ำสำหรับการระบุตัวบุคคล

  • ต่ำลง: การจดจำที่อนุญาตมากขึ้น (อาจระบุผิด)
  • สูงขึ้น: การจดจำที่จำกัดมากขึ้น (อาจไม่สามารถจดจำได้)

หมายเหตุ: การกำหนดค่าไม่พร้อมใช้งานสำหรับบัญชี Demo

---

เปลี่ยนรหัสผ่าน (Change Password)

Endpoint: POST /v3/store/ekyc/face-recognition/password/change

เปลี่ยนรหัสผ่านของบริษัทของคุณสำหรับการยืนยันตัวตน API

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
company	String	ใช่	รหัสระบุบริษัทของคุณ
old_password	String	ใช่	รหัสผ่านปัจจุบัน
new_password	String	ใช่	รหัสผ่านใหม่ (ต้องแตกต่าง)

รูปแบบการตอบกลับ (Response Format):

{
  "message": "Setting new password completed."
}

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/password/change \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "old_password=current_password" \
  -F "new_password=new_secure_password"

หมายเหตุ: การเปลี่ยนรหัสผ่านไม่พร้อมใช้งานสำหรับบัญชี Demo

---

Endpoints ผู้ดูแลระบบ (Admin Endpoints)

Endpoints ผู้ดูแลระบบต้องใช้สิทธิ์ผู้ดูแลระบบพิเศษ และไม่พร้อมใช้งานสำหรับผู้ใช้ทั่วไป

ผู้ดูแลระบบ: นำเข้าคุณลักษณะ (Admin: Import Features)

Endpoint: POST /v3/store/ekyc/face-recognition/admin/import

นำเข้าคุณลักษณะใบหน้าลงในฐานข้อมูล Demo (เฉพาะผู้ดูแลระบบ)

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
company	String	ใช่	ต้องเป็น "admin"
password	String	ใช่	รหัสผ่านผู้ดูแลระบบ
file	File	ใช่	ไฟล์ CSV ที่มีคุณลักษณะใบหน้า

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/admin/import \
  -H "apikey: YOUR_API_KEY" \
  -F "company=admin" \
  -F "password=admin_password" \
  -F "file=@features.csv"

---

ผู้ดูแลระบบ: ส่งออกคุณลักษณะ (Admin: Export Features)

Endpoint: POST /v3/store/ekyc/face-recognition/admin/export

ส่งออกคุณลักษณะใบหน้าจากฐานข้อมูล Demo หรือสร้างการสำรองข้อมูล (เฉพาะผู้ดูแลระบบ)

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
company	String	ใช่	ต้องเป็น "admin"
password	String	ใช่	รหัสผ่านผู้ดูแลระบบ
type_file	String	ใช่	รูปแบบการส่งออก: "csv", "excel", หรือ "backup"

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/admin/export \
  -H "apikey: YOUR_API_KEY" \
  -F "company=admin" \
  -F "password=admin_password" \
  -F "type_file=backup" \
  -o backup.csv

---

ผู้ดูแลระบบ: ตั้งค่าเกณฑ์ (Admin: Configure Thresholds)

Endpoint: POST /v3/store/ekyc/face-recognition/admin/config

ตั้งค่าเกณฑ์คะแนนสำหรับบัญชีผู้ดูแลระบบหรือบัญชี Demo (เฉพาะผู้ดูแลระบบ)

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
company	String	ใช่	"admin" หรือ "demo"
password	String	ใช่	รหัสผ่านผู้ดูแลระบบ
detection	Float	ไม่	เกณฑ์การตรวจจับ (0-100 หรือ 0-1)
comparison	Float	ไม่	เกณฑ์การเปรียบเทียบ (0-100 หรือ 0-1)
recognition	Float	ไม่	เกณฑ์การจดจำ (0-100 หรือ 0-1)

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/admin/config \
  -H "apikey: YOUR_API_KEY" \
  -F "company=demo" \
  -F "password=admin_password" \
  -F "detection=70" \
  -F "recognition=80"

---

ผู้ดูแลระบบ: ตรวจสอบฐานข้อมูล (Admin: Check Database)

Endpoint: POST /v3/store/ekyc/face-recognition/admin/check

ตรวจสอบสถานะฐานข้อมูลของผู้ดูแลระบบหรือฐานข้อมูล Demo (เฉพาะผู้ดูแลระบบ)

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
company	String	ใช่	"admin" หรือ "demo"
password	String	ใช่	รหัสผ่านผู้ดูแลระบบ
save_file	String	ไม่	ตั้งค่าเป็น "True" หรือ "1" เพื่อส่งออกรายงาน

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/admin/check \
  -H "apikey: YOUR_API_KEY" \
  -F "company=demo" \
  -F "password=admin_password"

---

ผู้ดูแลระบบ: เปลี่ยนรหัสผ่าน (Admin: Change Password)

Endpoint: POST /v3/store/ekyc/face-recognition/admin/password/change

เปลี่ยนรหัสผ่านสำหรับบัญชีผู้ดูแลระบบหรือบัญชี Demo (เฉพาะผู้ดูแลระบบ)

พารามิเตอร์ที่ต้องการ (Request Parameters):

พารามิเตอร์	ชนิดข้อมูล	จำเป็น	คำอธิบาย
company	String	ใช่	"admin" หรือ "demo"
old_password	String	ใช่	รหัสผ่านผู้ดูแลระบบปัจจุบัน
new_password	String	ใช่	รหัสผ่านใหม่ (ต้องแตกต่าง)

ตัวอย่าง:

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/admin/password/change \
  -H "apikey: YOUR_API_KEY" \
  -F "company=demo" \
  -F "old_password=current_admin_password" \
  -F "new_password=new_admin_password"

---

รหัสข้อผิดพลาด (Error Codes)

API ใช้รหัสสถานะ HTTP มาตรฐาน และส่งคืนข้อความข้อผิดพลาดโดยละเอียด

รหัสสถานะ HTTP (HTTP Status Codes)

รหัสสถานะ	คำอธิบาย
200	สำเร็จ (Success)
404	Endpoint ไม่พบ
405	Method ไม่ได้รับอนุญาต (ใช้ POST)
413	Request entity ใหญ่เกินไป (ไฟล์ > 2MB)
415	ประเภทสื่อไม่รองรับ (ใช้ JPEG, JPG, PNG)
420	ขาดพารามิเตอร์ที่จำเป็น
421	ค่าพารามิเตอร์ไม่ถูกต้อง
422	รูปแบบพารามิเตอร์ไม่ถูกต้อง
423	ตรวจไม่พบใบหน้าในรูปภาพ
424	ตรวจพบหลายใบหน้า (ใช้ endpoint /multi)
425	รหัสผ่านใหม่เหมือนกับรหัสผ่านเดิม
426	ต้องมีสิทธิ์ผู้ดูแลระบบ
427	ไม่อนุญาตให้ดำเนินการสำหรับบัญชี Demo
428	การส่งออกฐานข้อมูลล้มเหลว
429	การนำเข้าล้มเหลว

รูปแบบการตอบกลับข้อผิดพลาด (Error Response Format)

{
  "message": "Error description",
  "error_code": 421,
  "parameter": "company"
}

ข้อผิดพลาดทั่วไป (Common Errors)

420 - ขาดพารามิเตอร์ที่จำเป็น (Missing Required Parameter)

{
  "message": "Missing required parameter: company",
  "error_code": 420,
  "parameter": "company"
}

421 - พารามิเตอร์ไม่ถูกต้อง (Invalid Parameter)

{
  "message": "Invalid value for parameter: password",
  "error_code": 421,
  "parameter": "password"
}

423 - ตรวจไม่พบใบหน้า (Face Not Detected)

{
  "message": "No face detected in the image",
  "error_code": 423
}

424 - ตรวจพบหลายใบหน้า (Multiple Faces Detected)

{
  "message": "Multiple faces detected. Please use /recog/multi endpoint",
  "error_code": 424
}

---

ตัวอย่างโค้ด (Code Examples)

Python

import requests

def recognize_face(image_path, api_key, company):
    """Recognize face in image"""
    url = "https://api.iapp.co.th/v3/store/ekyc/face-recognition/single"

    files = {
        'file': open(image_path, 'rb')
    }
    data = {
        'company': company
    }
    headers = {
        'apikey': api_key
    }

    response = requests.post(url, headers=headers, data=data, files=files)
    return response.json()

def add_face_to_database(image_path, api_key, company, name, password):
    """Add new face to database"""
    url = "https://api.iapp.co.th/v3/store/ekyc/face-recognition/add"

    files = {
        'file': open(image_path, 'rb')
    }
    data = {
        'company': company,
        'name': name,
        'password': password
    }
    headers = {
        'apikey': api_key
    }

    response = requests.post(url, headers=headers, data=data, files=files)
    return response.json()

def compare_faces(image1_path, image2_path, api_key):
    """Compare two faces"""
    url = "https://api.iapp.co.th/v3/store/ekyc/face-comparison"

    files = {
        'file1': open(image1_path, 'rb'),
        'file2': open(image2_path, 'rb')
    }
    headers = {
        'apikey': api_key
    }

    response = requests.post(url, headers=headers, files=files)
    return response.json()

# Usage examples
if __name__ == "__main__":
    API_KEY = "your_api_key"
    COMPANY = "your_company"

    # Recognize face
    result = recognize_face("photo.jpg", API_KEY, COMPANY)
    print(f"Recognized: {result['name']}")
    print(f"Confidence: {result['recognition_score']:.2%}")

    # Add face to database
    result = add_face_to_database(
        "john_doe.jpg",
        API_KEY,
        COMPANY,
        "John Doe",
        "your_password"
    )
    print(f"Added: {result['name']}")

    # Compare two faces
    result = compare_faces("face1.jpg", "face2.jpg", API_KEY)
    print(f"Match: {result['status']['match']}")
    print(f"Similarity: {result['similarity_score']:.2%}")

JavaScript (Node.js)

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

async function recognizeFace(imagePath, apiKey, company) {
    const formData = new FormData();
    formData.append('file', fs.createReadStream(imagePath));
    formData.append('company', company);

    try {
        const response = await axios.post(
            'https://api.iapp.co.th/v3/store/ekyc/face-recognition/single',
            formData,
            {
                headers: {
                    'apikey': apiKey,
                    ...formData.getHeaders()
                }
            }
        );
        return response.data;
    } catch (error) {
        console.error('Error:', error.response?.data || error.message);
        throw error;
    }
}

async function addFaceToDatabase(imagePath, apiKey, company, name, password) {
    const formData = new FormData();
    formData.append('file', fs.createReadStream(imagePath));
    formData.append('company', company);
    formData.append('name', name);
    formData.append('password', password);

    try {
        const response = await axios.post(
            'https://api.iapp.co.th/v3/store/ekyc/face-recognition/add',
            formData,
            {
                headers: {
                    'apikey': apiKey,
                    ...formData.getHeaders()
                }
            }
        );
        return response.data;
    } catch (error) {
        console.error('Error:', error.response?.data || error.message);
        throw error;
    }
}

async function compareFaces(image1Path, image2Path, apiKey) {
    const formData = new FormData();
    formData.append('file1', fs.createReadStream(image1Path));
    formData.append('file2', fs.createReadStream(image2Path));

    try {
        const response = await axios.post(
            'https://api.iapp.co.th/v3/store/ekyc/face-comparison',
            formData,
            {
                headers: {
                    'apikey': apiKey,
                    ...formData.getHeaders()
                }
            }
        );
        return response.data;
    } catch (error) {
        console.error('Error:', error.response?.data || error.message);
        throw error;
    }
}

// Usage examples
(async () => {
    const API_KEY = 'your_api_key';
    const COMPANY = 'your_company';

    try {
        // Recognize face
        const result = await recognizeFace('photo.jpg', API_KEY, COMPANY);
        console.log('Recognized:', result.name);
        console.log('Confidence:', result.recognition_score);

        // Add face to database
        const addResult = await addFaceToDatabase(
            'john_doe.jpg',
            API_KEY,
            COMPANY,
            'John Doe',
            'your_password'
        );
        console.log('Added:', addResult.name);

        // Compare two faces
        const compareResult = await compareFaces('face1.jpg', 'face2.jpg', API_KEY);
        console.log('Match:', compareResult.status.match);
        console.log('Similarity:', compareResult.similarity_score);
    } catch (error) {
        console.error('Error:', error);
    }
})();

JavaScript (Browser)

// Face Recognition Function
async function recognizeFace(fileInput, apiKey, company) {
    const formData = new FormData();
    formData.append('file', fileInput.files[0]);
    formData.append('company', company);

    try {
        const response = await fetch('https://api.iapp.co.th/v3/store/ekyc/face-recognition/single', {
            method: 'POST',
            headers: {
                'apikey': apiKey
            },
            body: formData
        });

        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error:', error);
        throw error;
    }
}

// Add Face to Database
async function addFaceToDatabase(fileInput, apiKey, company, name, password) {
    const formData = new FormData();
    formData.append('file', fileInput.files[0]);
    formData.append('company', company);
    formData.append('name', name);
    formData.append('password', password);

    try {
        const response = await fetch('https://api.iapp.co.th/v3/store/ekyc/face-recognition/add', {
            method: 'POST',
            headers: {
                'apikey': apiKey
            },
            body: formData
        });

        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error:', error);
        throw error;
    }
}

// Compare Two Faces
async function compareFaces(fileInput1, fileInput2, apiKey) {
    const formData = new FormData();
    formData.append('file1', fileInput1.files[0]);
    formData.append('file2', fileInput2.files[0]);

    try {
        const response = await fetch('https://api.iapp.co.th/v3/store/ekyc/face-comparison', {
            method: 'POST',
            headers: {
                'apikey': apiKey
            },
            body: formData
        });

        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error:', error);
        throw error;
    }
}

// HTML Example
/*
<input type="file" id="faceImage" accept="image/*">
<input type="text" id="company" placeholder="Company">
<button onclick="handleRecognize()">Recognize Face</button>

<script>
async function handleRecognize() {
    const fileInput = document.getElementById('faceImage');
    const company = document.getElementById('company').value;
    const apiKey = 'your_api_key';

    const result = await recognizeFace(fileInput, apiKey, company);
    console.log('Result:', result);
    alert(`Recognized: ${result.name}\nConfidence: ${result.recognition_score}`);
}
</script>
*/

PHP

<?php

class FaceRecognitionAPI {
    private $apiKey;
    private $baseUrl = 'https://api.iapp.co.th';

    public function __construct($apiKey) {
        $this->apiKey = $apiKey;
    }

    public function recognizeFace($imagePath, $company) {
        $curl = curl_init();

        curl_setopt_array($curl, array(
            CURLOPT_URL => $this->baseUrl . '/v3/store/ekyc/face-recognition/single',
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_CUSTOMREQUEST => 'POST',
            CURLOPT_POSTFIELDS => array(
                'file' => new CURLFile($imagePath),
                'company' => $company
            ),
            CURLOPT_HTTPHEADER => array(
                'apikey: ' . $this->apiKey
            ),
        ));

        $response = curl_exec($curl);
        $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
        curl_close($curl);

        if ($httpCode !== 200) {
            throw new Exception("API request failed with code: $httpCode");
        }

        return json_decode($response, true);
    }

    public function addFaceToDatabase($imagePath, $company, $name, $password) {
        $curl = curl_init();

        curl_setopt_array($curl, array(
            CURLOPT_URL => $this->baseUrl . '/v3/store/ekyc/face-recognition/add',
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_CUSTOMREQUEST => 'POST',
            CURLOPT_POSTFIELDS => array(
                'file' => new CURLFile($imagePath),
                'company' => $company,
                'name' => $name,
                'password' => $password
            ),
            CURLOPT_HTTPHEADER => array(
                'apikey: ' . $this->apiKey
            ),
        ));

        $response = curl_exec($curl);
        $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
        curl_close($curl);

        if ($httpCode !== 200) {
            throw new Exception("API request failed with code: $httpCode");
        }

        return json_decode($response, true);
    }

    public function compareFaces($image1Path, $image2Path) {
        $curl = curl_init();

        curl_setopt_array($curl, array(
            CURLOPT_URL => $this->baseUrl . '/v3/store/ekyc/face-comparison',
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_CUSTOMREQUEST => 'POST',
            CURLOPT_POSTFIELDS => array(
                'file1' => new CURLFile($image1Path),
                'file2' => new CURLFile($image2Path)
            ),
            CURLOPT_HTTPHEADER => array(
                'apikey: ' . $this->apiKey
            ),
        ));

        $response = curl_exec($curl);
        $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
        curl_close($curl);

        if ($httpCode !== 200) {
            throw new Exception("API request failed with code: $httpCode");
        }

        return json_decode($response, true);
    }

    public function detectFaces($imagePath, $multiplefaces = false) {
        $endpoint = $multiplefaces ? '/v3/store/ekyc/face-detection/multi' : '/v3/store/ekyc/face-detection/single';
        $curl = curl_init();

        curl_setopt_array($curl, array(
            CURLOPT_URL => $this->baseUrl . $endpoint,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_CUSTOMREQUEST => 'POST',
            CURLOPT_POSTFIELDS => array(
                'file' => new CURLFile($imagePath)
            ),
            CURLOPT_HTTPHEADER => array(
                'apikey: ' . $this->apiKey
            ),
        ));

        $response = curl_exec($curl);
        $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
        curl_close($curl);

        if ($httpCode !== 200) {
            throw new Exception("API request failed with code: $httpCode");
        }

        return json_decode($response, true);
    }
}

// Usage example
$api = new FaceRecognitionAPI('your_api_key');

try {
    // Recognize face
    $result = $api->recognizeFace('photo.jpg', 'your_company');
    echo "Recognized: " . $result['name'] . "\n";
    echo "Confidence: " . ($result['recognition_score'] * 100) . "%\n";

    // Add face to database
    $result = $api->addFaceToDatabase('john_doe.jpg', 'your_company', 'John Doe', 'your_password');
    echo "Added: " . $result['name'] . "\n";

    // Compare two faces
    $result = $api->compareFaces('face1.jpg', 'face2.jpg');
    echo "Match: " . ($result['status']['match'] ? 'Yes' : 'No') . "\n";
    echo "Similarity: " . ($result['similarity_score'] * 100) . "%\n";

    // Detect faces
    $result = $api->detectFaces('group_photo.jpg', true);
    echo "Total faces detected: " . $result['total_faces'] . "\n";

} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}
?>

ตัวอย่าง cURL (cURL Examples)

# การจดจำใบหน้าเดียว (Single Face Recognition)
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/single \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@photo.jpg" \
  -F "company=YOUR_COMPANY"

# การจดจำหลายใบหน้า (Multi-Face Recognition)
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/multi \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@group_photo.jpg" \
  -F "company=YOUR_COMPANY"

# เพิ่มใบหน้าในฐานข้อมูล (Add Face to Database)
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/add \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@john_doe.jpg" \
  -F "company=iApp" \
  -F "name=John Doe" \
  -F "password=iApp"

# ลบใบหน้าออกจากฐานข้อมูล (Remove Face from Database)
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/remove \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "name=John Doe" \
  -F "password=iApp"

# เปรียบเทียบใบหน้าสองใบหน้า (Compare Two Faces)
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-comparison \
  -H "apikey: YOUR_API_KEY" \
  -F "file1=@face1.jpg" \
  -F "file2=@face2.jpg" \
  -F "min_score=0.8"

# ตรวจจับใบหน้าเดียว (Detect Single Face)
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-detection/single \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@photo.jpg"

# ตรวจจับหลายใบหน้า (Detect Multiple Faces)
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-detection/multi \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@group_photo.jpg"

# ตั้งค่าเกณฑ์ (Configure Thresholds)
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/config \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp" \
  -F "detection=75" \
  -F "recognition=85"

# ตรวจสอบฐานข้อมูล (Check Database)
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/check \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp"

# ส่งออกฐานข้อมูล (CSV) (Export Database (CSV))
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/export \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp" \
  -F "type_file=csv" \
  -o face_database.csv

# ส่งออกฐานข้อมูล (Excel) (Export Database (Excel))
curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/export \
  -H "apikey: YOUR_API_KEY" \
  -F "company=iApp" \
  -F "password=iApp" \
  -F "type_file=excel" \
  -o face_database.xlsx

---

แนวทางปฏิบัติที่ดีที่สุด (Best Practices)

แนวทางการคุณภาพรูปภาพ (Image Quality Guidelines)

เพื่อความแม่นยำในการจดจำใบหน้าที่ดีที่สุด:

1. ความละเอียดรูปภาพ (Image Resolution)

   • ขั้นต่ำ: 600x400 พิกเซล
   • แนะนำ: 1024x768 พิกเซล หรือสูงกว่า
   • ใบหน้าควรครอบครองพื้นที่อย่างน้อย 15-20% ของพื้นที่รูปภาพ

2. สภาพแสง (Lighting Conditions)

   • ใช้ใบหน้าที่มีแสงสว่างเพียงพอและสม่ำเสมอ
   • หลีกเลี่ยงเงาที่เข้มหรือแสงย้อนกลับ
   • แสงธรรมชาติหรือแสงสีขาวที่เป็นกลางทำงานได้ดีที่สุด
   • หลีกเลี่ยงสภาพแสงที่รุนแรง

3. ตำแหน่งใบหน้า (Face Position)

   • แนะนำ: มุมมองตรง (±15 องศา)
   • ดวงตาทั้งสองข้างควรมองเห็นได้
   • ใบหน้าควรอยู่ในแนวตั้ง
   • หลีกเลี่ยงมุมหรือการเอียงที่รุนแรง

4. คุณภาพรูปภาพ (Image Quality)

   • ใช้รูปภาพที่ชัดเจน คมชัด
   • หลีกเลี่ยงภาพเบลอจากการเคลื่อนไหว
   • ลดรอยแตกจากการบีบอัดให้น้อยที่สุด
   • ไม่มีฟิลเตอร์หรือการแก้ไขหนักๆ

5. การครอบคลุมใบหน้า (Face Coverage)

   • หลีกเลี่ยงแว่นกันแดด หน้ากาก หรือสิ่งกีดขวาง
   • เส้นผมไม่ควรบังตา
   • เครื่องประดับบนใบหน้าให้น้อยที่สุด
   • มองเห็นลักษณะใบหน้าได้ชัดเจน

การจัดการฐานข้อมูล (Database Management)

1. การเพิ่มใบหน้า (Adding Faces)

   • ใช้รูปภาพหลายรูปต่อบุคคล (แนะนำ 3-5 รูป) เพื่อความแม่นยำที่ดีขึ้น
   • รวมรูปภาพที่มีความแตกต่างเล็กน้อย (การแสดงออกที่แตกต่างกัน, แสงที่แตกต่างกัน)
   • ตรวจสอบให้แน่ใจว่ารูปภาพมีคุณภาพสูงสำหรับการลงทะเบียน
   • ใช้ชื่อที่สื่อความหมายและไม่ซ้ำกัน

2. การบำรุงรักษาประจำ (Regular Maintenance)

   • ตรวจสอบและทำความสะอาดฐานข้อมูลเป็นระยะ
   • ลบรายการที่ล้าสมัยหรือซ้ำซ้อน
   • สำรองฐานข้อมูลอย่างสม่ำเสมอโดยใช้คุณสมบัติการส่งออก
   • ตรวจสอบขนาดและประสิทธิภาพของฐานข้อมูล

3. ความปลอดภัย (Security)

   • ใช้รหัสผ่านที่รัดกุม
   • เปลี่ยนรหัสผ่านเป็นประจำ
   • จำกัดการเข้าถึงการดำเนินการที่ละเอียดอ่อน
   • รักษา API keys ให้ปลอดภัย

การเพิ่มประสิทธิภาพ (Performance Optimization)

1. การประมวลผลล่วงหน้าของรูปภาพ (Image Preprocessing)

   • ปรับขนาดรูปภาพขนาดใหญ่ก่อนอัปโหลด
   • บีบอัดรูปภาพโดยไม่สูญเสียคุณภาพ
   • ครอบตัดเพื่อเน้นบริเวณใบหน้า
   • แปลงเป็นรูปแบบ RGB

2. การดำเนินการเป็นชุด (Batch Operations)

   • ใช้การนำเข้า/ส่งออกสำหรับการดำเนินการจำนวนมาก
   • ใช้ตรรกะการลองใหม่สำหรับคำขอที่ล้มเหลว
   • จัดการ timeout อย่างเหมาะสม
   • ตรวจสอบข้อจำกัดอัตรา API (API rate limits)

3. การจัดการข้อผิดพลาด (Error Handling)

   • ใช้การจัดการข้อผิดพลาดที่เหมาะสม
   • บันทึกข้อผิดพลาดสำหรับการดีบัก
   • ให้ข้อเสนอแนะแก่ผู้ใช้สำหรับความล้มเหลว
   • ลองใหม่สำหรับข้อผิดพลาดชั่วคราว

การกำหนดค่าเกณฑ์ (Threshold Configuration)

1. เกณฑ์การตรวจจับ (Detection Threshold)

   • เริ่มต้นด้วยค่าเริ่มต้น (0.75)
   • เพิ่มขึ้นหากมี false positives มากเกินไป
   • ลดลงหากพลาดใบหน้าที่ถูกต้อง
   • ทดสอบด้วยคุณภาพรูปภาพทั่วไปของคุณ

2. เกณฑ์การจดจำ (Recognition Threshold)

   • เริ่มต้นด้วยค่าเริ่มต้น (0.85)
   • เพิ่มขึ้นเพื่อความปลอดภัยที่สูงขึ้น (การจับคู่ที่เข้มงวดขึ้น)
   • ลดลงสำหรับการจับคู่ที่ผ่อนปรนมากขึ้น
   • สร้างสมดุลระหว่าง false accepts และ false rejects

3. เกณฑ์การเปรียบเทียบ (Comparison Threshold)

   • ใช้เกณฑ์ที่สูงขึ้น (0.80-0.90) สำหรับการยืนยันตัวตน
   • ใช้เกณฑ์ที่ต่ำลง (0.70-0.80) สำหรับการระบุตัวตน
   • ทดสอบด้วยคู่ที่ตรงกัน/ไม่ตรงกันที่ทราบ
   • ปรับตามข้อกำหนดของ use case

---

กรณีการใช้งาน (Use Cases)

1. ระบบควบคุมการเข้าออก (Access Control Systems)

ใช้การจดจำใบหน้าเพื่อควบคุมการเข้าถึงทางกายภาพหรือดิจิทัล:

• การติดตามเวลาและการเข้างานของพนักงาน
• การจัดการการเข้าถึงอาคาร
• การยืนยันตัวตนในพื้นที่ปลอดภัย
• ระบบการจัดการผู้เยี่ยมชม

การนำไปใช้:

1. ลงทะเบียนใบหน้าพนักงานโดยใช้ /recog/add
2. ใช้ /recog/single สำหรับการจดจำแบบเรียลไทม์ที่จุดทางเข้า
3. กำหนดเกณฑ์การจดจำสูง (0.90+) เพื่อความปลอดภัย
4. บันทึกกิจกรรมการเข้าถึงพร้อมเวลา

2. การยืนยันตัวตน (Identity Verification)

ยืนยันตัวตนผู้ใช้สำหรับกระบวนการ KYC (Know Your Customer):

• การเริ่มต้นใช้งานบริการทางการเงิน
• การยืนยันตัวตนบริการภาครัฐ
• การยืนยันอายุ
• การยืนยันเอกสาร (เปรียบเทียบรูปถ่ายบัตรประจำตัวกับ selfie)

การนำไปใช้:

1. แยกใบหน้าจากเอกสารประจำตัว
2. ถ่าย selfie แบบสด
3. ใช้ endpoint /compare เพื่อจับคู่ใบหน้า
4. ตั้งค่าเกณฑ์การเปรียบเทียบตามความเสี่ยงที่ยอมรับได้
5. จัดเก็บผลการยืนยันเพื่อการตรวจสอบ

3. การจัดระเบียบรูปภาพ (Photo Organization)

จัดระเบียบและติดแท็กรูปภาพโดยอัตโนมัติตามใบหน้า:

• การจัดการคลังรูปภาพส่วนบุคคล
• การจัดหมวดหมู่รูปภาพงานอีเวนต์
• อัลบั้มรูปภาพครอบครัว
• แอปพลิเคชันโซเชียลมีเดีย

การนำไปใช้:

1. ใช้ /detect/multi เพื่อค้นหาใบหน้าทั้งหมดในรูปภาพ
2. ใช้ /recog/multi เพื่อระบุบุคคลที่รู้จัก
3. จัดกลุ่มรูปภาพตามบุคคลที่ตรวจพบ
4. ติดแท็กใบหน้าที่ไม่รู้จักเพื่อการระบุตัวตนด้วยตนเอง

4. การรักษาความปลอดภัยและการเฝ้าระวัง (Security and Surveillance)

เฝ้าติดตามและระบุตัวบุคคลในฟุตเทจการรักษาความปลอดภัย:

• การป้องกันการสูญเสียในร้านค้าปลีก
• การเฝ้าระวังความปลอดภัยสาธารณะ
• การระบุตัวตน VIP
• การคัดกรองบุคคลที่อยู่ในบัญชีดำ

การนำไปใช้:

1. แยกเฟรมจากฟีดวิดีโอ
2. ใช้ /detect/multi เพื่อค้นหาใบหน้า
3. ใช้ /recog/multi เพื่อระบุบุคคลที่น่าสนใจ
4. แจ้งเตือนเมื่อพบการจับคู่ด้วยความมั่นใจสูง
5. จัดเก็บ log การตรวจจับเพื่อการตรวจสอบ

5. ประสบการณ์ลูกค้า (Customer Experience)

ปรับปรุงการบริการลูกค้าด้วยการจดจำใบหน้า:

• การระบุตัวตนลูกค้า VIP
• ประสบการณ์การช็อปปิ้งที่เป็นส่วนตัว
• การผสานรวมโปรแกรมสะสมแต้ม
• การจดจำลูกค้าประจำ

การนำไปใช้:

1. ลงทะเบียนใบหน้าลูกค้าโดยได้รับความยินยอม
2. ใช้ /recog/single เพื่อระบุตัวตนเมื่อเข้าร้าน
3. ดึงข้อมูลความชอบและประวัติลูกค้า
4. ให้บริการที่เป็นส่วนตัว
5. เคารพกฎระเบียบความเป็นส่วนตัวและการคุ้มครองข้อมูล

---

ข้อจำกัดและข้อควรพิจารณา (Limitations and Considerations)

ข้อจำกัดทางเทคนิค (Technical Limitations)

1. ขนาดรูปภาพ (Image Size)

   • ขนาดไฟล์สูงสุด: 2MB
   • ไฟล์ที่เกินขีดจำกัดจะส่งคืนข้อผิดพลาด HTTP 413

2. ขนาดใบหน้า (Face Size)

   • ขนาดใบหน้าขั้นต่ำ: 112x112 พิกเซล
   • ใบหน้าที่เล็กกว่าขั้นต่ำอาจไม่ถูกตรวจจับ

3. มุมใบหน้า (Face Angle)

   • เหมาะที่สุด: มุมมองตรง (±15 องศา)
   • ความแม่นยำลดลงเมื่อมุมเอียงรุนแรง

4. คุณภาพรูปภาพ (Image Quality)

   • รูปภาพคุณภาพต่ำอาจส่งผลให้การตรวจจับล้มเหลว
   • ภาพเบลอจากการเคลื่อนไหวลดความแม่นยำในการจดจำ

5. ขนาดฐานข้อมูล (Database Size)

   • ฐานข้อมูลขนาดใหญ่อาจส่งผลต่อความเร็วในการจดจำ
   • แนะนำให้บำรุงรักษาเป็นประจำ

ข้อควรพิจารณาด้านประสิทธิภาพ (Performance Considerations)

1. เวลาประมวลผล (Processing Time)

   • โดยทั่วไป: 0.3-1.0 วินาทีต่อคำขอ
   • อาจเพิ่มขึ้นเมื่อโหลดเซิร์ฟเวอร์สูง
   • การตรวจจับหลายใบหน้าใช้เวลานานกว่าใบหน้าเดียว

2. ปัจจัยด้านความแม่นยำ (Accuracy Factors)

   • คุณภาพรูปภาพ
   • สภาพแสง
   • มุมใบหน้าและการแสดงออก
   • ความก้าวหน้าของอายุ (Age progression)
   • เครื่องประดับบนใบหน้า

3. ข้อจำกัดอัตรา (Rate Limits)

   • มีข้อจำกัดอัตรา API
   • ระบบคิวจัดการการเข้าชมจำนวนมาก
   • ติดต่อฝ่ายสนับสนุนสำหรับขีดจำกัดที่สูงขึ้น

ความเป็นส่วนตัวและการปฏิบัติตามข้อกำหนด (Privacy and Compliance)

1. การคุ้มครองข้อมูล (Data Protection)

   • ไม่มีการจัดเก็บรูปภาพหลังการประมวลผล
   • คุณลักษณะใบหน้าถูกเข้ารหัสในฐานข้อมูล
   • เป็นไปตาม GDPR และ PDPA
   • ได้รับความยินยอมจากผู้ใช้สำหรับการรวบรวมใบหน้า

2. การใช้งานอย่างมีจริยธรรม (Ethical Use)

   • ใช้เพื่อวัตถุประสงค์ที่ถูกต้องตามกฎหมายเท่านั้น
   • เคารพสิทธิความเป็นส่วนตัว
   • ใช้กลไกการเลือกไม่เข้าร่วม (opt-out)
   • โปร่งใสเกี่ยวกับการใช้งานการจดจำใบหน้า

3. ความปลอดภัย (Security)

   • ปกป้อง API keys
   • ใช้ HTTPS สำหรับทุกคำขอ
   • รักษาความปลอดภัยการเข้าถึงฐานข้อมูลใบหน้า
   • การตรวจสอบความปลอดภัยเป็นประจำ

การปฏิบัติตามกฎระเบียบ (Regulatory Compliance)

1. GDPR (ยุโรป)

   • ข้อมูลไบโอเมตริกถือเป็นข้อมูลประเภทพิเศษ
   • ต้องได้รับความยินยอมอย่างชัดแจ้ง
   • สิทธิ์ในการลบมีผลบังคับใช้
   • ต้องมีการประเมินผลกระทบด้านการคุ้มครองข้อมูล (Data protection impact assessment)

2. PDPA (ไทย)

   • ข้อมูลไบโอเมตริกต้องได้รับความยินยอม
   • แจ้งผู้ถูกควบคุมข้อมูลเกี่ยวกับวัตถุประสงค์
   • ใช้มาตรการรักษาความปลอดภัย
   • อนุญาตสิทธิ์ของผู้ถูกควบคุมข้อมูล

3. กฎระเบียบอื่นๆ (Other Regulations)

   • ตรวจสอบกฎหมายและข้อบังคับท้องถิ่น
   • ขอรับใบอนุญาตที่จำเป็น
   • ใช้มาตรการป้องกันที่จำเป็น
   • จัดทำเอกสารประกอบการปฏิบัติตามข้อกำหนด

---

ความแม่นยำและประสิทธิภาพ (Accuracy & Performance)

ความแม่นยำในการจดจำ (Recognition Accuracy)

• ใบหน้าตรง (Frontal Faces): ความแม่นยำ 98-99%
• ใบหน้าเอียง (±15°): ความแม่นยำ 95-97%
• ใบหน้าเอียง (±30°): ความแม่นยำ 85-90%
• มุมมองด้านข้าง (Profile Views): ความแม่นยำจำกัด (ไม่แนะนำ)

ความเร็วในการประมวลผล (Processing Speed)

• การตรวจจับใบหน้าเดียว (Single Face Detection): 0.2-0.3 วินาที
• การจดจำใบหน้าเดียว (Single Face Recognition): 0.4-0.6 วินาที
• การตรวจจับหลายใบหน้า (Multi-Face Detection): 0.3-0.5 วินาที
• การจดจำหลายใบหน้า (Multi-Face Recognition): 0.5-1.0 วินาที
• การเปรียบเทียบใบหน้า (Face Comparison): 0.4-0.6 วินาที

หมายเหตุ: เวลาเป็นค่าทั่วไป และอาจแตกต่างกันไปขึ้นอยู่กับขนาดรูปภาพ โหลดเซิร์ฟเวอร์ และความหน่วงของเครือข่าย

ปัจจัยที่ส่งผลต่อประสิทธิภาพ (Factors Affecting Performance)

1. คุณภาพรูปภาพ (Image Quality)

   • ความละเอียดสูง = ความแม่นยำดีขึ้น, ประมวลผลนานขึ้น
   • รอยแตกจากการบีบอัดลดความแม่นยำ
   • แสงที่เหมาะสมมีความสำคัญต่อความแม่นยำ

2. ขนาดฐานข้อมูลใบหน้า (Face Database Size)

   • ฐานข้อมูลใหญ่ = เวลาในการจดจำนานขึ้นเล็กน้อย
   • สูงสุด 10,000 ใบหน้า: ผลกระทบเล็กน้อย
   • มากกว่า 10,000 ใบหน้า: พิจารณาการเพิ่มประสิทธิภาพฐานข้อมูล

3. เงื่อนไขเครือข่าย (Network Conditions)

   • เวลาอัปโหลดไฟล์ส่งผลต่อเวลาตอบสนองทั้งหมด
   • ใช้ timeout ที่เหมาะสม
   • ใช้ตรรกะการลองใหม่สำหรับความล้มเหลวของเครือข่าย

4. โหลดเซิร์ฟเวอร์ (Server Load)

   • ชั่วโมงเร่งด่วนอาจมีเวลารอคิวนานขึ้น
   • ระบบคิวรับประกันการประมวลผลที่ยุติธรรม
   • ติดต่อฝ่ายสนับสนุนสำหรับทรัพยากรเฉพาะ

---

ราคา (Pricing)

ราคา API Endpoints (API Endpoints Pricing)

การดำเนินการ	Endpoint	ค่าบริการ IC	หน่วย
การจดจำใบหน้าเดียว	/v3/store/ekyc/face-recognition/single	0.3 IC	ต่อคำขอ
การจดจำหลายใบหน้า	/v3/store/ekyc/face-recognition/multi	0.3 IC	ต่อคำขอ
เพิ่มใบหน้าในฐานข้อมูล	/v3/store/ekyc/face-recognition/add	0.1 IC	ต่อคำขอ
ตรวจสอบฐานข้อมูล	/v3/store/ekyc/face-recognition/check	0.3 IC	ต่อคำขอ
การตรวจจับใบหน้าเดียว	/v3/store/ekyc/face-detection/single	0.3 IC	ต่อคำขอ
การตรวจจับหลายใบหน้า	/v3/store/ekyc/face-detection/multi	0.3 IC	ต่อคำขอ
เปรียบเทียบใบหน้า	/v3/store/ekyc/face-comparison	0.3 IC	ต่อคำขอ
ลบใบหน้า	/v3/store/ekyc/face-recognition/remove	0 IC	ต่อคำขอ
นำเข้าคุณลักษณะ	/v3/store/ekyc/face-recognition/import	0 IC	ต่อคำขอ
ส่งออกคุณลักษณะ	/v3/store/ekyc/face-recognition/export	0 IC	ต่อคำขอ
ตั้งค่าเกณฑ์	/v3/store/ekyc/face-recognition/config	0 IC	ต่อคำขอ
เปลี่ยนรหัสผ่าน	/v3/store/ekyc/face-recognition/password/change	0 IC	ต่อคำขอ

การติดตั้งภายในองค์กร (On-Premise Deployment)

สำหรับการใช้งานปริมาณสูง หรือข้อกำหนดด้านข้อมูลที่ละเอียดอ่อน พิจารณาการติดตั้งภายในองค์กร:

• การเรียกใช้ API ไม่จำกัด
• ไม่มีข้อมูลออกจากโครงสร้างพื้นฐานของคุณ
• การสนับสนุนการผสานรวมแบบกำหนดเอง
• การสนับสนุนทางเทคนิคเฉพาะ
• การตั้งค่าเกณฑ์แบบกำหนดเอง
• การจัดการฐานข้อมูลแบบกำหนดเอง

ติดต่อเรา สำหรับการออกใบอนุญาตและราคาแบบติดตั้งภายในองค์กร

---

การสนับสนุน (Support)

เอกสาร (Documentation)

• อ้างอิง API: เอกสาร endpoint ที่สมบูรณ์ (หน้านี้)
• คู่มือการผสานรวม: คู่มือการผสานรวมตามภาษา
• ตัวอย่างโค้ด: ตัวอย่างโค้ดพร้อมใช้งาน
• แนวทางปฏิบัติที่ดีที่สุด: แนวทางการเพิ่มประสิทธิภาพและความปลอดภัย

การสนับสนุนทางเทคนิค (Technical Support)

• อีเมล: info@iapp.co.th
• เว็บไซต์: https://iapp.co.th
• API Portal: https://iapp.co.th
• ชุมชน Discord: เข้าร่วม Discord ของเรา

สอบถามธุรกิจ (Business Inquiries)

สำหรับโซลูชันระดับองค์กร การผสานรวมแบบกำหนดเอง หรือการติดตั้งภายในองค์กร:

• ฝ่ายขาย: sale@iapp.co.th
• โทรศัพท์: 086-322-5858
• แบบฟอร์มติดต่อ: https://iapp.co.th/contact-us

---

Changelog

เวอร์ชัน 1.3.0 (ปัจจุบัน)

• เพิ่มความแม่นยำในการจดจำหลายใบหน้า
• ปรับปรุงการตรวจจับสำหรับใบหน้าเอียง
• เพิ่ม endpoints ผู้ดูแลระบบสำหรับการจัดการฐานข้อมูล
• ปรับปรุงความเร็วในการประมวลผล
• ปรับปรุงการจัดการข้อผิดพลาดและการรายงาน
• เพิ่มเอกสาร API ที่ครอบคลุม

เวอร์ชัน 1.2.0

• เพิ่ม endpoint การเปรียบเทียบใบหน้า
• ปรับปรุงการกำหนดค่าเกณฑ์การจดจำ
• ปรับปรุงฟังก์ชันการนำเข้า/ส่งออกฐานข้อมูล
• เพิ่มคุณสมบัติการจัดการรหัสผ่าน
• ปรับปรุงประสิทธิภาพ

เวอร์ชัน 1.1.0

• เพิ่มการตรวจจับและจดจำหลายใบหน้า
• แนะนำเกณฑ์คะแนนที่กำหนดค่าได้
• ปรับปรุงข้อความข้อผิดพลาด
• เพิ่มคุณสมบัติการจัดการฐานข้อมูล
• ปรับปรุงประสิทธิภาพ

เวอร์ชัน 1.0.0

• เปิดตัวครั้งแรก
• การจดจำใบหน้าเดียว
• การตรวจจับใบหน้า
• การจัดการฐานข้อมูลพื้นฐาน

---

APIs ที่เกี่ยวข้อง (Related APIs)

• Thai ID Card OCR: ดึงข้อมูลจากบัตรประจำตัวประชาชนไทย
• Face Liveness Detection: ตรวจจับใบหน้าจริงเทียบกับรูปถ่าย
• Document OCR: ดึงข้อความจากเอกสาร
• Passport OCR: ดึงข้อมูลจากหนังสือเดินทาง

---

© 2025 บริษัท ไอแอพพ์เทคโนโลยี จำกัด สงวนลิขสิทธิ์ทุกประการ

API นี้ได้รับการปรับปรุงอย่างต่อเนื่องตามความคิดเห็นของผู้ใช้และการพัฒนาทางเทคโนโลยี กรุณาตรวจสอบการอัปเดตเป็นประจำ