1 de 1

Validação (1:1)

Nesta seção, você encontrará as particularidades de criar um processo que tenha a Validação (1:1) como capacidade

Antes de começar

Suas requisições de API são autenticadas utilizando um access-token. Qualquer requisição que não inclua um access-token válido retornará um erro.

Você pode ver mais sobre como gerar um access-token aqui.

Endpoints:

UAT: https://api.id.uat.unico.app/processes/v1;
Produção: https://api.id.unico.app/processes/v1.

Note que para a utilização da capacidade de Validação (1:1):

Na criação do processo, são obrigatórios subject.code, referenteProcessId e imageBase64;
No response do processo, devolvemos o id, authenticated (resultado da Validação 1:1) e liveness (resultado da Prova de vida).

Para este caso de uso, não há a necessidade de realizar o GetProcess, visto que a resposta é síncrona.

O endpoint acima considera o uso da capacidade Validação (1:1) em conjunto com a capacidade Prova de vida.

Dúvidas?

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.

Validação (1:1)

Nesta seção, você encontrará as particularidades de criar um processo que tenha a Validação (1:1) como capacidade

Antes de começar

Suas requisições de API são autenticadas utilizando um access-token. Qualquer requisição que não inclua um access-token válido retornará um erro.

Você pode ver mais sobre como gerar um access-token aqui.

Endpoints:

UAT: https://api.id.uat.unico.app/processes/v1;
Produção: https://api.id.unico.app/processes/v1.

CreateProcess

Endpoint para criar um novo processo de validação 1:1 no by Client.

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

Header parameters

Authorization*string

Access-token válido.

APIKEY*string

APIKEY válida com a capacidade validação 1:1.

Body

subject*object

code*string

CPF do usuário.

Example: "12345678909"

referenceProcessId*string

Identificador do processo que foi gerado durante a criação da transação biométrica, cuja foto será usada para comparação.

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

imageBase64*string

Encrypted gerado pelo SDK.

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

Response

Processo criado com sucesso (Usuário autenticado).

Body

idstring

ID do processo.

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

authenticatedboolean

Resultado da autenticação.

Example: true

livenessinteger

Resultado da prova de vida.

Example: 1

Request

Response

Note que para a utilização da capacidade de Validação (1:1):

Na criação do processo, são obrigatórios subject.code, referenteProcessId e imageBase64;
No response do processo, devolvemos o id, authenticated (resultado da Validação 1:1) e liveness (resultado da Prova de vida).

Para este caso de uso, não há a necessidade de realizar o GetProcess, visto que a resposta é síncrona.

O endpoint acima considera o uso da capacidade Validação (1:1) em conjunto com a capacidade Prova de vida.

Dúvidas?

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.

CreateProcess

Endpoint para criar um novo processo de validação 1:1 no by Client.

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

Header parameters

Authorization*string

Access-token válido.

APIKEY*string

APIKEY válida com a capacidade validação 1:1.

Body

subject*object

code*string

CPF do usuário.

Example: "12345678909"

referenceProcessId*string

Identificador do processo que foi gerado durante a criação da transação biométrica, cuja foto será usada para comparação.

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

imageBase64*string

Encrypted gerado pelo SDK.

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

Response

Processo criado com sucesso (Usuário autenticado).

Body

idstring

ID do processo.

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

authenticatedboolean

Resultado da autenticação.

Example: true

livenessinteger

Resultado da prova de vida.

Example: 1

Request

Response

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();

Validação (1:1)

Antes de começar

Endpoints:

Dúvidas?​

Validação (1:1)

Antes de começar

Endpoints:

CreateProcess

Dúvidas?​

CreateProcess

Dúvidas?

Dúvidas?