Skip to main content
POST
Document Verification — Nigeria National ID
Vérifiez le slip ou la carte du Numéro National d’Identification d’un client nigérian en téléversant une photo — aucune saisie manuelle du NIN requise. Extraction OCR plus une concordance faciale requise par rapport à un selfie — pas de vérification de vivacité (pas de vidéo, pas de défi de clignement/mouvement).
Il s’agit d’un document recto-verso — fournissez à la fois document_front et document_back pour l’extraction la plus complète.
selfie_image est requis — le visage extrait du document est comparé à celui-ci. Il s’agit d’une comparaison d’image fixe (pas de vivacité).

Endpoint

Requête

En-têtes

Paramètres de corps

document_type et country ne sont pas nécessaires — cet endpoint est déjà délimité au National ID nigérian.

Exemple

Réponse

200 OK

Champs additionnels — le nouveau slip/carte NIN unilatéral n’a pas d’autres champs au-delà de ceux listés ci-dessus. L’ancienne carte recto-verso imprime plus (occupation, state, lga, ward, height, blood_group, plus plusieurs champs du verso) — ils reviennent dans extra_fields lorsqu’ils sont présents, et sont simplement absents pour le nouveau format plutôt qu’envoyés comme null.
Notes de concordance faciale — si le service de comparaison lui-même échoue, attempted reflète si une comparaison a réellement été exécutée et verified revient null avec un champ reason expliquant pourquoi — c’est différent de verified: false, qui signifie que la comparaison a été exécutée et que les visages ne correspondaient pas. Un problème de concordance faciale ne bloque jamais les données du document sous-jacent — le reste de data est toujours renvoyé.

400 Bad Request

Renvoyé pour une entrée invalide, ou lorsque le document échoue aux propres contrôles de qualité de l’OCR (flou, mauvais type de document, reflet, etc.).

401 Unauthorized

Pour une 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

Front of the NIN slip/card. JPG or PNG, max 5MB.

document_back
file

Back of the card. Optional, but recommended — extraction may be less complete without it.

selfie_image
file

A selfie to compare against the face extracted from the document. JPG or PNG, max 5MB. Required.

Réponse

Document details extracted successfully

status
string
Exemple:

"success"

data
object
message
string
Exemple:

"Document details retrieved successfully"