Detalle de la API

Para poder utilizar esta API se debe realizar una llamada con un método GET conformándose por:

• Endpoint: https://cont1-virtual1.certisend.com/web/container/api/v1/validations/identity/ar/dni/validate_dni

Parámetros:

• token-susc: Token obtenido al momento de la suscripción a nivel empresa.
• token-api: Token obtenido al momento de la suscripción a nivel API.
• document: Número de documento sin puntos. (Obligatorio)
• docfront: Imagen del DNI del lado del frente. 
• docback: Imagen del DNI del lado del dorso.
• internalid: Parámetro opcional en donde se puede enviar un id interno para su identificación por parte del cliente.

La llamada quedaría de la siguiente manera:
https://cont1-virtual1.certisend.com/web/container/api/v1/validations/identity/ar/dni/validate_dni?token-susc=TOKENSUSC&token-api=TOKENAPI&document=35375478&docfront=35375478&docback=DOCBACK&internalid=82

Una vez realizada la llamada van a recibir los siguientes parámetros:

• state: Tendrá el valor 0 para un parámetro faltante y un 1 en el caso de que se encuentre información.
• desc: Descripción del parámetro "state" recibido.
• id_internal: ID interno ingresado por el cliente.
• valid_doc: Determina la validez del documento en donde "true" indica la validez del mismo y "false" una diferencia entre los datos obtenidos de la lectura del OCR y el código PDF147.
• valid_ocr: Determina si la lectura de la información contenida en las imágenes es legible y correcta.
• img_front: Ruta temporal de la imagen del frente del DNI.
• img_back: Ruta temporal de la imagen del dorso del DNI.
• ocr: Contiene un conjunto de datos con las validaciones realizadas sobre los textos encontrados en las imágenes.
• valid_pdf147: Determina si el código PDF147 es legible, en donde contendrá el valor "true" si se pudo realizar y "false" si no pudo ser determinado.
• pdf147: Conjunto de datos donde se encuentra la información almacenada en el código PDF147.

Respuestas de Ejemplo:

Negativa:

{ "state": "0", "desc": "invalid doc image back.",  "id_internal": "" }

Positiva:

{"state":"1","valid_doc":"true","valid_ocr":"true","img_front":"https://cont1-virtual1.certisend.com/web/container/api/v1/validations/identity/ar/dni/tmp/coinag_test/95882391_1c2926ad6c4644da0de92cd60b4e0c708.jpeg","img_back":"https://cont1-virtual1.certisend.com/web/container/api/v1/validations/identity/ar/dni/tmp/coinag_test/95882391_25cbee14f2cece29dd54ded74db29a76e.jpeg","ocr":[{"language":"es","textAngle":0.0,"orientation":"Up","regions":[{"boundingBox":"400,64,819,553","lines":[{"boundingBox":"401,64,416,18","words":[{"boundingBox":"401,64,126,18","text":"REPUBLICA"},{"boundingBox":"536,65,129,17","text":"ARGENTINA"},{"boundingBox":"689,64,128,18","text":"MERCOSUR"}]},{"boundingBox":"401,90,456,18","words":[{"boundingBox":"401,90,115,18","text":"REGISTRO"},{"boundingBox":"525,91,113,17","text":"NACIONAL"},{"boundingBox":"646,91,30,17","text":"OE"},{"boundingBox":"685,91,41,17","text":"LAS"},{"boundingBox":"735,91,122,17","text":"PERSONAS"}]},{"boundingBox":"400,117,637,21","words":[{"boundingBox":"400,117,128,18","text":"MINISTERIO"},{"boundingBox":"536,118,42,17","text":"DEL"},{"boundingBox":"587,117,112,21","text":"INTERIOR,"},{"boundingBox":"707,118,78,17","text":"OBRAS"},{"boundingBox":"793,118,111,17","text":"PUBLICAS"},{"boundingBox":"912,119,13,15","text":"Y"},

Se encuentra a disposición para consultar la documentación técnica, revisar los parámetros de entrada/salida y evaluar las respuestas de la api accediendo a nuestro API-Doc. Así mismo si se registra gratuitamente en nuestro sistema, puede acceder a generar sus Token de Prueba e ingresar a nuestro portal API-Test

Definición Técnica de la API: