Passer au contenu principal
POST
Document Verification — Global Passport
Vérifiez le passeport d’un client, quel que soit son pays, en envoyant une photo de la page de données. Nous lisons les informations, confirmons le pays qui a délivré le passeport et comparons le visage du passeport avec un selfie.
Le passeport n’a qu’une face. Seul document_front est nécessaire.
country est facultatif. Envoyez-le lorsque vous connaissez le pays qui a délivré le passeport. Sans lui, nous détectons le pays à partir du passeport.

Endpoint

Requête

En-têtes

Paramètres de corps

Un document numérisé peut être envoyé sous forme de PDF d’une page, par exemple -F "document_front=@/path/to/scan.pdf".

Exemple

Réponse

200 OK

Comparaison faciale : verified: false avec decision: "NO_MATCH" signifie que la comparaison a eu lieu et que les visages ne correspondent pas. verified: null avec un reason signifie que la comparaison n’a pas pu avoir lieu, par exemple parce qu’aucun visage n’a été trouvé sur le selfie. Un problème de comparaison faciale ne bloque jamais les données du passeport : le reste de data est tout de même renvoyé.

400 Bad Request

Le passeport n’a pas été délivré par le country envoyé :
Les passeports de ce pays ne peuvent pas être vérifiés :
La photo ne peut pas être lue, par exemple parce qu’une partie du passeport est coupée :

Passeports expirés

Un passeport expiré fait échouer la vérification. Les informations lues sont tout de même renvoyées dans data, avec is_expired: true :

401 Unauthorized

Pour la liste complète des codes d’erreur, consultez la référence Codes d’erreur.

Autorisations

x-access-token
string
header
requis

Your Adhere API secret key

Corps

multipart/form-data
document_front
file
requis

Photo or scan of the passport data page. JPG, PNG or single-page PDF, max 10MB.

selfie_image
file
requis

A selfie to compare against the face on the passport. JPG or PNG, max 5MB.

country
string

Optional. The country that issued the passport, as an two-letter country code. Leave it out to have it detected.

Exemple:

"RW"

Réponse

Document details extracted successfully

status
string
Exemple:

"success"

data
object
message
string
Exemple:

"Document details retrieved successfully"