GetSelfie

Nesta seção, você encontrará como obter a selfie de um processo no by Unico através da API REST

---

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.cadastro.uat.unico.app/client/v1/process;

• Produção: https://api.cadastro.unico.app/client/v1/process.

---

GetSelfie

Endpoint para buscar a selfie do processo do by Unico. O parâmetro opcional raw=true pode ser utilizado para obter o arquivo bruto.

GEThttps://api.cadastro.uat.unico.app/client/v1/process/{id}/selfie

Path parameters

id*string

ID do processo.

Query parameters

Response

200400401403404500

Selfie obtida com sucesso.

Body

application/json

fileContentsstring

Conteúdo da selfie codificado em base64.

Example: "/9j/4AAQSkZJRgABAQA[...]QkeQUjE"

contentTypestring

Tipo do conteúdo da imagem (jpeg ou png).

Example: "image/jpeg"

Request

JavaScriptCurlPython

const response = await fetch('https://api.cadastro.uat.unico.app/client/v1/process/{id}/selfie', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401403404500

{
  "fileContents": "/9j/4AAQSkZJRgABAQA[...]QkeQUjE",
  "contentType": "image/jpeg"
}

O parâmetro [?raw=true] é opcional. Caso sua conta de serviço tenha a permissão necessária, você poderá utilizá-lo para obter a selfie sem a marca d'água.

Para verificar detalhadamente os parâmetros da API, consulte a seção Especificação de parâmetros.

A selfie do usuário só fica disponível para consulta via REST API durante 8h após a finalização do processo biométrico. Após este período, não é possível recuperar a selfie do usuário.

Responses de erro

---

400 Bad Request

code	message	Descrição
3	process id is invalid	Quando o id de processo é inválido.

401 Unauthorized

message	Descrição
Jwt header is an invalid JSON	Quando o access-token utilizado contém caracteres errados.
Jwt is expired	Quando o access-token utilizado expirou

403 Forbidden

code	message	Descrição
7	no permission	Quando a conta de serviço não possui a permissão para obter a selfie

404 Not Found

code	message	Descrição
5	error getting process: rpc error: code = NotFound desc = process not found	Quando o id do processo não foi encontrado

500 Internal Server Error

code	message	Descrição
99999	Internal failure! Try again later	Quando há algum erro interno.

---

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.