🪪 Scanner Documents — API

Emulador QA del escáner ICAR IDBox: OCR del MRZ (ICAO 9303 TD1/TD3), validación de dígitos de control y letra DNI/NIE, e imágenes normalizadas como data:image/jpeg;base64,… (el formato bytea de la plataforma). Solo especímenes / QA, sin validez legal.

POST /api/scan

Body JSON con una o dos imágenes (data URI o base64 a pelo):

{ "front": "data:image/jpeg;base64,...", "rear": "data:image/jpeg;base64,..." }
curl -s https://scanner.suils.es/api/scan \
  -H 'content-type: application/json' \
  -d "{\"rear\": \"$(base64 -w0 reverso.jpg)\"}" | jq .fields

Respuesta:

oktrue si se localizó y parseó un MRZ
document_type_id / document_typecatálogo CAM: 1 DNI · 2 Pasaporte · 3 Doc. EU · 5 NIE · 6 Permiso Residencia
fieldsdocument_number, support_number, name, surname_1/2, birth_date, expiration_date, sex, nationality, issuer
mrzformat TD1|TD3, lines, raw, checks por campo, valid, score
validationcheck_digits_ok, letter_ok (DNI/NIE mod-23), expired, age, adult
imagesfront/rear a 900px + *_preview a 320px, data URIs JPEG
deviceidentificación del IDBox (W375) emulado

GET /healthz

Liveness. curl https://scanner.suils.es/healthz

Consejos de captura

El MRZ está en el reverso del DNI/NIE (3 líneas × 30) y en la página de datos del pasaporte (2 líneas × 44). Documento entero en el encuadre, horizontal, sin brillos. Prueba con los especímenes de documents.suils.es (mismo MRZ válido que generaría el documento real).

← volver al scanner