_Application Programmig Interface_, ou Interface de programação de Aplicativos, é um conjunto de rotinas e padrões estabelecidos por um software para utilização das suas funcionalidades por outros programas e aplicações que não têm interesse nos detalhes da sua implementação mas usufruem dos seus serviços e dados de uma forma padronizada e acessível em linguagam de máquina. Durante a fase de testes e implementação, a API do Legisdados não irá requerer nenhum tipo de autenticação para o acesso aos dados. Isso estará sujeito a mudanças em benefício da estabilidade do sistema assim que tivermos demanda sufuciente para fornecer de forma rápida e com confiabilidade os dados públicos que nos comprometermos a fornecer, com um nível excelente de confiabilidade e qualidade. A proposta do legisdados.org é ser uma fonte de dados públicos por meio de uma interface REST que aceita os verbos de leitura do protocolo HTTP e responde em XML, JSON ou texto puro de forma consistente, virtualmente tudo que há disponível de dados sobre o cotidiano político do país. Proposições h3. Consultas às proposições Uma proposição legislativa é descrita por: * identificador único (id_sileg) * descrição composta de um código alfabético de 3 letras, um número sequencial e um ano * despacho, ou ordem que acompanha a proposição * ementa * órgão propositor * apresentação que informa a data da proposição no formato "YYYY-MM-DD" O endereço votaio.com/proposicoes/<numero_da_proposicao> devolve o conteúdo da proposição e seus andamentos passados, em ordem decrescente de data. Para simples listagem e descrição de proposição, os dados estão acessíveis por: * http://legisdados.org/proposicoes/<id igual ao da camara> para retorno html ou * http://legisdados.org/proposicoes<id igual ao da camara>.xml Busca Para busca aproximada você pode contar com: * http://legisdados.org/proposicoes/busca/?q=<chave de pesquisa> para retorno html * http://legisdados.org/proposicoes/busca/[xml | rss | json]/<chave de pesquisa> para retorno formatado Os resultados de busca aproximada levam em conta a presença e repetição de termos nos seguintes campos, por ordem de importância: # autor # descrição # ementa # código Ou seja uma proposição do deputado Emilio Batista é mostrada antes de uma ocorrência tratando sobre o nome de uma rua chamada Emilio Batista. Os termos da pesquisa podem ser pesquisados com operadores de exclusão, inclusão, e associações do tipo E e OU lógicas. Por padrão, termos separados por espaços são entendidos como concatenados por operadores do tipo OU lógico. 2009-11-10T21:12:03-02:00 1 Documentação API 2009-12-01T10:55:15-02:00 Este é um projeto voluntário e tem como objetivo espelhar os dados de tramitação parlamentar no Brasil, inicialmente da câmara e senado, extensível a outras casas legislativas estaduais e municipais. Por que? Os dados públicos que permitem a sociedade acompanhar e cobrar os governantes é disponível por meio de algumas ferramentas e serviços. No entanto, não há meio de se obter acesso a estas informações de forma automatizada e indolor para desenvolvimento de aplicações para cruzamento e indexação dos dados h3. Com quem eu falo, por favor? Você pode começar a se envolver acessando as discussões do projeto em trac.meuparlamento.org h3. Quem apoia? Por enquanto, o projeto tem apoio do estudio cromática. Todo o código fonte deste site incluindo os mecanismos de raspagem (scraping) que estão sendo utilizados estão disponíveis no git hub sob licença GPLv3 Se achou interessante a iniciativa e acha que pode colaborar com a infraestrutura, entre em contato com pedro arroba estudiocromatica ponto com 2009-11-11T11:51:12-02:00 2 Legisdados Sobre o Projeto 2009-12-12T11:16:50-02:00