feat: Adição de funcionalidade de busca para feriados municipais, estaduais e nacionais. #555
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Issues relacionadas: #380 e #541
Descrição
A issue #380 referente ao repositório Brasil API visa discutir a possibilidade de implementação de uma integração de informações de feriados municipais na API, facilitando assim a realização de possíveis cálculos gerais.
A issue #541 por sua vez abre ideia para a necessidade de se desenvolver a funcionalidade de listar feriados por estado, possibilitando assim acompanhar as datas de feriados em um escopo geográfico maior do que os apresentados na issue #380.
Resolução
Requisição de dados
Para a implementação do que foi discutido nesta Issue, foi realizado uma recuperação de informações a partir do repositório feriados-brasil, presentes no endereço https://github.com/LuisLourenco1/feriados-brasil, que é mantido por nós mesmos (Contém os feriados de 2010 até 2025, onde deve atualizado antes de 2025). A partir da recuperação das informações contidas neste repositório, foram realizadas requisições HTTP para coletar as informações dos feriados municipais, expressas em arquivos JSON.
Implementação e Integração no Brasil API
Rotas:
/api/feriados/v2?year=2023
Retorna os feriados nacionais de 2023.
Caso o ano não seja passado, será considerado o ano atual.
/api/feriados/v2/ms?year=2022
Retorna os feriados do estado de Mato Grosso do Sul em 2022.
/api/feriados/v2/ms/trêslagoas
Retorna os feriados da cidade de Três Lagoas no ano atual