Extracción de datos desde web
/extractDocumentDataWeb
Este servicio devuelve todos los datos extraídos de un documento de identificación aplicando OCR al código MRZ, PDF, código de barras y campos visibles en otras áreas del documento según el modelo definido para cada país. Para pasaportes, el OCR se aplica exclusivamente al código MRZ debido a su formato estandarizado.
Integración Este servicio se utiliza para implementaciones del widget web SelphID o para enviar imágenes abiertas desde cualquier plataforma. Cuando se utiliza el widget web SelphID, las imágenes generadas por el widget se recuperan de un array de imágenes.
Precaución
Para casos de pasaporte, solo se requiere tokenFrontDocument con countryCode establecido como "PSP".
Solicitud:
bash
curl --location '{IDENTITY_API_BASE_URL}/services/extractDocumentDataWeb' \
--header 'x-api-key: {API_KEY}' \
--header 'Content-Type: application/json' \
--data '{
"tokenFrontDocument": "{TOKEN_FRONT_DOCUMENT}",
"tokenBackDocument": "{TOKEN_BACK_DOCUMENT}",
"countryCode": "{COUNTRY_CODE}",
"decompose": false,
"tracking": {
"extraData": "{EXTRA_DATA}",
"operationId": "{OPERATION_ID}"
}
}'Parámetros de la solicitud:
Parámetro
Tipo (Contenido)
Requerido
Descripción
tokenFrontDocument
String (Base64)
Sí
Imagen codificada en Base64 del anverso del documento, eliminando la cabecera del tipo MIME.
tokenBackDocument
String (Base64)
Sí
Imagen codificada en Base64 del reverso del documento, eliminando la cabecera del tipo MIME.
countryCode
String
Sí
Código de país en formato ISO 3166-1 alpha-3. Si no está presente en el cuerpo de la solicitud, el servicio utilizará el país predeterminado definido para el cliente en la configuración de la API.
decompose
Boolean
No
Indica si se debe obtener la imagen del rostro presente en el documento y el recorte de la firma. (*) Consultar con el equipo de Soporte Latam para los países habilitados.
tracking
Objeto JSON
No
Objeto que representa la información de seguimiento necesaria.
extraData
String (Base64)
No
Token generado por el SDK móvil/web. Contiene información de seguimiento tokenizada con la Plataforma.
operationId
String (Base64)
No
Identificador de operación generado por el SDK móvil/web.
Ejemplo de respuesta:
json
Campos de la respuesta:
Identificador
Tipo
Descripción
serviceResultCode
Integer
Código que indica el resultado general de la ejecución del servicio. Ver Tabla 1 - Código de Resultado del Servicio.
serviceResultLog
String
Campo descriptivo del resultado de la ejecución del servicio. Se incluyen detalles del módulo en caso de error o excepción.
serviceDocument
JSON
Objeto que representa el documento capturado. Sus propiedades son todos los campos extraídos por el proceso OCR, incluida la imagen del rostro presente en el documento.
serviceTime
String
Tiempo total de ejecución del servicio (milisegundos).
serviceTransactionId
String
Identificador de transacción asociado a la solicitud procesada por la API.
Last updated