1 de 1

Validation (1:1)

In this section, you will find the specifics of creating a process that includes the 1:1 Validation capability

Getting started

Your API requests are authenticated using an access token. Any request that does not include a valid access token will return an error.

You can learn more about generating an access token here.

Endpoints:

UAT: https://api.id.uat.unico.app/processes/v1;
Production: https://api.id.unico.app/processes/v1.

In the process creation, the following are mandatory: subject.code, referenteProcessId, and imageBase64;
In the process response, we return the id, authenticated (result of the 1:1 Validation), and liveness (result of the Liveness).

For this use case, there is no need to perform the GetProcess, as the response is synchronous.

Still need help?

Didn't find something or still need help? If you're already a client or partner, you can reach out through our Help Center.

Validation (1:1)

In this section, you will find the specifics of creating a process that includes the 1:1 Validation capability

Getting started

Your API requests are authenticated using an access token. Any request that does not include a valid access token will return an error.

You can learn more about generating an access token here.

Endpoints:

UAT: https://api.id.uat.unico.app/processes/v1;
Production: https://api.id.unico.app/processes/v1.

CreateProcess

Endpoint to create a new 1:1 validation process by Client.

POSThttps://api.id.uat.unico.app/processes/v1/

Header parameters

Authorization*string

Valid access-token.

APIKEY*string

Valid APIKEY with 1:1 validation capability.

Body

subject*object

code*string

User's CPF.

Example: "12345678909"

referenceProcessId*string

Identifier of the process generated during the biometric transaction creation, whose photo will be used for comparison.

Example: "80371b2a-3ac7-432e-866d-57fe37896ac6"

imageBase64*string

Encrypted generated by the SDK.

Example: "/9j/4AAQSkZJR..."

Response

Process created successfully (User authenticated).

Body

idstring

Process ID.

Example: "80371b2a-3ac7-432e-866d-57fe37896ac6"

authenticatedboolean

Authentication result.

Example: true

livenessinteger

Result of the liveness test.

Example: 1

Request

const response = await fetch('https://api.id.uat.unico.app/processes/v1/', {
    method: 'POST',
    headers: {
      "Authorization": "text",
      "APIKEY": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "subject": {
        "code": "12345678909"
      },
      "referenceProcessId": "80371b2a-3ac7-432e-866d-57fe37896ac6",
      "imageBase64": "/9j/4AAQSkZJR..."
    }),
});
const data = await response.json();

Response

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "authenticated": true,
  "liveness": 1
}

In the process creation, the following are mandatory: subject.code, referenteProcessId, and imageBase64;
In the process response, we return the id, authenticated (result of the 1:1 Validation), and liveness (result of the Liveness).

For this use case, there is no need to perform the GetProcess, as the response is synchronous.

Still need help?

Didn't find something or still need help? If you're already a client or partner, you can reach out through our Help Center.

CreateProcess

Endpoint to create a new 1:1 validation process by Client.

POSThttps://api.id.uat.unico.app/processes/v1/

Header parameters

Authorization*string

Valid access-token.

APIKEY*string

Valid APIKEY with 1:1 validation capability.

Body

subject*object

code*string

User's CPF.

Example: "12345678909"

referenceProcessId*string

Identifier of the process generated during the biometric transaction creation, whose photo will be used for comparison.

Example: "80371b2a-3ac7-432e-866d-57fe37896ac6"

imageBase64*string

Encrypted generated by the SDK.

Example: "/9j/4AAQSkZJR..."

Response

Process created successfully (User authenticated).

Body

idstring

Process ID.

Example: "80371b2a-3ac7-432e-866d-57fe37896ac6"

authenticatedboolean

Authentication result.

Example: true

livenessinteger

Result of the liveness test.

Example: 1

Request

const response = await fetch('https://api.id.uat.unico.app/processes/v1/', {
    method: 'POST',
    headers: {
      "Authorization": "text",
      "APIKEY": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "subject": {
        "code": "12345678909"
      },
      "referenceProcessId": "80371b2a-3ac7-432e-866d-57fe37896ac6",
      "imageBase64": "/9j/4AAQSkZJR..."
    }),
});
const data = await response.json();

Response

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "authenticated": true,
  "liveness": 1
}