GetMessage

This article explains how to obtain information from a message via the Unico Check REST API.

This information is available for 8 hours after the document is inserted

How to use it?

Make a GET request to the /messages/{processoId} endpoint

With a valid Access token, make a request to the endpoint (GET/messages/{processoId}).

Parameters:

• HEADER PARAMETERS

Name	Type	Mandatory/Optional	Description
APIKEY	String	Mandatory	API key
Authorization	String	Mandatory	Access token

• PATH PARAMETERS

Name	Type	Mandatory/Optional	Description
processoId	String	Mandatory	Process number

Successful request

If the request was executed successfully, the return response is a JSON containing the following parameters:

{
  "Documents": [
    {
      "Type": 1,
      "Uri": "/Handlers/FileHandler.ashx?op=300&name=11111111-1111-1111-1111-111111111111&extension=1&timestamp=404573&thumb=3&user=oi&div="
    }
  ],
  "HasBiometry": true,
  "Id": "11111111-1111-1111-1111-111111111111",
  "Liveness": 0,
  "Status": 7,
  "Score": 10,
  "OCRCode": 0,
  "FaceMatch": 0,
  "CurrentStep": 99
}

The return parameters are:

Name	Type	Description
Documents.type	integer	Indica o tipo do documento em anexo. Lista de enumerado na sessão 'Enumerados'.
Documents.Uri	string	Indica a URL para download do documento. Ela não vem completa, é necessário adicionar o caminho do portal 'www.acesso.io/instancia/'
HasBiometry	boolean	Indica se o processo possui uma foto biometricamente válida ou não (se possui um rosto ou não).
Id	string	Indica o ID do processo criado com o envio da foto. Ele é utilizado nos outros métodos de 'Processes'
Liveness	integer	Indica o status do liveness, indica se é uma foto de foto ou não. 0 - Desligado // 1 - Foto OK // 2 - Foto de Foto
Score	integer	Indica o score de autenticação daquele CPF / Foto. Ver a sessão de Score para entender melhor sobre
Status	integer	Indica o status do Processo, usado para indicar se está concluído ou não.
OCRCode	integer	Indica o status do OCRCode, procura no documento informado um determinado CPF. 0 - Desligado // 1 - Ok // 2 - Não Ok
FaceMatch	integer	Indica o status do FaceMatch, verifica se a foto no documento é a mesma pessoa da foto informada. 0 - Desligado // 1 - Ok // 2 - Não Ok
CurrentStep	integer	Indica qual é a etapa atual do processo. Lista de enumerado na sessão 'Enumerados'

Request error

If an error occurs, the return response is a JSON containing the error code and description:

{
    "Error": {
        "code": "40004",
        "description": "Error description"
    }
}

For more information on the errors returned, see the list available in the article Response Errors.

Any concerns?

Missing something or still need help? If you are already a customer or partner, you can contact us through the Help Center.