IDCHECKIO

The ID document checking NodeJS library.

Web application : https://idcheck.io

Mashape REST API : https://market.mashape.com/ariadnext/idcheck-io-api

Swagger REST API : https://api.idcheck.io/swagger/#/

Python Client library : https://github.com/ariadnext/IDCheckIO

Provided by : http://www.ariadnext.com

Account

To create your account an credit, contact us by email with your needs at : contact@idcheck.io

Installation

Simply...

npm install idcheckio --save

Usage

Fast path :

var Idcheckio = require('idcheckio').idcheckio;

// your idcheckio account.
var config = { user:'my@email.com', pwd:'mypwd' };
var idcheckio = new Idcheckio( config );

idcheckio.analyseMRZ( 'P<UTOBANDERAS<<LILIAN<<<<<<<<<<<<<<<<<<<<<<<', 
                      '01234567894UTO8001014F2501017<<<<<<<<<<<<<06', 
                      '', function(err, result){
   if(err){ throw err; }
    console.log(JSON.stringify(result,0,2));
}

complete config json

{
    user : 'emailAccount@idcheckio.com',   // MANDATORY
    pwd  : 'mypassword',				      // MANDATORY
    language : 'EN' || 'FR',               // default: EN
    protocol : 'https' || 'http',          // default: https
    host : 'api.idcheck.io',               // default: api.idcheck.io
    port : '443'                           // default: 443
}

analyseMRZ

Analyse MRZ lines, get result of the analysis into callback.

Parameters are the three lines of MRZ, complete lines with ''.

Get a pdf report from the uid in result and the getReport section.

idcheckio.analyseMRZ( 'P<UTOBANDERAS<<LILIAN<<<<<<<<<<<<<<<<<<<<<<<', 
                      '01234567894UTO8001014F2501017<<<<<<<<<<<<<06', 
                      '', function(err, AnalyseResultObject){
   if(err){ throw err; }
    console.log(JSON.stringify(AnalyseResultObject,0,2));
}

The AnalyseResultObject is described below.

analyseImage

Analyse an image (pdf, jpg, png, tiff), get result of the analysis into callback.

• MANDATORY First parameter is the document face ( the MRZ is visible ) encoded in base64.
• Secound parameter is the document back ( face without MRZ ), '' if no face.

Get a pdf report from the uid in result and the getReport section.

idcheckio.analyseImage( bufFront.toString('base64'),
                       bufBack.toString('base64'),
                       function(err, AnalyseResultObject){
            if(err) { throw err; }
            console.log(JSON.stringify(AnalyseResultObject,0,2));
        });

The AnalyseResultObject is described below.

getReport

Get a PDF Report with the result of analysis.

This function can be called after analyseMRZ() or analyseImage(), with uid parameter returned by these functions.

The ReportObject returned is described below.

idcheckio.getReport( '1234009234',
                function(err, res ){
                    if(err) { throw err; }
                    console.log(JSON.stringify(result,0,2));
                    fs.writeFileSync("./test/testReport.pdf", res.report, 'base64');
                });

Test

A test folder is accessible and works with your test logins that we provided.

cd test/
// fill the idcio_config object with your logins into test.js
npm test	

Dependencies

Need NodeJS > v0.10.0

This library depends on only one other package :

Objects

AnalyseResultObject

Exemple of result :

{
  "uid": "1234009234",
  "analysisRefUid": "1234660",
  "checkReportSummary": {
    "check": [
      {
        "identifier": "SUMMARY_ID_IDENTIFIED",
        "titleMsg": "Document identification",
        "resultMsg": "Identified document",
        "result": "OK"
      },
      {
        "identifier": "SUMMARY_ID_FALSIFIED",
        "titleMsg": "Document falsification detection",
        "resultMsg": "The document seems to be falsified",
        "result": "ERROR"
      },
      {
        "identifier": "SUMMARY_ID_SPECIMEN",
        "titleMsg": "Sample document detection",
        "resultMsg": "Sample document",
        "result": "ERROR"
      },
      {
        "identifier": "SUMMARY_ID_EXPIRED",
        "titleMsg": "Document expiration",
        "resultMsg": "Not expired",
        "result": "OK"
      }
    ]
  },
  "documentClassification": {
    "idType": "P"
  },
  "documentDetail": {
    "emitCountry": "UTO",
    "documentNumber": "012345678",
    "extraInfos": [
      {
        "dataKey": "EXPIRATION_DATE",
        "dataValue": "10/50/F2",
        "title": "Expiration date"
      },
      {
        "dataKey": "PERSONAL_NUMBER",
        "dataValue": "7",
        "title": "Personal number"
      }
    ]
  },
  "holderDetail": {
    "lastName": [
      "BANDERAS"
    ],
    "firstName": [
      "LILIAN"
    ],
    "nationality": "4UT",
    "gender": "X",
    "extraInfos": [
      {
        "dataKey": "BIRTH_DATE",
        "dataValue": "10/00/O8",
        "title": "Date of birth"
      }
    ]
  },
  "mrz": {
    "line1": "P<UTOBANDERAS<<LILIAN<<<<<<<<<<<<<<<<<<<<<<<",
    "line2": "01234567894UTO8001014F2501017<<<<<<<<<<<<<06"
  }
}

ReportObject

{ uid: '1234920434',
  analysisRefUid: '1234447',
  report: 'JVBERi0x....UVPRgo='
 }

TODO

• exemple folder with sample client code (almost same as /test/test.js)
• async mode
• get cropped images