Kişi ara

Benzerliğe göre kayıtlı kişilerde aramak için yüz görüntüleri yükleyin (1:N).

menu_bookAPI referansı: Yüz araması (1:N)expand_more

Resmi belgeler: docs.verifik.co/biometrics/search (Yüz araması — kayıtlı kişilere yüz görüntüsüyle arama).

Temel URL https://api.verifik.co. images içinde aynı konunun bir veya daha fazla ham base64 görüntüsünü gönderin (data URL öneki yok). İsteğe bağlı olarak collection_id ile kapsamı sınırlayın. Genel belgeler daha iyi geri çağırma için 1–3 görüntü önerir.

POST /v2/face-recognition/search

1:N tanımlama: aday kişileri benzerlik skoruna göre sıralı döndürür.

Başlık	Değer
Content-Type	application/json
Authorization	Bearer <token>

Param	Zorunlu	Açıklama
images	Evet	Base64 yüz görüntüleri dizisi (aynı kişi; ~3’e kadar önerilir)
min_score	Evet	Eşleşme eşiği (ör. 0,2–1,0)
search_mode	Evet	FAST veya ACCURATE
collection_id	Hayır	Aramayı tek koleksiyonla sınırla
max_results	Hayır	Döndürülen eşleşmelerin üst sınırı (atlanırsa API varsayılanı geçerli)

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",
  }),
});

Bu demo, oturum belirtecinizle @humanauthn/api-client içindeki searchPerson kullanır.
Yanıtlar tipik olarak sıralı eşleşmeler içerir ve ortama bağlı olarak imza bloğu içerebilir.

menu_book

docs.verifik.co üzerindeki resmi kılavuzlar

Nesne

Kişi nesnesi

Yüz tanıma kişi kaydının alanları ve yapısı.

GET

Tüm kişileri listele

İsteğe bağlı filtrelerle istemciniz için kişiler.

GET

Kişi getir

Kimliğe göre tek kişi.

PUT