Tìm người

Tìm kiếm người

Tải hình ảnh khuôn mặt lên để tìm kiếm những người đã đăng ký theo độ tương tự (1:N).

menu_bookTham chiếu API: Tìm kiếm khuôn mặt (1:N)expand_more

Tài liệu chính thức: docs.verifik.co/biometrics/search (Tìm kiếm khuôn mặt - tìm kiếm bằng hình ảnh khuôn mặt đối với những người đã đăng ký).

URL cơ sở https://api.verifik.co. Gửi một hoặc nhiều hình ảnh base64 thô của cùng một chủ đề trong hình ảnh (không có tiền tố dữ liệu URL). Tùy chọn giới hạn theo Collection_id. Tài liệu công khai gợi ý 1–3 hình ảnh để nhớ lại tốt hơn.

POST /v2/face-recognition/search

Nhận dạng 1:N: trả về những ứng viên được xếp hạng theo điểm tương đồng.

tiêu đề	Giá trị
Content-Type	application/json
Authorization	Bearer <token>

Thông số	yêu cầu	Sự miêu tả
images	Đúng	Mảng hình ảnh khuôn mặt base64 (cùng một người; đề xuất tối đa ~3)
min_score	Đúng	Ngưỡng phù hợp (ví dụ: 0,2–1,0)
search_mode	Đúng	FAST hoặc ACCURATE
collection_id	KHÔNG	Giới hạn tìm kiếm trong một bộ sưu tập
max_results	KHÔNG	Giới hạn số kết quả khớp được trả về (áp dụng mặc định API nếu bị bỏ qua)

await fetch("https://api.verifik.co/v2/face-recognition/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    images: ["<base64>", "<base64>"],
    collection_id: "<optionalCollectionMongoId>",
    min_score: 0.75,
    search_mode: "FAST",
  }),
});

Bản demo này sử dụng searchPerson từ @humanauthn/api-client với mã thông báo phiên của bạn.
Phản hồi thường bao gồm các trận đấu được xếp hạng và có thể bao gồm khối chữ ký tùy thuộc vào môi trường.

menu_book

Hướng dẫn chính thức trên docs.verifik.co

Object

Đối tượng Người

Các trường và cấu trúc của hồ sơ người nhận dạng khuôn mặt.

GET

Liệt kê tất cả những người

Người dành cho khách hàng của bạn, với các bộ lọc tùy chọn.

GET

Truy xuất một người

Một người duy nhất theo id.

PUT