Xóa Face Authen

Hủy đăng ký hồ sơ (profile) khuôn mặt của một người dùng, xóa template đã đăng ký khỏi hệ thố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.

Việc xóa hồ sơ không thu hồi (revoke) các khóa ký (signing credential): chúng thuộc về thiết bị, không thuộc về người dùng. Nếu cần, hãy thu hồi các khóa của một thiết bị bằng Thu hồi khóa ký.

Endpoint

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

{
  "user_id": "user_00000001"
}

Tham số:

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
user_id	string	Có	—	User ID đã đăng ký của khách hàng.

Trả về: DeleteFaceAuthResponse

Ví dụ request

curl -X POST \
  '<BASE_URL>/v1/delete_face_auth' \
  -H 'Authorization: ATV <ACCESS_ID>:<SIGNATURE>' \
  -H 'X-TV-Timestamp: <TIMESTAMP>' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_id": "user_00000001"
  }'

Response

{
  "data": {
    "request_id": "d4493ff5-e41f-4d10-a291-6a9727050b4c",
    "status": "success"
  },
  "errors": [],
  "success": true,
  "code": 0,
  "message": "Success"
}

Trường	Kiểu	Mô tả
data.request_id	string	ID của request (UUID).
data.status	string	Trạng thái của response — success hoặc failure.

WARNING

Việc xóa là không thể hoàn tác và ngay lập tức làm gián đoạn xác thực cho người dùng đó — mọi lần gọi Xác minh Face Authen tiếp theo sẽ thất bại cho đến khi họ đăng ký lại. Hãy xác nhận user_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.
4041000	Không tìm thấy image ID trong DB.
4041002	Không tìm thấy hồ sơ của người dùng.
4291000	Số lượng request vượt quá giới hạn throughput của bạ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.
user_profile_not_found_exception	Không tìm thấy hồ sơ của người dùng.
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

• Đăng ký khuôn mặt — đăng ký lại một người dùng sau khi xóa
• Tổng quan FaceAuthen — toàn bộ vòng đời hồ sơ