Exemplo de chamada¶
Conforme a referência da api, os serviços através dos quais é realizada a manutenção dos cadastros de transações, perfis, e das vinculações desses últimos aos usuários, recebem o token JWT recuperado pelo sistema no header Authorization da requisição, no formato Bearer, conforme especificação.
Inclui uma transação em um sistema
Como exemplo, listamos uma chamada ao serviço Inclui uma transação em um sistema:
curl -X POST "https://h.api.gestao.autorizagov.estaleiro.serpro.gov.br/api-gestao-autoriza/sistemas/1/transacoes" -H "accept: application/json" -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJhdXRvcml6YWdvdi5lc3RhbGVpcm8uc2VycHJvLmdvdi5iciIsImV4cCI6MTU5NzI1NzA4MiwianRpIjoiMGQ5ZDUyM2UtZTYwMy00ODA2LWE5OTktZmJlNDEwZTdiMThjIiwiaWF0IjoxNTk3MjU1MjgyLCJpc3MiOiJBdXRvcml6YSBHb3ZCUiIsInN1YiI6ImF1dG9yaXphZ292LmVzdGFsZWlyby5zZXJwcm8uZ292LmJyIiwiaWRfc2lzdGVtYSI6MSwic2NvcGUiOlsiYXV0b3JpemFfYXBpX2dlc3RhbyJdLCJhbXIiOlsicGFzc3dkIl19.rtOZw9P-W8aohS5qvrp53S7ccY0r0NL625P-OpSj6G1okljEdvErYWEgTIW8-s9HsXpp5T1pP6N5psHu684kCLejUp3m_u_AcXyaxhGvvC751QAErkis4Ty-G5QD7LHKb3ymHZEvX-zQgFCccetElMWV1JshF0sVVbTD5jYDA9aizeS_dplCOpopQ_aWHX4QMv8Ncmzd6RvNOJDEF9zSanfESc_VcaqWLW8RYhah94DOW7VdBcaI76CEekwvYf0Jhp4CreBf6NGIfdfPdOJugxL-dSljEGVMGEj0LDt63vQeU9gfjWRlaqehwZdX__BrXHgj4Oq5m8dOM0UkatDO6g" -H "Content-Type: application/json" -d "{\"nm_transacao\":\"Nome exemplo\",\"ds_transacao\":\"Desc exemplo\"}"
Execução de chamadas da API online¶
Para realização de testes de acessos mais simples, a API pode ser chamada diretamente através da página de referência da api.
- Escolher o ambiente de execução no combo Servers
- Clicar no botão Authorize e, no BasicAuth, colocar o client_id e a senha da aplicação nos campos Username e Password, respectivamente. Clicar em Authorize e Close.
- No serviço GET /token, clicar em Try it Out e Execute. Copiar a string do token JWT correspondente ao atributo access_token do retorno e anotar o id do sistema.
- Clicar novamente no botão Authorize e, no BearerAuth, colar a string do token recuperado no passo anterior. Clicar em Authorize e Close.
- Escolher um serviço, clicar em Try it Out, preencher os parâmetros do serviço (incluindo o id do sistema) e clicar em Execute.
Cuidado ao executar a chamada online
Lembre-se que ao escolher um servidor e executar um teste, qualquer dado mantido será efetivamente persistido na respectiva base de dados, e serão gerados registros de auditoria para as chamadas. É sua responsabilidade usar o recurso online criteriosamente.
Sugerimos fazer testes de conectividade e validações das credenciais usando os serviços de recuperação ou listagem.