Verbetes

Verbetes

Verbetes é um serviço que responde a pedidos "WhoIs" para personalidades da vida pública.

Subscrição gratuita

Descrição Técnica

Serviço Verbetes

Verbetes é um serviço que responde a pedidos "WhoIs" para personalidades da vida pública. Toda a informação contida no Verbetes é recolhida automaticamente a partir de fontes noticiosas, sendo a actualização feita a todas as horas (com a entrada de novas notícias). O Verbetes permite também responder a pedidos "WhoIs" para profissões/cargos de personalidades da vida pública.

Manual de Referência da API

Serviço Operação Descrição
Verbetes GetCoOccurrences Este método retorna uma estrutura JSON com a rede de pessoas com que uma dada personalidade co-ocorreu ao longo de um dado intervalo de tempo. Neste exemplo pretendemos saber com que pessoas Vítor Pereira co-ocorreu nas mesmas notícias ao longo do mês de Setembro.
GetCoOccurrencesTrends Este método retorna uma estrutura JSON com uma contagem do número de vezes que duas personalidades co-ocorrem na mesma notícia para um dado intervalo de tempo. Neste exemplo pretende-se determinar o número de vezes que Alberto João Jardim e Pedro Passos Coelho co-ocorreram nas mesmas notícias durante o mês de Setembro.
GetEgoNet Este método retorna uma estrutura JSON com a rede ego-cêntrica de Pedro Passos Coelho entre os dias 11/Abril e 20/Abril, com profundidade 1.5 (pode ser 1 ou 1.5) e com frequência mínima nas ligações de 5. Esta rede é obtida com base nas menções desta pessoa em notícias portuguesas publicadas online.
GetErgos Retorna uma lista, em formato JSON, com todas profissões/cargos (com 5 ou mais ocorrências).
GetGlobalNet Este método retorna uma estrutura JSON com a rede global de pessoas mencionadas nas notícias entre os dias 28/Out e 03/Nov, com 5 nós. Esta rede é obtida com base nas menções desta pessoa em notícias portuguesas publicadas online.
GetOccurrencesTrends Este método retorna uma estrutura JSON com as tendências do número de ocorrências de um dado nome para um dado intervalo temporal, com granularidade de 1 dia.
GetPersonalities Retorna uma lista, em formato JSON, com todas as personalidades com 2 ou mais verbetes associados
WhoIs retorna uma estrutura JSON com todos os verbetes existentes para a personalidade "sócrates"
WhoIsLight Este método é uma versão light do WhoIs. Retorna o descritor mais frequente para um dado nome (nome completo), e assume como parâmetros default a margem - 120 dias - e a frequência mínima do descritor - 2.

Serviço Verbetes

Operações

GetCoOccurrences

Este método retorna uma estrutura JSON com a rede de pessoas com que uma dada personalidade co-ocorreu ao longo de um dado intervalo de tempo. Neste exemplo pretendemos saber com que pessoas Vítor Pereira co-ocorreu nas mesmas notícias ao longo do mês de Setembro.
Exemplos
Voltar ao topo

GetCoOccurrencesTrends

Este método retorna uma estrutura JSON com uma contagem do número de vezes que duas personalidades co-ocorrem na mesma notícia para um dado intervalo de tempo. Neste exemplo pretende-se determinar o número de vezes que Alberto João Jardim e Pedro Passos Coelho co-ocorreram nas mesmas notícias durante o mês de Setembro.
Exemplos
Voltar ao topo

GetEgoNet

Este método retorna uma estrutura JSON com a rede ego-cêntrica de Pedro Passos Coelho entre os dias 11/Abril e 20/Abril, com profundidade 1.5 (pode ser 1 ou 1.5) e com frequência mínima nas ligações de 5. Esta rede é obtida com base nas menções desta pessoa em notícias portuguesas publicadas online.
Exemplos
Voltar ao topo

GetErgos

Retorna uma lista, em formato JSON, com todas profissões/cargos (com 5 ou mais ocorrências).
Exemplos
Voltar ao topo

GetGlobalNet

Este método retorna uma estrutura JSON com a rede global de pessoas mencionadas nas notícias entre os dias 28/Out e 03/Nov, com 5 nós. Esta rede é obtida com base nas menções desta pessoa em notícias portuguesas publicadas online.
Exemplos
Voltar ao topo

GetOccurrencesTrends

Este método retorna uma estrutura JSON com as tendências do número de ocorrências de um dado nome para um dado intervalo temporal, com granularidade de 1 dia.
Exemplos
Voltar ao topo

GetPersonalities

Retorna uma lista, em formato JSON, com todas as personalidades com 2 ou mais verbetes associados
Exemplos
Voltar ao topo

WhoIs

retorna uma estrutura JSON com todos os verbetes existentes para a personalidade "sócrates"
Exemplos
Voltar ao topo

WhoIsLight

Este método é uma versão light do WhoIs. Retorna o descritor mais frequente para um dado nome (nome completo), e assume como parâmetros default a margem - 120 dias - e a frequência mínima do descritor - 2.
Exemplos
Voltar ao topo

Autenticação da API REST

Autenticação de um pedido REST

Cada pedido deverá conter informação de autenticação para estabelecer a identidade de quem fez o pedido e o token de autorização chamado ESB AccessKey (chave de acesso).

ESB Access Key

A autorização do uso da API é efectuada através da chave de acesso (ESB Access Key) que é disponibilizada no final do processo de compra do produto. Poderá gerar uma ESB Access Key para utilização da API nos detalhes do producto disponível na sua área de cliente.

O elemento ESBAccessKey deverá estar presente no URL como query-string

Exemplo HTTP GET usando nome do utilizador e palavra-chave:

Exemplo HTTP POST usando nome do utilizador e palavra-chave:

Request with ESBToken

Using a token instead of your username and password can be useful if you don't want to give your credentials to whom is using the API.

In order to generate a ESB Token you must use SAPO Security Token Service. You can generate a revocable token or a temporary token valid for 12 hours.

Exemplo HTTP GET usando um ESB Token:

Exemplo HTTP POST usando um ESB Token:

Descrição dos parâmetros:

ESBCredentials são parâmetros usados para autenticar e autorizar o pedido REST.

Elemento Descrição
ESBUsername O email da conta usada para para acederà API.
ESBPassword A palavra-passe que corresponde à conta de email especificada em ESBUsername.
ESBToken O token de acesso que representa as credenciais (ESBUsername + ESBPassword) usadas para comprar o uso da API.
ESBAccessKey O token que vai autorizar o pedido. A conta utilizada deve estar associada a este token.
Voltar ao topo