Atualmente, a política de acesso via API do módulo de Orçameno Impositivo, está baseada nas mesmas regras de acesso dos usuários ao sistema, por isso, para utilização da API basta ter um usuário cadastrado no SIOP.
A solução de segurança da API utiliza as permissões do usuário conectado para autenticação e autorização de acesso. Portanto, o acesso às propriedades e operações do schema da API será disponibilizado de acordo com as permissões do usuário.
Atualmente, não há necessidade de aquisição de credenciais ou envio de formulários para acesso à API, como no caso do web service. A solução de segurança da API utiliza o esquema de autenticação HTTP via token (Bearer Authentication). Portanto, para o acesso ao módulo de Orçamento Impositivo via API, basta o envio de requisições HTTP com o token de acesso, gerado para um usuário com acesso ao SIOP.
A API utiliza GraphQL como formato das requisições. Antes de solicitar qualquer informação é necessário obter o token do serviço de autenticação.
O token de acesso pode ser obtido a partir de qualquer cliente HTTP, disponível nas bibliotecas da maioria das linguagens de programação. No exemplo a seguir é usado o utilitário curl, disponível em diversos sistemas operacionais.
curl -k -X POST 'https://www.siop.planejamento.gov.br/modulo/login/rest/login'
-H "Content-Type: application/json"
-d '{"cpf": "<cpf do usuário>", "senha":"<senha do usuário>"}'
O retorno dessa requisição é o token, que deve ser passado no cabeçalho das demais requisições, tomando-se o cuidado de retirar as aspas.
| ATENÇÃO! O token de acesso tem validade de 48h. |
|---|
\\ ==== Como obter o Token de Acesso - Web-Service ====
O token de acesso pode ser obtido a partir de qualquer cliente HTTP, disponível nas bibliotecas da maioria das linguagens de programação. No exemplo a seguir é usado o utilitário curl, disponível em diversos sistemas operacionais.
curl -k -X POST 'https://www.siop.planejamento.gov.br/modulo/login/rest/login'
-H "Content-Type: application/json"
-d '{"login": "<login do usuário>", "senha":"<senha do usuário>"}'
O retorno dessa requisição é o token, que deve ser passado no cabeçalho das demais requisições, tomando-se o cuidado de retirar as aspas.
| ATENÇÃO! O token de acesso tem validade de 48h. |
|---|
Caso seja necessária a troca da senha de acesso do usuário, pode-se utilizar a função de troca de senha, também via API do módulo de Orçamento Impositivo.
Para trocar da senha de acesso de um usuário, usando o curl, basta realizar uma requisição REST para a operação trocarsenha, como no exemplo abaixo:
curl -k -X POST 'https://www.siop.planejamento.gov.br/modulo/login/rest/trocarsenha'
-H 'Authorization: Bearer <token>' -H "Content-Type: application/json"
-d '{"novasenha": "<nova senha do usuário>"}'
Ambiente disponibilizado para testes de integração e utilização da API do módulo de Orçamento Impositivo.
| Recomenda-se, fortemente, a utilização desse ambiente para os testes necessários à fase de construção da solução de integração com a API, bem como, recomenda-se a boa prática de realização da homologação da solução, antes de sua disponibilização no ambiente de produção. |
|---|
Esse ambiente possui as seguintes características a serem consideradas:
curl -k -X POST 'https://testews.siop.gov.br/modulo/impositivo/itens/api' -H 'Authorization: Bearer <token>' -H 'Content-Type:application/graphql' -d '<query, mutation ou subscription graphQL correspondente à operação desejada>'
Ambiente disponibilizado para integração via API ao ambiente de produção do módulo de Orçamento Impositivo.
| Recomenda-se, fortemente, a utilização desse ambiente apenas por soluções de integração com a API que já estejam estáveis e homologadas. |
|---|
Esse ambiente possui as seguintes características a serem consideradas:
curl -k -X POST 'https://www.siop.planejamento.gov.br/modulo/impositivo/itens/api' -H 'Authorization: Bearer <token>' -H 'Content-Type:application/graphql' -d '<query, mutation ou subscription graphQL correspondente à operação desejada>'
O Explorador de API's é uma ferramenta disponibilizada para auxiliar integrações com o SIOP. Para acessá-la, é necessário se ter um usuário cadastrado no SIOP com a devida permissão.
Nela é possível testar a API e acessar a documentação do código mais atualizada.
Veja aqui vídeo explicativo de como usá-la.