Skip to main content
POST
Face Liveness Check
L’endpoint de vérification de vivacité faciale analyse un selfie soumis — recommandé sous forme de courte vidéo, bien qu’une photo unique soit également acceptée — pour confirmer qu’il montre une personne vivante, et non une relecture falsifiée (une photo d’une photo, un enregistrement d’écran, etc.). Il note directement la vivacité ; il ne compare pas la soumission à une autre image. Une vidéo et une photo fixe sont toutes deux authentiquement notées pour la vivacité, donc une image fixe fonctionne également — mais une courte vidéo est la soumission recommandée, car le mouvement donne plus d’informations à la vérification de vivacité. L’endpoint détecte ce qui a été soumis à partir du fichier lui-même.

Endpoint

Requête

En-têtes

Paramètres de corps

Exemple

Réponse

Le statut HTTP est 200 chaque fois que la vérification s’est déroulée jusqu’au bout, indépendamment du fait que la vivacité ait été validée ou non — une tentative de vivacité échouée est un résultat de vérification normal et réussi, pas une erreur. Lisez status/data.status dans le corps pour obtenir le verdict réel ; un 400 signifie que la requête elle-même n’a pas pu être traitée (champ manquant, fichier illisible, problème d’authentification), pas que la vivacité a échoué.

200 OK — vivacité validée

200 OK — vivacité échouée (toujours une vérification réussie)

400 Bad Request

Renvoyé lorsque la requête elle-même n’a pas pu être traitée — un champ live_media manquant, une URL inaccessible/illisible, ou une erreur inattendue de la vérification sous-jacente.

401 Unauthorized

Autorisations

x-access-token
string
header
requis

Your Adhere API secret key

Corps

application/json
live_media
string
requis

URL of the short selfie video to check for liveness (recommended — supported formats .mp4, .mov, .webm, .avi, .m4v). A still selfie photo is also accepted — anything that isn't one of those video formats is treated as a still image. Both a video and a still photo are genuinely scored for liveness; the endpoint detects which was submitted from the file itself.

Réponse

Liveness check ran to completion. Returned for both a pass and a fail — a failed liveness attempt is a normal, successful check outcome, not an error. Read data.status / data.liveness_passed for the real verdict.