Skip to main content
POST
Face Comparison
L’endpoint de comparaison faciale utilise l’analyse biométrique pour comparer deux images de visage et renvoie un score de confiance indiquant si elles représentent le même individu. Utilisez-le pour la vérification d’identité lors de l’intégration ou de l’approbation de transaction. Avant de comparer, le fournisseur exécute une vérification anti-spoofing sur selfie_url ; si cette vérification échoue, aucune comparaison n’est tentée et la réponse l’indique explicitement — voir 200 OK — rejeté par la vérification anti-spoofing ci-dessous.

Endpoint

Requête

En-têtes

Paramètres de corps

Exemple

Réponse

200 OK

Un data.status à false indique que les visages ne correspondent pas. Utilisez data.confidence pour appliquer votre propre seuil d’acceptation (ex: exigez >= 80 pour une correspondance positive).

200 OK — rejeté par la vérification anti-spoofing (aucune comparaison effectuée)

Avant de comparer les deux images, le fournisseur exécute sa propre vérification anti-spoofing sur selfie_url — cela détecte une photo de photo, une relecture d’écran ou toute autre soumission falsifiée. Si selfie_url échoue à cette vérification, la comparaison elle-même ne s’exécute jamais, et la réponse explique pourquoi dans data.message plutôt que de simplement dire que les visages ne correspondent pas. data.confidence est à 0 dans ce cas puisqu’aucun score de correspondance n’a été produit.
Cette vérification s’exécute même si selfie_url est une image fixe, et non une vidéo — le texte du message ci-dessous fait toujours référence à “la vidéo soumise” car il est partagé avec le libellé interne de l’endpoint de vérification de vivacité faciale. Traitez cette réponse de la même manière, que vous ayez soumis une photo ou une vidéo en tant que selfie.
Demandez à l’utilisateur un selfie plus clair (meilleur éclairage, pas d’écran/photo dans le cadre) et soumettez à nouveau — ce n’est pas la même erreur qu’une véritable inadéquation faciale, et réessayer avec un selfie de meilleure qualité de la même personne est la bonne étape suivante.

400 Bad Request

Renvoyé lorsque l’une ou les deux URL d’image sont manquantes, inaccessibles ou ne contiennent pas de visage détectable.

401 Unauthorized

Autorisations

x-access-token
string
header
requis

Your Adhere API secret key

Corps

application/json
image_url
string
requis

URL of the reference ID photo

selfie_url
string
requis

URL of the selfie image

Réponse

Comparison ran to completion. This includes the anti-spoofing rejection case below — the provider still returns HTTP 200 with status "failed" when selfie_url fails its own liveness check before any comparison is attempted.