Xóa khuôn mặt

Gỡ các khuôn mặt đã lập chỉ mục khỏi một collection theo image ID của chúng. Dùng nó để đáp ứng các yêu cầu xóa dữ liệu và để hoàn tác một lần đăng ký nhầm.

Endpoint

POST /v1/delete_faces
Content-Type: application/json

{
  "image_ids": ["image_id_1", "image_id_2"],
  "collection": "default"
}

Tham số:

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
image_ids	string[]	Có	—	Các image ID trong DB. Phải là những ảnh đã được lập chỉ mục trước đó.
collection	string	Không	collection mặc định	Collection để gỡ các khuôn mặt khỏi đó.

Ví dụ request

curl -X POST \
  '<BASE_URL>/v1/delete_faces' \
  -H 'Authorization: ATV <ACCESS_ID>:<SIGNATURE>' \
  -H 'X-TV-Timestamp: <TIMESTAMP>' \
  -H 'Content-Type: application/json' \
  -d '{
    "image_ids": [
      "image_id_1",
      "image_id_2"
    ]
  }'

Response

{
  "data": {
    "request_id": "80f2d57d-1277-4f6a-b075-451639e9b349"
  },
  "errors": []
}

Trường	Kiểu	Mô tả
data.request_id	string	Request ID; cung cấp cho CAKE Support khi cần kiểm tra log.
errors	array	Chi tiết từng lỗi. Rỗng khi thành công.

WARNING

Việc xóa là không thể hoàn tác và gỡ khuôn mặt khỏi chỉ mục tìm kiếm — bất kỳ ai bị xóa sẽ không còn được tìm thấy bởi Tìm kiếm khuôn mặt, nên các kiểm tra trùng lặp và blocklist sẽ ngừng gắn cờ họ. Hãy xác nhận các image ID trước khi gọi.

Lỗi

Mã	Thông báo
2001010	Không tìm thấy Access ID.
401100	Bạn không được phép thực hiện hành động này.
4001000	Tham số đầu vào vi phạm một ràng buộc.
4001001	Header X-TV-Timestamp đã hết hạn, cần một cái mới hơn.
5001000	Xảy ra lỗi không mong đợi trong quá trình xử lý request.

Mã	Mô tả
access_denied_exception	Bạn không được phép thực hiện hành động này.
invalid_parameter_exception	Tham số đầu vào vi phạm một ràng buộc.
request_time_too_skewed	Header X-TV-Timestamp đã hết hạn, cần một cái mới hơn.
image_not_found_exception	Không tìm thấy image ID trong DB.
request_timeout_exception	Request mất quá nhiều thời gian để xử lý.
rate_limit_exception	Số lượng request vượt quá giới hạn throughput của bạn.
internal_server_error	Xảy ra lỗi không mong đợi trong quá trình xử lý request.

Bước tiếp theo

• Lập chỉ mục khuôn mặt — đăng ký lại một khuôn mặt sau khi xóa
• Tổng quan eKYC — toàn bộ bề mặt API