Skip to main content
O Departamento Administrativo de la Función Pública mantém o Gestor Normativo: 40.000 normas que regem a administração pública colombiana, de uma ordenança de 1620 à circular desta semana. Não é um diário oficial nem uma relatoria. É onde uma norma é publicada com seu aparato editorial: os temas sob os quais está classificada, as normas posteriores que o gestor registra como adições, modificações ou revogações, e o texto consolidado. Leis, decretos, atos legislativos, sentenças do Consejo de Estado e os milhares de conceptos com que a Función Pública responde como as regras se aplicam estão no mesmo registro, e ambos os endpoints percorrem todos de uma vez.

​
Buscar no gestor

POST /co/funcion-publica/norms-search/v1 Uma única busca sobre o texto completo de todas as normas do gestor, algo que o site do Gestor Normativo não oferece: pagina de dez em dez e para em dez mil resultados.
A fonte inteira, organizada e pronta para consultar: este endpoint responde em milissegundos, a qualquer hora e sempre igual. Cada resposta traz as_of: o quão atuais são os dados.
Retorna as_of (o quão atuais são os dados), os filtros aplicados, total (correspondências em todas as páginas), page, per_page, total_pages, count e results[], da mais recente à mais antiga. Cada resultado traz id, title (como a norma é citada), document_type e document_type_key, number e number_key (o mesmo número sem zeros à esquerda), year (o ano na designação da norma), entity e entity_key (quem a expediu), summary (a descrição de uma linha que o gestor publica), issued_at, effective_at, published_in, subjects[] e topics[] (do que trata, segundo a classificação do gestor), amendments[] (normas posteriores que o gestor registra como adições, modificações ou revogações desta, cada uma com seu norm_id para consultá-la), official_url e document_url.
Os resultados da busca não incluem o texto da norma: uma única norma pode ter centenas de milhares de caracteres. query busca dentro dele, então uma frase que aparece em um artigo encontra a norma; para ler o texto use o endpoint Función Pública Norm.

​
Uma norma, completa

POST /co/funcion-publica/norm/v1
A fonte inteira, organizada e pronta para consultar: este endpoint responde em milissegundos, a qualquer hora e sempre igual. Cada resposta traz as_of: o quão atuais são os dados.
Retorna as_of, found, norm_id e norm, que traz tudo o que a busca retorna mais content: uma janela sobre o texto da norma, com text, offset, total_length, has_more e next_offset. Cada resultado traz id, title (como a norma é citada), document_type e document_type_key, number e number_key (o mesmo número sem zeros à esquerda), year (o ano na designação da norma), entity e entity_key (quem a expediu), summary (a descrição de uma linha que o gestor publica), issued_at, effective_at, published_in, subjects[] e topics[] (do que trata, segundo a classificação do gestor), amendments[] (normas posteriores que o gestor registra como adições, modificações ou revogações desta, cada uma com seu norm_id para consultá-la), official_url e document_url.
As normas mais longas do gestor passam de um milhão de caracteres, então o texto é lido por intervalos: envie offset e limit, depois passe o next_offset da resposta como offset até que has_more seja falso. content é null nas poucas normas que o gestor publica sem corpo, e nas normas cujo texto ele não entrega, que são raras nos anos recentes e mais frequentes quanto mais antiga é a norma.
Um id que o gestor não contém retorna found: false com HTTP 200, não um erro. Isso inclui um id para o qual o amendments[] de outra norma aponta: o gestor às vezes cita uma norma que já não publica.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.