Página Notícia
Proposições e Eventos recebem correções em nova versão da API
Atualização tenta resolver problemas relatados por usuários; endpoints de Deputados também foram revistos
Um mês depois da atualização anterior, a versão 0.2.8 da nova API de Dados Abertos corrige mais sete problemas que haviam sido detectados – muitos deles por usuários que apresentaram questões e relatos em nossa página no GitHub – e traz mais um endpoint previsto na especificação.
O que mudou
- /proposicoes/{id}/relacionadas - Criado para retornar uma lista de informações básicas sobre as proposições acessórias relacionadas à principal, tal como pareceres, requerimentos, destaques, etc. Também são retornadas as proposições que são apensadas à principal, isto é, que passam a tramitar "de carona" – algo muito frequente entre proposições que tratam de assuntos correlatos.
- /proposicoes - O funcionamento dos parâmetros passou por revisão e a documentação sobre eles e o endpoint na página que descreve a API foi atualizada. O retorno da chamada sem parâmetros é a lista das proposições que tiveram algum tipo de tramitação nos 30 dias anteriores. Isso é uma diferença em relação à especificação original, que previa retorno das proposições que tiveram andamento nos últimos 15 dias, e é bem diferente do retorno que estava ocorrendo, de todas as proposições cadastradas. A revisão começou devido a uma reclamação do usuário João Luiz Carabetta sobre a diferença entre a documentação e o retorno real.
O intervalo de tramitação das proposições retornadas pode ser alterado pelos parâmetros dataInicio e dataFim, e mesmo quando esses parâmetros não estão presentes, o retorno é limitado por esse intervalo. Há quase 410.000 proposições cadastradas, a maioria delas já arquivada e sem tramitação, e o propósito geral da API é fornecer informações selecionadas em pequenas porções. O critério foi adotado para priorizar o retorno de proposições ainda ativas. Esperamos que os usuários analisem e nos informem se este critério é satisfatório ou se seria melhor uma alternativa (por exemplo, se houver qualquer outro parâmetro na query string, a busca não ser limitada pelo intervalo de tramitação).
- /deputados/{id}/despesas - Nesta atualização tentamos corrigir um problema um tanto misterioso relatado pelo usuário Isaías Pfaffenseller: algumas respostas em XML estavam sendo quebradas. Parecia ser um problema de caracteres inválidos no meio dos dados, mas percebemos que os mesmos registros onde ocorriam as quebras podiam ser obtidos perfeitamente por requisições ligeiramente diferentes. Gostaríamos de pedir aos usuários a ajuda na detecção e na investigação desse problema caso ele volte a ocorrer. Também foi revisto o cálculo de itens e páginas retornados, que estava em algumas situações gerando uma página last sem itens – problema relatado pelo usuário Yago Regis no GitHub issue #105, em setembro.
- /deputados/{id}/eventos - O campo uri dos itens retornados não estava trazendo o link identificador correto para cada evento. Nesta versão ainda não foi corrigido um problema já conhecido: os itens da lista retornada não receberam a mesma atualização dada ao retorno de /eventos na versão 0.2.3, com a identificação completa dos órgãos responsáveis pelos eventos, e não apenas suas siglas. Esta correção deverá ser publicada na próxima versão da API.
- /deputados/{id} e /deputados - Nosso usuário Pedro Scharth descobriu alguns deputados que eram listados pelo endpoint /deputados mas estavam causando erro 404 em /deputados/{id}. Em nossa investigação descobrimos, entre outras coisas, que a base de dados tem registros de candidatos eleitos que não chegaram a tomar posse como deputados, e isso seria a principal causa dos problemas: no modelo conceitual do Dados Abertos, são considerados "deputados" apenas os eleitos que tomaram posse e exerceram mandato parlamentar, por um minuto só que seja.
- /legislaturas/{id}, /legislaturas/{id}/mesa, /proposicoes/{id} e /proposicoes/{id}/tramitacoes - O retorno desses endpoints apresentava problemas na estrutura do elemento links, tanto em JSON quanto em XML. Todos foram revistos.
Pedimos a todos os usuários que não se acanhem em nos enviar relatos de bugs e sugestões sobre toda a API e especialmente sobre os endpoints que sofreram as alterações nesta versão. É só entrar em contato, e todas as mensagens serão muito bem vindas.