Base URL: https://endpoint.edctech.online/api/v1

Định dạng: JSON

Xác thực: Bearer Token (Header Authorization: Bearer <Token>)

1. Quy định chung

• Tất cả yêu cầu phải qua giao thức HTTPS.
• Header bắt buộc: Accept: application/json.
• Token sẽ được cấp riêng cho từng đối tác.

2. Các Endpoints Chi Tiết

2.1. Lấy danh sách toàn bộ ảnh

Truy xuất tất cả dữ liệu ảnh có trong kho album chung.

• Method: GET
• Path: /photos

Phản hồi mẫu (200 OK) - Có kết quả trả về:

{
  "statuscode": 200,
  "success": true,
  "total": 1250,
  "message": "Thành công",
  "data": [
	{
	  "id": 54,
	  "taskId": "c9de4cda-02a5-427c-ab62-1176b2ee8bfd",
	  "thumbnail": "thumb_3092_2392_dsc05475_copy.jpg",
	  "image": "3092_2392_dsc05475_copy.jpg",
	  "tags": null,
	  "createDate": "2026-05-06T10:57:33.587",
	  "linkThumbnail": "https://endpoint.edctech.online/images/gallery/c9de4cda-02a5-427c-ab62-1176b2ee8bfd/thumb_3092_2392_dsc05475_copy.jpg",
	  "linkImage": "https://endpoint.edctech.online/images/gallery/c9de4cda-02a5-427c-ab62-1176b2ee8bfd/3092_2392_dsc05475_copy.jpg"
	},
  ]
}

Phản hồi mẫu (200 OK) - Không tìm thấy kết quả trả về:

{
  "statuscode": 200,
  "success": true,
  "total": 0,
  "message": "Không tìm thấy ảnh",
  "data": null
}

2.2. Tìm kiếm ảnh bằng nhận diện khuôn mặt

Gửi ảnh chân dung để lọc danh sách các ảnh có mặt khách hàng trong album.

• Method: POST
• Path: /facesearch
• Content-Type: multipart/form-data

Tham số: image (File: .jpg, .png)

Phản hồi mẫu (200 OK) - Có kết quả trả về:

{
  "statuscode": 200,
  "success": true,
  "match_count": 5,
  "code": "35735357-4f1d-470e-bfed-87c01f9d666b",
  "message": "Thành công",
  "data": [
	{
	  "id": 54,
	  "taskId": "c9de4cda-02a5-427c-ab62-1176b2ee8bfd",
	  "thumbnail": "thumb_3092_2392_dsc05475_copy.jpg",
	  "image": "3092_2392_dsc05475_copy.jpg",
	  "tags": null,
	  "createDate": "2026-05-06T10:57:33.587",
	  "linkThumbnail": "https://endpoint.edctech.online/images/gallery/c9de4cda-02a5-427c-ab62-1176b2ee8bfd/thumb_3092_2392_dsc05475_copy.jpg",
	  "linkImage": "https://endpoint.edctech.online/images/gallery/c9de4cda-02a5-427c-ab62-1176b2ee8bfd/3092_2392_dsc05475_copy.jpg"
	},
  ]
}

Phản hồi mẫu (200 OK) - Không tìm thấy kết quả trả về:

{
  "statuscode": 200,
  "success": true,
  "match_count": 0,
  "code": "",
  "message": "Không có kết quả",
  "data": null
}

2.3. Tìm kiếm ảnh theo code

Sau khi tìm ảnh bằng search face sẽ có 1 code (Code này dùng để lưu trữ kết quả của face đó).

Tìm ảnh bằng code sẽ không cần file ảnh chân dung.

• Method: GET
• Path: /search?q={keyword}

Phản hồi mẫu (200 OK) - Có kết quả trả về:

{
  "statuscode": 200,
  "success": true,
  "match_count": 5,
  "code": "35735357-4f1d-470e-bfed-87c01f9d666b",
  "message": "Thành công",
  "data": [
	{
	  "id": 54,
	  "taskId": "c9de4cda-02a5-427c-ab62-1176b2ee8bfd",
	  "thumbnail": "thumb_3092_2392_dsc05475_copy.jpg",
	  "image": "3092_2392_dsc05475_copy.jpg",
	  "tags": null,
	  "createDate": "2026-05-06T10:57:33.587",
	  "linkThumbnail": "https://endpoint.edctech.online/images/gallery/c9de4cda-02a5-427c-ab62-1176b2ee8bfd/thumb_3092_2392_dsc05475_copy.jpg",
	  "linkImage": "https://endpoint.edctech.online/images/gallery/c9de4cda-02a5-427c-ab62-1176b2ee8bfd/3092_2392_dsc05475_copy.jpg"
	},
  ]
}

Phản hồi mẫu (200 OK) - Không tìm thấy kết quả trả về:

{
  "statuscode": 200,
  "success": true,
  "match_count": 0,
  "code": "",
  "message": "Không tìm thấy ảnh",
  "data": null
}

3. Mã lỗi hệ thống

Mã lỗi	Diễn giải	Giải pháp
400	Unauthorized	Kiểm tra lại Token trong Header
401	Bad Request	File ảnh không đúng định dạng hoặc quá lớn
500	Not Found	Vui lòng liên hệ kỹ thuật EDC Tech để được hỗ trợ kiểm tra