CamaraDosDeputados / dados-abertos

Repositório do serviço de Dados Abertos da Câmara. Consulte as "Issues" para atendimento a dúvidas e sugestões.
http://dadosabertos.camara.leg.br
197 stars 13 forks source link

Inteiro Teor - Proposição #94

Open jcoliv opened 7 years ago

jcoliv commented 7 years ago

Olá, Boa tarde.

Gostaria que vocês me ajudassem a entender a mecânica para visualizar o inteiro teor das proposições. Pois não estou encontrando paridade entre ID proposição e inteiro teor. Veja o exemplo abaixo: http://www.camara.gov.br/proposicoesWeb/fichadetramitacao?idProposicao=321350 (veja que informo o ID: 321350 da proposição. Quando clico no link "Inteiro teor" , ao lado do número do PL, Ex: PL 6930/2006 ---> Inteiro teor <----- Projeto de Lei , este me enviar para um link: http://www.camara.gov.br/proposicoesWeb/prop_mostrarintegra?codteor=389272&filename=PL+6930/2006 . Gostaria de saber o que é este "389272" que esta no link e onde eu o encontro para associar ao ID da proposição que é: "321350" Grande Abraço e no aguardo.

EquipeDadosAbertosCD commented 7 years ago

Salve, José Carlos!

É bastante contra-indicado o uso de "URL parsing" ou "adivinhação de ID" em qualquer API RESTful -- vide o "axioma da opacidade" de Tim Berners-Lee:

When you are not dereferencing, you should not look at the contents of the URI string to gain other information.

Isso é especialmente perigoso se for feito entre dois sistemas relativamente independentes, como são o Dados Abertos e o Portal da Câmara. Alguns identificadores são evidentemente os mesmos -- mas no momento e não necessariamente. É possível que a qualquer momento o dados Abertos passe a usar outros identificadores, e isso pode quebrar a sua aplicação se ela fizer algum tipo de extração de identificadores nas strings de URL!

A especificação do Dados Abertos define o campo urlInteiroTeor" no retorno a uma requisição ao _endpoint_/proposicoes/{id}`, e a URL retornada como valor desse elemento é que deve ser usada ("opacamente") para obter a cópia do documento como protocolizado na Câmara.

Aí sim vamos ao mea culpa: devido a um bug, o campo está sendo retornado vazio. Vamos tentar corrigir isso o mais rapidamente possível para que não seja preciso fazer qualquer tipo de mágica dos identificadores! :)

Obrigado pela mensagem e grande abraço!

Fabricio Rocha Equipe Dados Abertos - Câmara