Coleção Postman
Cada contrato possui uma coleção Postman pré-configurada com URLs de sandbox e exemplos de corpo de requisição. Importe a coleção, preencha suas credenciais e você poderá chamar todos os endpoints sem escrever código.
Coleções por contrato
| Contrato | Coleção | Observações |
|---|---|---|
| Web & SDK | Download | Inclui requisição de token OAuth2, criação de processo, GET process, busca de documento. |
| API | Download | Inclui operações de Onboarding, Transacional, Documento e Validação de Idade. |
| Magic Link (Mexico) | Download | Inclui criação de Magic Link, busca de histórico, exemplos de payloads de webhook. |
Repositório
Todas as coleções estão em unico-labs/postman-collections. Abra issues lá caso encontre algo desatualizado.
Configuração
- Baixe a coleção do contrato que está integrando.
- Importe no Postman:
File > Import > Upload Files. - Configure as variáveis de ambiente no nível do workspace:
| Variável | Valor |
|---|---|
client_id | Seu Unico Client ID. |
private_key | Sua chave privada Unico (formato PEM, linha única, newlines escapadas). |
api_key | Valor do header APIKEY do contrato API. |
trully_api_key | Valor do x-api-key do Magic Link. |
host | Host sandbox ou produção (consulte Ambientes). |
- Execute a requisição OAuth2 primeiro — ela armazena em cache o access token em
{{access_token}}para o restante da coleção.
Scripts de pré-requisição
As coleções incluem scripts de pré-requisição que:
- Geram o JWT assertion usando a chave privada configurada.
- Renovam automaticamente o access token quando está prestes a expirar.
- Injetam IDs de correlação nos headers para rastreabilidade.
Não é necessário modificá-los, mas inspecione-os para entender o fluxo.
Próximos passos
- Autenticação — gere as credenciais que a coleção precisa.
- Visão geral Web & SDK — contexto para a coleção Web & SDK.
- Visão geral API — contexto para a coleção API.