Dúvida sobre como utilizar os parâmetros do endpoint /proposicoes

[paul0vinicius]

Olá, pessoal.

Estou com dúvidas sobre como utilizar os parâmetros dataApresentacaoInicio, dataApresentacaoFim, dataInicio e dataFim. Quais as diferenças entre eles e qual o formato utilizado pelas datas? Quando eu testo com datas diferentes, o resultado parece ser o mesmo.

Atenciosamente,

[EquipeDadosAbertosCD]

Olá, Paulo!

No build da API que devemos colocar no ar ainda nesta semana, haverá novos textos descritivos do endpoint /proposicoes que deixarão isso mais claro, e todo o funcionamento desses parâmetros foi revisto. A explicação é a seguinte:

• dataApresentacaoInicio e dataApresentacaoFim estabelecem o intervalo de tempo em que devem ter sido apresentadas as proposições que se deseja obter na listagem. Não há um valor padrão.

• dataInicio e dataFim estabelecem o intervalo de tempo em que devem ter ocorrido tramitações das proposições que se deseja obter. O valor padrão de dataFim é o dia em que é feita a requisição, e o de dataInicio é de 30 dias antes.

São quase 410.000 proposições cadastradas na base de dados que usamos para este endpoint, e como o propósito da API é de entregar informações selecionadas e aos poucos, adotamos esse critério do intervalo de tramitação como forma de retornar, por padrão, as proposições que mais recentemente exibiram sinal de vida, digamos assim. O intervalo não tem limite, pelo menos por enquanto, o que permite buscar proposições que já estão paradas há muito tempo -- mas isso pode tornar a consulta consideravelmente lenta.

Espero ter esclarecido, mas se restam dúvidas, avise! Abraço!

Fabricio Rocha Equipe Dados Abertos - Câmara

[EquipeDadosAbertosCD]

Salve, Paulo!

Atualização no ar, dê uma olhada e avalie!

Abraço e obrigado!

Fabricio Rocha Equipe Dados Abertos - Câmara

[paul0vinicius]

Ola, Fabrício!

Vou dar uma olhadinha sim e dar um feedback assim que possível (:

Muito obrigado pelas informações, desde já.

Abraços.

[paul0vinicius]

@CeninCD Ih, rapaz... Parece que deu zebra nesse endpoint.

Testei aqui com a PEC 241/2016 e com a PL 1234/2016 e o resultado foi vazio para ambos os casos.

curl -X GET "https://dadosabertos.camara.leg.br/api/v2/proposicoes?siglaTipo=PEC&numero=241&ano=2016" -H "accept: application/json"

curl -X GET "https://dadosabertos.camara.leg.br/api/v2/proposicoes?siglaTipo=PL&numero=1234&ano=2016" -H "accept: application/json"

retorna:

{
  "dados": [],
  "links": [
    {
      "rel": "self",
      "href": "https://dadosabertos.camara.leg.br/api/v2/proposicoes?siglaTipo=PEC&numero=241&ano=2016"
    }
  ]
}

[EquipeDadosAbertosCD]

Olá, Paulo!

Então. É a tal mudança da busca por intervalo de tramitação. Se você tentar https://dadosabertos.camara.leg.br/api/v2/proposicoes?siglaTipo=PEC&numero=241&ano=2016&dataInicio=2016-01-01&dataFim=2017-12-31, a PEC aparece.

O PL 1234/2016 não existe... Encontrei PL 1234/2015 e 1234/2011. Seria algum desses?

Abraço!

Fabricio Rocha Equipe Dados Abertos - Câmara

[paul0vinicius]

Olá, Fabrício.

Entendi agora a mudança. Isso significa que em todas as buscas eu preciso incluir esses dois parâmetros, dataInicio e dataFim?

Essa PL eu usei o exemplo que estava na documentação, achei que ela existia.

[EquipeDadosAbertosCD]

Olá de novo, Paulo!

Não necessariamente. As proposições que estão "vivas", mais ativas, em discussão e no noticiário, provavelmente serão retornadas sem necessidade dos parâmetros, porque certamente terão tido alguma tramitação nos últimos 30 dias.

(cá com meus botões: estou achando que podemos encontrar uma solução mais intuitiva para isso)

Abraço!

Fabricio Rocha Equipe Dados Abertos - Câmara

[paul0vinicius]

Muito obrigado pelas informações!

Abraços.

[paul0vinicius]

Olá, ressuscitando esse post sobre dúvidas:

Alguma dica de como usar o campo autor? Eu tentei o campo sozinho, junto com os campos dataInicio e dataFim e em todos os casos ele retorna vazio.

(Eu coloquei o nome do autor entre aspas simples e aspas duplas).

[ftoresan]

Da mesma forma que o @paul0vinicius, não consegui fazer uma busca por autor. No meu caso tentei utilizar o campo idAutor. Deixei as datas bem abrangentes, para ter certeza que não era por este filtro que não vinham resultados.

URL: https://dadosabertos.camara.leg.br/api/v2/proposicoes?ano=2005&idAutor=178836&dataInicio=2000-01-01&dataFim=2017-12-01&dataApresentacaoInicio=2000-01-01&dataApresentacaoFim=2017-12-01

Peguei uma proposição que tem um parlamentar como autor para tentar buscá-la no /proposicoes: https://dadosabertos.camara.leg.br/api/v2/proposicoes/1999440

(já aproveito para dizer que o design tá API REST está excelente, parabéns aos envolvidos)

[EquipeDadosAbertosCD]

Obrigado pelo elogio, xará! :D

Criei a issue #130 para tratarmos dessa questão da busca por autor. O problema foi confirmado e temos uma suspeita sobre a causa. Vamos continuar o assunto lá.

Abraços! Fabricio Rocha Equipe Dados Abertos - Câmara