Mở khóa hồ sơ

Gỡ lệnh khóa trên một hồ sơ (profile) khuôn mặt sau các lần xác thực thất bại liên tiếp. Một hồ sơ bị khóa sẽ từ chối mọi lần thử với 2002206 User profile is locked cho đến khi endpoint này được gọi.

Endpoint

http

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

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 của khách hàng.

Trả về: UnlockProfileResponse

Khi nào một hồ sơ bị khóa

Xác minh Face Authen áp dụng hai giới hạn. Vượt quá giới hạn brute-force sẽ khóa hồ sơ:

Trường	Kiểu	Mô tả
`face_auth_rate_limit_exceeded`	`2001016`	Quá nhiều lần thử trong khung thời gian. Tạm thời — người dùng có thể thử lại sau.
`face_auth_brute_force_limit_exceeded`	`2001017`	Quá nhiều lần thử thất bại. Hồ sơ bị khóa.
`user_profile_locked`	`2002206`	Được trả về ở mọi lệnh gọi tiếp theo cho đến khi được mở khóa.

Một lần khóa cũng chặn Tạo giao dịch, nên một người dùng bị khóa thậm chí không thể bắt đầu một lần xác thực mới.

Ví dụ request

bash

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

Response

json

{
  "data": {
    "status": "success",
    "request_id": "cfc7b8d5-f2e2-437b-80e5-d600dfad26e2"
  },
  "errors": [],
  "success": true,
  "code": 0,
  "message": "Success"
}

Trường	Kiểu	Mô tả
`data.status`	string	`success` hoặc `failure`.
`data.request_id`	string	Request ID; cung cấp cho CAKE Support khi cần kiểm tra log.

WARNING

Lệnh khóa là một biện pháp chống brute-force, nên việc mở khóa gỡ bỏ một lớp phòng vệ gian lận. Hãy yêu cầu một bước kiểm tra định danh độc lập — một cuộc gọi hỗ trợ xác nhận lại hoặc một yếu tố xác thực riêng biệt — trước khi gọi endpoint này, và ghi lại ai đã cho phép mỗi lần mở khóa.

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.
`4041001`	Không tìm thấy người dùng.
`5001000`	Xảy ra lỗi không mong đợi trong quá trình xử lý request.

Mã	Mô tả
`access_id_not_found`	Không tìm thấy Access ID.
`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.
`user_not_found_exception`	Không tìm thấy người dùng.
`internal_server_error`	Xảy ra lỗi không mong đợi trong quá trình xử lý request.

Bước tiếp theo

Xác minh Face Authen — thử lại xác thực sau khi đã mở khóa
Tổng quan FaceAuthen — toàn bộ vòng đời hồ sơ

Mở khóa hồ sơ ​

Endpoint ​

Khi nào một hồ sơ bị khóa ​

Ví dụ request ​

Response ​

Lỗi ​