Visão Geral
Licença: CC BY 4.0 – Você pode copiar e redistribuir com crédito ao município.
Formato: JSON
URL Base: https://api-ab.up.railway.app/
Sobre Dados Abertos
A Open Knowledge Foundation compreende que os dados são considerados abertos quando:
Qualquer pessoa pode acessar, usar, modificar e compartilhar livremente para qualquer finalidade (sujeito a, no máximo, a requisitos que preservem a proveniência e a sua abertura). Isso geralmente é satisfeito pela publicação dos dados em formato aberto e sob uma licença aberta.
Assim, Dados Abertos são uma metodologia para a publicação de dados do governo em formatos reutilizáveis, visando o aumento da transparência e maior participação política por parte do cidadão, além de gerar diversas aplicações desenvolvidas colaborativamente pela sociedade.
No caso do Brasil, vários órgãos da Administração Pública já publicam seus dados na web, na forma de relatórios e balanços para que os cidadãos possam acompanhar os resultados das ações de governo.
Endpoint: Listar Secretarias
GET /secretariasRetorna todos os registros de secretarias e seus detalhes.
Exemplo de Requisição
curl "https://api-ab.up.railway.app/secretarias"
Resposta Esperada
[
{
"Secretaria": "Secretaria Municipal de Saúde",
"Responsável": "Nome do atual responsável",
"Expediente": "Segunda a Sexta, 08h às 14h",
"Endereço": "Av. Central, 100, Centro, Cidade - UF",
"Telefone": "(79) 91234-5678"
},
{
"Secretaria": "Secretaria de Administração",
"Responsável": "Nome do atual responsável",
"Expediente": "Segunda a Sexta, 07h às 13h",
"Endereço": "Praça dos Três Poderes, 10, Cidade - UF",
"Telefone": "(79) 92345-6789"
}
// ...mais secretarias
]
Dicionário de Dados
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
secretaria |
String | Nome oficial da secretaria. | Secretaria de Assistência Social |
responsável |
String | Nome do responsável atual pela secretaria. | Fulano de Tal |
expediente |
String | Horário e dias de funcionamento. | SEG à SEX, 07h às 13h |
endereço |
String | Endereço completo institucional. | Rua Central, 122, Centro |
telefone |
String | Telefone de contato oficial. | (79) 9999-9999 |
Códigos de Resposta HTTP
| Código | Significado |
|---|---|
| 200 | Sucesso. Dados retornados normalmente. |
| 400 | Parâmetros inválidos na requisição. |
| 404 | Endpoint não encontrado. |
| 500 | Erro no servidor. |
Exemplo de Consumo em Python
import requests
url = "https://api-ab.up.railway.app/secretarias"
response = requests.get(url)
if response.status_code == 200:
secretarias = response.json()
for secretaria in secretarias:
print(
secretaria["Secretaria"],
"- Responsável:", secretaria["Responsável"],
"- Expediente:", secretaria["Expediente"],
"- Endereço:", secretaria["Endereço"],
"- Telefone:", secretaria["Telefone"]
)
else:
print("Falha na requisição:", response.status_code)
Licença e Utilização
Livre para uso, redistribuição e adaptação, com citação do município.
Sempre consulte a versão mais atual da documentação.
Contato e Suporte
Dúvidas ou sugestões:
Email: contato@areiabranca.se.gov.br
Telefone: (79) 9 9922-8422
Prazo de resposta: até 2 dias úteis.
