WebService: API Rest-full com Feriados de todas cidades do Brasil.



O Brasil tem mais de 5.500 municípios. Já imaginou o trabalho que dá pra manter atualizadas as informações sobre os feriados de todas essas cidades? Feriados que estão frequentemente sendo alterados?

Sim, dá muito trabalho, mas o Calendario.com.br oferece isso pra você, através de nossa API WebService (RESTfull).

Saber com precisão todos os feriados é muito importante para empresas de logística, ou mesmo para o planejamento de empresas em geral.

Por isso, temos como meta ter o mais preciso e atualizado banco de dados de feriados do Brasil e, para isto, contamos com nossa própria equipe, mas também com sua ajuda. Não deixe de nos atualizar sobre os feriados de sua cidade.

O uso da API WebService é muito simples, basta uma chamada à URL, com o ano, estado e nome da cidade desejada, desta forma:

https://api.calendario.com.br/?token=[seu-token]&ano=2018&estado=SP&cidade=Sao_Paulo

Se preferir, pode também usar o código IBGE da cidade, veja:

https://api.calendario.com.br/?token=[seu-token]&ano=2018&ibge=3550308

A API WebService retornará todos os feriados da cidade de São Paulo, do ano de 2018, no formato XML, conforme pode ver abaixo:



Se preferir, você pode também receber os dados no formato JSON, bastando incluir o parametro "json=true" na URL:

https://api.calendario.com.br/?json=true&token=[seu-token]&ano=2018&ibge=3550308



Preencha abaixo seu e-mail para receber o token e link de utilização da API WebService:



Usando o Código IBGE das cidades.



Como mostramos acima, existe também a opção de utilizar o tabela de códigos IBGE para as cidades, facilitando assim a integração da API com outros sistemas.

Você pode baixar aqui a tabela de cidades do IBGE, ou no sistema SPED do próprio site do IBGE.

É importante notar que os dois digitos iniciais do códigos IBGE servem para identificar também o estado de cada cidade, conforme a lista abaixo:

12 = AC
27 = AL
16 = AP
13 = AM
29 = BA
23 = CE
53 = DF
32 = ES
52 = GO
21 = MA
51 = MT
50 = MS
31 = MG
15 = PA
25 = PB
41 = PR
26 = PE
22 = PI
33 = RJ
24 = RN
43 = RS
11 = RO
14 = RR
42 = SC
35 = SP
28 = SE
17 = TO



Usando o Componente da Biblioteca ACBr para acessar a API.



Existe também uma iniciativa de código aberto, chamada ACBr, com componentes Delphi e Lazarus, onde um dos componentes permite acessar diretamente a API de Feriados.

Se preferir, você pode baixar diretamente, apenas o componente de Feriados, nesta página de discussão: ACBrFeriado



Limitações no uso da API.



Você pode utilizar a API, gratuitamente, para um número ilimitado de acessos, solicitando os feriados de até 5 cidades diferentes.

Caso precise de um número um pouco superior a este, não deixe de nos contactar, podemos verificar a possibilidade de liberar mais acessos mensais.

Se desejar acesso ilimitado ao banco de dados, adquira um pacote profissional de acessos. Entre em contato conosco: calendario@calendario.com.br


Veja alguns de nossos clientes: