Pular para o conteúdo principal

Guia da API

A API REST permite que você, ao fazer a integração com o Unico IDLive, alcance seu objetivo. A API utiliza requisições e respostas no formato JSON e possui um sistema de autenticação baseado em JWT Bearer.

Principais Recursos

Através da API você gerencia transações através da prova de vida.

  • CreateProcess - Criar uma transação com prova de vida;
Importante
  • É possível combinar os resultados do Unico IDLive e IDUnico. Com a combinação, você tem a opção de usar o Unico IDLive no topo do seu funil para verificar a prova de vida e então, quando for necessário, usar o GetProcess do IDunico para obter informações da autenticidade do CPF. Para isso, você precisa ter habilitado o IDUnico através da API Key.

Para mais informações sobre o GetProcess do IDUnico, consulte Get Process - IDUnico.

Antes de iniciar a integração, certifique-se que você possui credenciais válidas para utilização do produto.

Obtenha um token OAuth válido;

Para efetuar requisições à API REST você precisa de um token de acesso OAuth válido. Caso não esteja familiarizado com o modelo de autenticação OAuth, entenda como gerar um token válido neste artigo. Após a geração, o token de acesso deve ser enviado no header de sua requisição, junto ao parâmetro Authorization.

Ambientes

Ao iniciar a integração você receberá as credenciais do ambiente de homologação. Somente após o processo de testes e certificação é que você receberá as credenciais de produção.

Você deve apontar suas requisições às URLs corretas em cada estágio de sua integração. Abaixo estão listadas informações de IP e Porta de homologação e produção:

  • Ambiente de homologação: https://api.id.uat.unico.app/;
  • Ambiente de produção: https://api.id.unico.app/;
  • Porta padrão: 443.
AMBIENTE PARA TESTES
  • Você pode utilizar a API em um ambiente de homologação para testar as funcionalidades evitando afetar seu entorno produtivo.

  • No ambiente de homologação (UAT) nenhuma face está cadastrada, sendo assim, qualquer imagem pode ser enviada.

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.