Mudanças de versão explicação:
xxxxxxxxxxxxxxxxx
xxxxxxxxxx
xxxxxxxxxxxxxx
Seguintes serviços serão retirados da v1, porém não sofreram nenhuma alteração em seus end-points e serão utilizados da mesma forma.
Autenticação
...
Serviços-Gerais
...
Foi incluído um novo serviço para Geração de Relatórios via API Rest
...
As v1 e V2 não sofreram alterações, no momento também serão utilizadas da mesma forma.
...
A principal mudança é que teremos a v5 onde serão enviados os assuntos que sofreram alterações/adição de novos campos conforme o que consta na versão doGostaríamos de informá-los sobre uma atualização importante no versionamento da API e-Sfinge Online, que entrará em vigor a partir de 2025.
A partir dessa data, a API passará a seguir o versionamento anual do layout do e-Sfinge Online. Isso significa que a URL de cada endpoint relacionado ao envio de dados começará com o número da versão correspondente ao ano. Essa alteração se aplicará apenas aos endpoints de envio de dados.
Endpoints de autenticação, serviços gerais e relatórios não serão afetados por essa mudança e continuarão sem versionamento.
Exemplo de novo formato de URL:
/v5/[modulo]/[assunto]/[acao]
Além disso, fizemos uma melhoria no Swagger da aplicação. Agora, os endpoints estão organizados por grupos, o que facilita a navegação e o entendimento da estrutura da API, permitindo uma localização mais eficiente dos serviços disponíveis.
Essa mudança tem como objetivo melhorar a rastreabilidade e o controle de versões dos módulos que envolvem o envio de dados, garantindo maior clareza e estabilidade na integração com o sistema.
...
Referente ao layout 5 Versão Provisória 5.00 (18/09/2024)
Os seguintes serviços já estão disponíveis no ambiente de testing na nova versão /v5:
Atos de Pessoal (Concessão)
Execução Orçamentária:
EmpenhoAtos Jurídicos (parcialmente)
...
Exemplo:
...
Que deverá ser enviado pelo /v5/execucaoorcamentaria/empenho/enviar
...
:
Compras Diretas
Pré-publicaçãoPlanejamento:
Alteração Orçamentaria
Lei orçamentaria anual
À medida que novos serviços forem disponibilizados, liberaremos os endpoints que não sofrerão alterações, bem como os novos serviços e aqueles que tiveram suas implementações modificadas na versão /v5.
Observação:
A partir do dia 25/10/2024, no ambiente de testing, somente será aceita a versão 5 para o layout 2025. Para facilitar os testes/desenvolvimento, em testing, também serão aceitos dados com data de 2024 para versão 5.
A partir de 1/1/2025, a versão 5 deverá ser utilizada obrigatoriamente para os dados de 2025 em produção.
Todas essas mudanças já estão no ambiente de testing: https://virtual.testing.tce.sc.gov.br/esfingeonline/swagger-ui.html