Cómo el acervo del portal puede ser leído por personas y por sistemas: formatos disponibles, licencia de uso y el diccionario de datos del conjunto.
Además de las páginas de este portal, el acervo se publica en formatos abiertos y legibles por máquina, sin exigir registro, identificación ni motivo — en cumplimiento del art. 8, §3, incisos II y III, de la Ley brasileña de Acceso a la Información (12.527/2011). Cualquier sistema externo puede consumir las direcciones de abajo.
El conjunto completo en JSON, paginado (hasta 500 registros por página), con los mismos filtros de la búsqueda del portal (q, categoria, exercicio). El contrato es estable: la estructura no cambia cuando las páginas del portal evolucionan.
https://api.santacasamartinopolis.org/v1/institucional/transparencia/dados-abertosEl acervo como planilla abierta y no propietaria (separador ";", codificación UTF-8), lista para cualquier editor de planillas. Los recortes con más de 5000 líneas se entregan truncados — para el conjunto completo, use los datos abiertos paginados.
https://api.santacasamartinopolis.org/v1/institucional/transparencia/documentos.csvCampos de cada documento en el conjunto de datos abiertos (JSON).
| Campo | Tipo | Descripción |
|---|---|---|
slug | texto | Identificador público y estable del documento. Compone la dirección de la ficha y del archivo — corregir el título no lo altera. |
titulo | texto | Título del documento. |
descricao | texto o nulo | Resumen del contenido, cuando se informa. |
categoria | objeto | Categoría del documento: slug, nombre, base legal que atiende y periodicidad esperada de actualización. |
exercicio | número entero o nulo | Año de ejercicio al que se refiere el documento. |
periodoReferencia | texto o nulo | Período de referencia dentro del ejercicio (ej.: 1er trimestre). |
dataDocumento | fecha (AAAA-MM-DD) o nulo | Fecha del propio documento, sin huso horario. |
publicadoEm | fecha y hora (ISO 8601, UTC) o nulo | Momento en que el documento entró en línea en el portal. |
atualizadoConteudoEm | fecha y hora (ISO 8601, UTC) o nulo | Último cambio de contenido: publicación o sustitución del archivo. Las correcciones de metadatos no lo alteran. |
tarjadoEm | fecha y hora (ISO 8601, UTC) o nulo | Momento en que parte del contenido del archivo fue ocultada para proteger información personal. Nulo cuando nunca hubo ocultación. La ocultación cambia el código de integridad (SHA-256) del archivo. |
caminhoPasta | texto o nulo | Ruta de la carpeta donde el documento está archivado dentro de la categoría, con los niveles separados por barra. Nulo cuando el documento está suelto en la raíz de la categoría. |
arquivo | objeto o nulo | Metadatos del archivo: nombre original, tipo (MIME), tamaño en bytes y código de integridad SHA-256. |
arquivoUrl | texto o nulo | Ruta relativa del archivo en la API del portal. Concaténela con la dirección base de la API para descargarlo. |
En la planilla CSV, las columnas equivalentes son: titulo, categoria, base_legal, periodicidade, exercicio, periodo_referencia, data_documento, publicado_em, atualizado_em, arquivo_url, arquivo_bytes, checksum_sha256, tarjado_em, caminho_pasta.