Como o acervo do portal pode ser lido por pessoas e por sistemas: formatos disponíveis, licença de uso e o dicionário de dados do conjunto.
Além das páginas deste portal, o acervo é publicado em formatos abertos e legíveis por máquina, sem exigir cadastro, identificação nem motivação — em cumprimento ao art. 8º, §3º, incisos II e III, da Lei de Acesso à Informação (12.527/2011). Qualquer sistema externo pode consumir os endereços abaixo.
O conjunto completo em JSON, paginado (até 500 registros por página), com os mesmos filtros da busca do portal (q, categoria, exercicio). O contrato é estável: a estrutura não muda quando as telas do portal evoluem.
https://api.santacasamartinopolis.org/v1/institucional/transparencia/dados-abertosO acervo em planilha aberta e não proprietária (separador ";", codificação UTF-8), pronta para qualquer editor de planilhas. Recortes acima de 5000 linhas são entregues truncados — para o conjunto completo, use os dados abertos paginados.
https://api.santacasamartinopolis.org/v1/institucional/transparencia/documentos.csvCampos de cada documento no conjunto de dados abertos (JSON).
| Campo | Tipo | Descrição |
|---|---|---|
slug | texto | Identificador público e estável do documento. Compõe o endereço da ficha e do arquivo — corrigir o título não o altera. |
titulo | texto | Título do documento. |
descricao | texto ou nulo | Resumo do conteúdo, quando informado. |
categoria | objeto | Categoria do documento: slug, nome, base legal que ela atende e periodicidade esperada de atualização. |
exercicio | número inteiro ou nulo | Ano de exercício a que o documento se refere. |
periodoReferencia | texto ou nulo | Período de referência dentro do exercício (ex.: 1º trimestre). |
dataDocumento | data (AAAA-MM-DD) ou nulo | Data do próprio documento, sem fuso horário. |
publicadoEm | data e hora (ISO 8601, UTC) ou nulo | Momento em que o documento entrou no ar no portal. |
atualizadoConteudoEm | data e hora (ISO 8601, UTC) ou nulo | Última alteração de conteúdo: publicação ou troca do arquivo. Correção de metadado não o altera. |
arquivo | objeto ou nulo | Metadados do arquivo: nome original, tipo (MIME), tamanho em bytes e código de integridade SHA-256. |
arquivoUrl | texto ou nulo | Caminho relativo do arquivo na API do portal. Concatene com o endereço base da API para baixá-lo. |
Na planilha CSV, as colunas equivalentes são: titulo, categoria, base_legal, periodicidade, exercicio, periodo_referencia, data_documento, publicado_em, atualizado_em, arquivo_url, arquivo_bytes, checksum_sha256.