Sobre o sistema...

O Sistema de Webservices da ALMG, cuja sigla é ws, é composto por um conjunto de recursos web cujos acessos tentam, sempre que possível, atender aos ideais e ao conjunto de melhores práticas REST.

Outra forma de definir o ws seria como uma API REST. Possui uma API que retorna diversos tipos de POX através do HTTP.

Contudo, alguns aspectos desta API não são muito RESTful:

Deve-se evitar a codificação de letras acentuadas e sinais. Lembre-se que ao usar webservices através de programas, a URL deve ser codificada para evitar caracteres proibidos. Veja mais sobre codificação na especificação HTML 4.

Nos textos montados no XML, adotamos as seguintes tabelas de "escape".

Tabela com os "escapes"
Original Versão Escape Descrição
< &lt; menor que
> &gt; maior que
& &amp; ampersand 
' &apos; apostrófo
" &quot; aspas

Veja a seguir as páginas com explicações sobre cada recurso. Ao clicar em uma ajuda específica, a respectiva página é montada com exemplos reais que refletem a base no momento da consulta. Assim, o resultado pode demorar e/ou alguns exemplos podem não exibir seus resultados.

Tabela com os webservices
Recurso Versão Descrição URL
Agenda Institucional 1.6 Este conjunto de webservices cuida dos itens de agenda institucional.

Os itens de agenda são:

  • Atividade de Ensino
  • Audiência Pública
  • Debate Público
  • Evento Institucional
  • Reunião de Comissão
  • Reunião de Plenário
  • Reunião Preparatória de Evento Institucional
  • Visita de Comissão
  • Visita Orientada

Outros tipos de itens de agenda devem ser cadastrados em sistema próprio da ALMG.

http://dadosabertos.almg.gov.br/ws/agenda/ajuda
Comissões 2.0 Este conjunto de webservices retorna listas de comissões e participações de Deputados em comissões.

http://dadosabertos.almg.gov.br/ws/comissoes/ajuda
Contratos 1.1 Este conjunto de webservices implementa a consulta à lista de pessoas físicas e jurídicas com contratos ou convênios vigentes firmados pela ALMG. http://dadosabertos.almg.gov.br/ws/prestacao_contas/contratos/ajuda
Deputados 1.4 Este conjunto de webservices retorna listas de Deputados da legislatura atual. Também retorna listas de pronunciamentos e proposições de autoria de Deputados. http://dadosabertos.almg.gov.br/ws/deputados/ajuda
Legislaturas 1.0 Este conjunto de webservices retorna listas de Deputados que exerceram mandato, seus pronunciamentos e proposições, comissões e participações de Deputados em comissões de legislaturas passadas.

Uma legislatura é o período de tempo em que um mandato parlamentar é exercido.

http://dadosabertos.almg.gov.br/ws/legislaturas/ajuda
Legislação 1.2 Este conjunto de webservices implementa consultas às bases de legislação da ALMG.

Além da legislação mineira em sua totalidade desde 1947, permite pesquisa em artigos atualizados de certas normas específicas: Código de Saúde, Constituição Estadual, Estatuto do Servidor e Regimento Interno. Também permite consulta aos artigos atualizados da Constituição Federal.

http://dadosabertos.almg.gov.br/ws/legislacao/ajuda
Localidades Brasileiras 1.0 Este conjunto de webservices implementa consultas às localidades brasileiras e unidades da federação. http://dadosabertos.almg.gov.br/ws/brasil/localidades/ajuda
Mídias 1.3 Este conjunto de webservices fornece listas de URLs e metadados sobre o acervo de mídias indexadas da Assembleia.

Uma mídia pode ser uma imagem, vídeo, som, pdf ou qualquer outro tipo de mídia que tenha um mime type cadastrado no sistema de indexação multimídia.

A indexação de uma mídia é realizada usando tags de localização e de conteúdo conforme o webservice de tags.

Uma mídia pode ter visões, que são outras mídias que têm a mesma indexação, mas são de outro tipo ou resolução.

http://dadosabertos.almg.gov.br/ws/midias/ajuda
Plenário 1.2 Este conjunto de webservices retorna informações sobre as reuniões de Plenário. http://dadosabertos.almg.gov.br/ws/plenario/ajuda
Pronunciamentos 1.1 Este conjunto de webservices retorna pronunciamentos de Deputados e outras autoridades, incluindo apartes em pronunciamentos de outros Deputados. http://dadosabertos.almg.gov.br/ws/pronunciamentos/ajuda
Proposições 1.1 Este conjunto de webservices implementa pesquisa às proposições (também chamadas de matérias) em tramitação na ALMG.

Pesquisa informações sobre todas as proposições que estão tramitando ou que foram apreciadas pela Assembleia Legislativa de Minas Gerais desde 1959.

http://dadosabertos.almg.gov.br/ws/proposicoes/ajuda
Representação Partidária 1.0 Este conjunto de webservices retorna listas de partidos, blocos e lideranças da legislatura atual. http://dadosabertos.almg.gov.br/ws/representacao_partidaria/ajuda
Tags 1.1 Este conjunto de webservices fornece listas de tags de indexação.

Uma tag pode ser de conteúdo ou uma tag de localização, querendo dizer que representa uma seção do Portal.

Uma tag pode ser assinável para boletim, indicando que pode ser escolhida por um usuário que deseja receber boletins de notícias indexadas com esta tag.

Da mesma forma, uma tag pode ser assinável para RSS.

Tags podem ser hierarquizadas em dois níveis. Isso quer dizer que uma tag pode ter uma ou nenhuma tag pai, mas nunca vai ter uma tag avô.

Tags sem pai são ditas serem tags de primeiro nível.

http://dadosabertos.almg.gov.br/ws/indexacao/tags/ajuda
Verbas Indenizatórias 1.1 Este webservice permite consultar o extrato das despesas de verba indenizatória de Deputado.

Todo Deputado faz jus a uma verba indenizatória por despesas realizadas, mediante requerimento e comprovação com notas fiscais ou documentos equivalentes, até o limite mensal de R$ 20 mil.

Um Deputado possui uma lista de datas para as quais foram gerados relatórios mensais de verbas indenizatórias. Em uma data, podem ocorrer diversos itens de despesa.

http://dadosabertos.almg.gov.br/ws/prestacao_contas/verbas_indenizatorias/ajuda

Hoje em dia, a maioria das APIs "REST" não são totalmente RESTful, que é justamente o caso do ws.

Envie suas sugestões e críticas.