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 |
|---|---|---|
| Autenticação | Baixar | Baixe o arquivo abaixo, importe-o no Postman e substitua os valores dos parâmetros "service_account," "tenant_id," e "secret_key" para testar a requisição. |
| API | Baixar | Inclui criação de processo (POST) e GET process. |
Configuração
- Baixe a coleção do contrato que você está integrando.
- Importe no Postman:
File > Import > Upload Files. - Configure as credenciais de acordo com a coleção:
Autenticação — abra a coleção, vá até a aba Variables e preencha:
| Variável | Valor |
|---|---|
service_account | Nome da sua service account. |
tenant_id | Seu tenant ID. |
secret_key | Sua chave privada (formato PEM). |
base_path | Host do endpoint de token. O padrão é UAT (https://identityhomolog.acesso.io); altere para https://identity.acesso.io em produção. |
API — abra cada requisição e substitua os valores de Authorization: Bearer e do header APIKEY pelas suas próprias credenciais.
- Execute a requisição de Autenticação — o script de pré-requisição constrói automaticamente a assertion JWT e a armazena em
{{jwt_token}}.
Scripts de pré-requisição
Apenas a coleção de Autenticação inclui um script de pré-requisição. Ele:
- Lê
service_account,tenant_id,secret_keyebase_pathdas variáveis da coleção. - Constrói e assina a assertion JWT (RS256) usando a biblioteca KJUR embutida.
- Salva o token assinado em
{{jwt_token}}, que é injetado automaticamente no corpo da requisição.
A coleção API não possui script de pré-requisição — as credenciais são configuradas diretamente nos headers da requisição.
Próximos passos
- Autenticação — gere as credenciais que a coleção precisa.
- Visão geral API — contexto para a coleção API.