O que é uma API de feriados do Brasil
Uma API de feriados do Brasil devolve, em JSON, se uma data é feriado nacional, estadual
ou municipal. Serve para folha, SLA, prazo processual, e-commerce e qualquer sistema que
não pode manter 5.570 calendários na mão. A MuhBianco autentica por
X-API-Key, inclui a base legal de cada data e declara a cobertura municipal
em vez de inventar cidade sem fonte.
Por que uma lista no banco não aguenta
Feriado nacional quase ninguém erra: são poucas datas e a lei federal é estável. O problema começa no município. Aniversário da cidade, padroeiro, ponto facultativo que a prefeitura trata como feriado — isso sai em Diário Oficial, muda de um ano para o outro e quebra o cálculo de dia útil se a tabela local ficou velha.
Quem copia um CSV uma vez por ano descobre o erro quando o cliente pergunta por que o prazo caiu num feriado municipal. A API existe para essa dívida: você consulta, guarda o JSON do ano e revalida. Não precisa virar especialista em calendário.
O que a MuhBianco devolve
- Feriados por ano, com filtro de UF ou código IBGE do município.
- Dias úteis entre duas datas, já descontando sábado, domingo e feriado.
- Cobertura declarada em
/feriados/cobertura— publicado, monitorado, mapeado ou sem dado. - Base legal e fonte em cada feriado retornado, para auditar depois.
- Ponto facultativo (Carnaval, Corpus Christi) separado do feriado obrigatório.
URL base: https://api.muhbianco.com.br/api/latest. Contrato também em
/api/v1 se você quiser travar a versão. Documentação com parâmetros e
erros: docs da API de feriados.
O que ela não é
Não é calendário corporativo da sua empresa. Recesso interno, bridge e “emenda” que só
o RH conhece continuam no seu lado. Não inventa feriado municipal sem fonte oficial.
Não cobra por requisição: a cota diária (10.000, zerando à meia-noite UTC) devolve
429, nunca débito extra no saldo.
Também não usa WhatsApp. Quem busca agente no Zap está em outro produto. Esta API é chave HTTP e JSON.
Como começar neste produto
A jornada é exclusiva: conta, saldo, habilitar a API, gerar a chave. Sem confirmar WhatsApp e sem cair no painel genérico no meio. A landing API de feriados do Brasil explica o recorte; o botão “Começar” abre só este fluxo.