ðĪð āļĢāļ°āļāļāļāļāļāļģāđāļĨāļ°āļāļĢāļ§āļāļāļąāļāđāļāļŦāļāđāļē API
āļ āļēāļāļĢāļ§āļĄâ
iApp Face Recognition API āļāļ·āļāđāļāļĨāļđāļāļąāļāļāļēāļĢāļāļāļāļģāđāļāļŦāļāđāļēāļāļĩāđāļāļĢāļāļāļāļĨāļļāļĄ āđāļŦāđāļāļ§āļēāļĄāļŠāļēāļĄāļēāļĢāļāđāļāļāļēāļĢāļāļĢāļ§āļāļāļąāļ āļāļāļāļģ āđāļāļĢāļĩāļĒāļāđāļāļĩāļĒāļāđāļāļŦāļāđāļē āđāļĨāļ°āļāļąāļāļāļēāļĢāļāļēāļāļāđāļāļĄāļđāļĨ āļŠāļĢāđāļēāļāļāļķāđāļāļāļāđāļĄāđāļāļĨ Deep Learning āļāļĩāđāļāļąāļāļŠāļĄāļąāļĒ API āļāļāļāđāļĢāļēāļĄāļāļāļāļ§āļēāļĄāđāļĄāđāļāļĒāļģāļŠāļđāļāđāļĨāļ°āļāļēāļĢāļāļĢāļ°āļĄāļ§āļĨāļāļĨāļāļĩāđāļĢāļ§āļāđāļĢāđāļ§āļŠāļģāļŦāļĢāļąāļāļāļēāļĢāđāļāđāļāļēāļāļāļĩāđāļŦāļĨāļēāļāļŦāļĨāļēāļĒ āļĢāļ§āļĄāļāļķāļāļāļēāļĢāļĢāļąāļāļĐāļēāļāļ§āļēāļĄāļāļĨāļāļāļ āļąāļĒ āļāļēāļĢāļĒāļ·āļāļĒāļąāļāļāļąāļ§āļāļ āđāļĨāļ°āļāļēāļĢāļāļĢāļ§āļāļŠāļāļāļāļļāļāļāļĨ
āļāļāļĨāļāļāđāļāđ Demo!â
āļāļāļĨāļāļāđāļāđ AI Demo
āđāļāđāļēāļŠāļđāđāļĢāļ°āļāļāļŦāļĢāļ·āļāļŠāļĢāđāļēāļāļāļąāļāļāļĩāļāļĢāļĩāđāļāļ·āđāļāđāļāđāļāļēāļ AI Demo āđāļĨāļ°āļŠāļģāļĢāļ§āļ API āļāļĩāđāļāļĢāļāļāļĨāļąāļāļāļāļāđāļĢāļē
āļĢāļąāļ 50 āđāļāļĢāļāļīāļāļāļĢāļĩ (IC) āđāļĄāļ·āđāļāļŠāļĄāļąāļāļĢāļŠāļĄāļēāļāļī āļ!
āđāļāļĢāđāļĄāļāļąāļāļŦāļĄāļāđāļāļ 31 āļāļąāļāļ§āļēāļāļĄ 2568
Face Recognition API Demo
Test our face recognition endpoints with real-time results
Endpoint changes based on selected tab
Recognizes the most prominent face in an image and matches it against your company's face database.
āļāļļāļāļŠāļĄāļāļąāļāļīāļŦāļĨāļąāļâ
āļāļ§āļēāļĄāļŠāļēāļĄāļēāļĢāļāļŦāļĨāļąāļâ
- āļāļēāļĢāļāļĢāļ§āļāļāļąāļāđāļāļŦāļāđāļē (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 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 "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