Tags

Versão: 1.1

Apresentamos as principais características do webservice Tags, componente do sistema de webservices da ALMG, cuja sigla é ws.

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.

Recursos

Os recursos que podem ser acessados são listados a seguir.

Nome Versão
Pesquisa Direcionada de Tags 1.1
Ajuda 1.0

Quando o XML de resposta do recurso é maior que 20000 (vinte mil) caracteres, ele é truncado para 10000 (dez mil) caracteres para não tornar este documento muito extenso.

Pesquisa Direcionada de Tags

Versão: 1.1

Permite a pesquisa direcionada de tags de indexação por vários parâmetros. Os parâmetros 'semPai' e 'pai' não podem ser fornecidos na mesma pesquisa.

URLhttp://dadosabertos.almg.gov.br/ws/indexacao/tags/pesquisa
Método GET
Tipos de Consumo N.I.
Tipos de Retorno application/xml
Resultados 200 OK & XML

Parâmetros

Nome Descrição Tipo Valor Default
?tipo= Identificdador do tipo da tag. Integer N.I.
?assinaBol= Assinável para boletim. Boolean N.I.
?assinaRss= Assinável para RSS. Boolean N.I.
?semPai= Somente tags de primeiro nível (sem tag pai). Boolean false
?pai= Identificador da tag pai. Integer N.I.
?mostraPai= Mostra tag pai no resultado. Boolean false
?mostraHier= Mostra estrutura hierárquica Boolean false

Headers

Nome Descrição Tipo Valor Default
Sem headers.

Exemplos

Pesquisa tags filhas da tag 249
GET http://dadosabertos.almg.gov.br/ws/indexacao/tags/pesquisa?pai=249

<?xml version="1.0" encoding="UTF-8"?> <listaTagIndexacao xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <tag> <id>250</id> <tipo> <id>1</id> <nome>Conteúdo</nome> </tipo> <descricao>Ensino público estadual</descricao> <assinaturaBoletim>N</assinaturaBoletim> <assinaturaRss>N</assinaturaRss> <assinalavel>N</assinalavel> </tag> <tag> <id>251</id> <tipo> <id>1</id> <nome>Conteúdo</nome> </tipo> <descricao>Magistério</descricao> <assinaturaBoletim>N</assinaturaBoletim> <assinaturaRss>N</assinaturaRss> <assinalavel>N</assinalavel> </tag> <tag> <id>252</id> <tipo> <id>1</id> <nome>Conteúdo</nome> </tipo> <descricao>Política educacional</descricao> <assinaturaBoletim>N</assinaturaBoletim> <assinaturaRss>N</assinaturaRss> <assinalavel>N</assinalavel> </tag> </listaTagIndexacao>

Ajuda

Versão: 1.0

Retorna ajuda.

URLhttp://dadosabertos.almg.gov.br/ws/indexacao/tags/ajuda
Método GET
Tipos de Consumo N.I.
Tipos de Retorno text/html
Resultados 200 OK & HTML

Parâmetros

Nome Descrição Tipo Valor Default
Sem parâmetros.

Headers

Nome Descrição Tipo Valor Default
Sem headers.

Exemplos

Sem exemplos.