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.
URL | http://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
<?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.
URL | http://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. |