API de Feriados Brasileiros

Uma API simples em Node.js para consultar feriados nacionais, estaduais e municipais do Brasil. Os dados são obtidos através de integração com serviços de feriados.

Pré-requisitos

• Node.js

Instalação

1. Clone o repositório ou baixe os arquivos.
2. Instale as dependências (embora o script atual utilize módulos nativos, é boa prática manter o ambiente consistente):

npm install

Como Executar

Para iniciar o servidor:

npm start

O servidor iniciará em http://localhost:3000.

Uso

A API responde a requisições GET. Se você acessar a raiz sem parâmetros, verá uma página de ajuda HTML.

Parâmetros

• estado: (Obrigatório para filtros regionais) Sigla do estado (ex: SP, RJ, MG).
• cidade: (Opcional) Nome da cidade (ex: Sao Paulo, Rio de Janeiro). Requer que o estado seja informado.
• ano: (Opcional) Ano da consulta. Se omitido, utiliza o ano corrente.

Exemplos de Requisição

1. Consultar feriados de um estado (ex: São Paulo - SP):

GET http://localhost:3000/?estado=SP

2. Consultar feriados de uma cidade específica (ex: Ribeirão Preto - SP):

GET http://localhost:3000/?estado=SP&cidade=Ribeirao Preto

3. Consultar feriados de um ano específico:

GET http://localhost:3000/?estado=RJ&ano=2025

Tratamento de Erros

• Retorna 400 Bad Request se uma cidade for informada sem o estado.
• Retorna 500 Internal Server Error em caso de falhas na comunicação com a fonte de dados ou erro de processamento.