Scan Studio (Estudio de escaneo)

Servicio para extraer datos de documentos utilizando modelos entrenados por Verifik.

Endpoint

POST - https://api.verifik.co/v2/ocr/scan-studio

Scan Studio permite la extracción fluida de información crucial desde documentos escaneados utilizando tecnología de Reconocimiento Óptico de Caracteres (OCR). Para utilizar el servicio, simplemente proporciona la imagen en formato Base64 o una URL donde esté alojada la imagen.

Este servicio emplea tecnología avanzada de OCR para extraer e interpretar con precisión la información de los documentos escaneados. Los datos extraídos se presentan como texto OCR junto con sus etiquetas correspondientes.

Para garantizar la precisión y confiabilidad de los datos, la información extraída pasa por un proceso de validación y verificación. Cada campo tiene un estado que indica si la predicción de OCR fue correcta o no.

Nota: Este servicio utiliza modelos previamente creados y entrenados por Verifik, lo que garantiza tiempos de respuesta rápidos y una mayor precisión en la extracción de información.

Ejemplos de Documentos de Identidad (ID's):

• Colombian ID Card

• Alberta Driver Licence

• Mexico INE

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Params

Name	Type	Description
image	string	Image in Base64 encoded format or a URL where the image is hosted.

Request

Node.js

const axios = require('axios');
let data = JSON.stringify({
  "image": "/9j/4AAQSkZJRgABAQEASA....AAD/4gIoS=",
  "documentType": "CC"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.verifik.co/v2/ocr/scan-studio',
  headers: { 
    'Content-Type': 'application/json', 
    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJ0w1splt4Cw'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

PHP

<?php
$client = new Client();
$headers = [
  'Content-Type' => 'application/json',
  'Authorization' => '••••••'
];
$body = '{
  "image": "/9j/4AAQSkZJRgABAQEA...xbjqiSXFqrqWSutTpCVOELMoqFhH/2Q==",
  "documentType": "CC"
}';
$request = new Request('POST', 'https://api.verifik.co/v2/ocr/scan-studio', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

Response

200

{
  "id": "urw2r",
  "data": {
    "__v": 0,
    "_id": "64f8ba3b06f66f85b1ac9381",
    "url": "https://cdn.verifik.co/ocr/64404b1f9856cc8cebd762e7/1690232072151-image.jpeg",
    "type": "ocr",
    "client": "623b6317fe5fd1774be9f566",
    "status": "ACTIVE_BUT_UNVERIFIED",
    "deleted": false,
    "createdAt": "2023-09-06T17:43:23.775Z",
    "updatedAt": "2023-09-06T17:43:23.775Z",
    "requires2FA": false,
    "documentType": "CC",
    "OCRExtraction": {
      "details": {
        "spans": [
          {
            "length": 168,
            "offset": 0
          }
        ],
        "fields": {
          "lastName": {
            "kind": "string",
            "spans": [
              {
                "length": 15,
                "offset": 71
              }
            ],
            "value": "RODRÍGUEZ LÓPEZ",
            "content": "RODRÍGUEZ LÓPEZ",
            "confidence": 0.851,
            "boundingRegions": [
              {
                "polygon": [
                  {
                    "x": 76,
                    "y": 226
                  },
                  {
                    "x": 476,
                    "y": 224
                  },
                  {
                    "x": 476,
                    "y": 270
                  },
                  {
                    "x": 76,
                    "y": 272
                  }
                ],
                "pageNumber": 1
              }
            ]
          },
          "firstName": {
            "kind": "string",
            "spans": [
              {
                "length": 16,
                "offset": 104
              }
            ],
            "value": "MARTÍN FRANCISCO",
            "content": "MARTÍN FRANCISCO",
            "confidence": 0.851,
            "boundingRegions": [
              {
                "polygon": [
                  {
                    "x": 71,
                    "y": 324
                  },
                  {
                    "x": 486,
                    "y": 331
                  },
                  {
                    "x": 485,
                    "y": 379
                  },
                  {
                    "x": 70,
                    "y": 372
                  }
                ],
                "pageNumber": 1
              }
            ]
          },
          "documentNumber": {
            "kind": "string",
            "spans": [
              {
                "length": 17,
                "offset": 53
              }
            ],
            "value": "01101101 01100001",
            "content": "01101101 01100001",
            "confidence": 0.861,
            "boundingRegions": [
              {
                "polygon": [
                  {
                    "x": 159,
                    "y": 172
                  },
                  {
                    "x": 561,
                    "y": 172
                  },
                  {
                    "x": 561,
                    "y": 216
                  },
                  {
                    "x": 159,
                    "y": 216
                  }
                ],
                "pageNumber": 1
              }
            ]
          }
        },
        "docType": "CC",
        "confidence": 0.964,
        "boundingRegions": [
          {
            "polygon": [
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 1000,
                "y": 0
              },
              {
                "x": 1000,
                "y": 614
              },
              {
                "x": 0,
                "y": 614
              }
            ],
            "pageNumber": 1
          }
        ]
      },
      "fullName": "MARTÍN FRANCISCO RODRÍGUEZ LÓPEZ",
      "lastName": "RODRÍGUEZ LÓPEZ",
      "firstName": "MARTÍN FRANCISCO",
      "documentNumber": "01101101 01100001"
    },
    "documentNumber": "01101101 01100001",
    "imageValidated": false,
    "validationMethod": "SCAN_GPT"
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "September 6, 2023 5:43 PM"
  }
}

400

{
  "error": "Invalid request"
}

409

{
    "code": "MissingParameter",
    "message": "documentType must be one of: [CC,RUT,PA,ENSAPA,DNI,CCVE,RIFVE,TLCC]"
}