Introdução
Este guia explica como efetuar requisições com a API REST do ID Unico.
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 familizarizado 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.
Ao iniciar a integração você receberá credenciais ao ambiente de homologação. Somente após o processo de testes e certificação você receberá 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: 80.
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.
Se enviar com CPF (code) “12345678909” o retorno é sempre yes. Qualquer outro CPF o retorno é sempre inconclusive.
Para os demais dados (name, email, phone) qualquer valor pode ser enviado.