Acesso Automatizado (API)

Em conformidade com o Art. 8º, §3º, inciso III da Lei nº 12.527/2011 (Lei de Acesso à Informação), o portal oficial do Município de Taipas do Tocantins disponibiliza acesso automatizado aos dados públicos por meio de APIs (Application Programming Interface), utilizando formatos abertos, estruturados e legíveis por máquina.

Essa funcionalidade permite que cidadãos, jornalistas, pesquisadores, instituições públicas e privadas acessem dados diretamente com transparência e eficiência.

---

Como Funciona

As APIs estão disponíveis via protocolo HTTP, no formato REST, sem necessidade de autenticação. Os dados são retornados em formato JSON e podem ser integrados a qualquer sistema.

---

Documentação das APIs Disponíveis

Ouvidoria

Consulta de manifestações registradas pela Ouvidoria Municipal.

Método: GET
URL:
https://taipas.to.gov.br/wp-json/taipas/v1/ouvidoria

Parâmetros:

Parâmetro	Descrição	Obrigatório	Tipo
acao	Valor fixo: relatorio	Sim	Texto
data_inicial	Data inicial do período (formato: AAAA-MM-DD)	Não	Data
data_final	Data final do período (formato: AAAA-MM-DD)	Não	Data

Exemplo de requisição:

https://taipas.to.gov.br/wp-json/taipas/v1/ouvidoria?acao=relatorio&data_inicial=2024-01-01&data_final=2024-12-31

---

Despesas Públicas

Consulta de despesas registradas pelos órgãos da Administração Pública Municipal.

Método: GET
URL:
https://taipas.to.gov.br/wp-json/taipas/v1/despesas

Parâmetros:

Parâmetro	Descrição	Obrigatório	Tipo
acao	Valor fixo: listar	Sim	Texto
data_inicial	Data inicial do período (formato: AAAA-MM-DD)	Não	Data
data_final	Data final do período (formato: AAAA-MM-DD)	Não	Data

Exemplo de requisição:

https://taipas.to.gov.br/wp-json/taipas/v1/despesas?acao=listar&data_inicial=2024-01-01&data_final=2024-12-31

---

Observações Técnicas

• As APIs retornam dados em JSON.
• O acesso é público e gratuito.
• Sem necessidade de autenticação.
• Requisições abusivas poderão ser temporariamente bloqueadas por segurança.

---

Regras de Utilização da API

Para garantir o uso correto e a disponibilidade dos serviços de API disponibilizados pelo portal Taipas do Tocantins, as seguintes regras devem ser observadas:

• Cabeçalho Obrigatório: Toda requisição automatizada deve incluir o cabeçalho HTTP X-Taipas-API: true. Requisições sem este cabeçalho poderão ser recusadas.
• Formato dos Dados: Os dados são disponibilizados em formato JSON, aberto e estruturado para fácil integração.
• Acesso Público e Gratuito: O acesso às APIs é público e não exige autenticação ou cadastro.
• Limites de Uso: Requisições excessivas, que possam comprometer o desempenho do serviço, poderão ser temporariamente bloqueadas.
• Responsabilidade do Usuário: O usuário deve utilizar os dados conforme a legislação vigente e respeitar os direitos de terceiros.
• Suporte e Contato: Para dúvidas, sugestões ou problemas técnicos relacionados ao uso da API, entre em contato com a equipe de Tecnologia da Informação do Município através do e-mail ti@taipas.to.gov.br.

O uso das APIs implica a aceitação destas regras, que visam garantir transparência, segurança e qualidade no acesso aos dados públicos.