EPG do MEO

EPG do MEO

EPG dos canais IPTV do MEO.

Subscrição gratuita

Descrição Técnica

Serviço EPG

Disponibiliza a programação para diversos canais da oferta MEO.

Manual de Referência da API

Serviço Operação Descrição
EPG GetChannelByDateInterval Aceita a sigla de um canal e duas datas em texto no formato yyyy-mm-dd hh:mm:ss e devolve a lista de programas para aquele canal e naquele período de tempo
GetChannelDetail Aceita a sigla de um canal e devolve todo o detalhe sobre o mesmo.
GetChannelList Devolve a lista de canais da oferta de determinado(s) fornecedor(es)
GetChannelListByDateInterval Aceita uma lista de siglas de canais separadas por vírgulas e duas datas em texto n o formato yyyy-mm-dd hh:mm:ss e devolve uma lista de programas de canais para aquele período de tempo.
GetChannelListOrderByName Devolve a lista de canais da oferta de determinado(s) fornecedor(es) ordenada pelo nome dos canais.
GetProgramById Aceita um identificador de um programa (id) e devolve todos os detalhes sobre esse programa.
GetProgramListByChannelDateInterval Aceita a sigla de um canal e duas em datas em texto no formato yyyy-mm-dd hh:mm:ss e devolve todos os detalhes sobre os programas daquele período.

Serviço EPG

Operações

GetChannelByDateInterval

Aceita a sigla de um canal e duas datas em texto no formato yyyy-mm-dd hh:mm:ss e devolve a lista de programas para aquele canal e naquele período de tempo
Parâmetros do pedido
channelSigla : string (opcional)
O identificador do canal.
startDate : string (opcional)
A data e hora inicial pela qual será filtrada a lista de programas.
endDate : string (opcional)
A data e hora final pela qual será filtrada a lista de programas.
Parâmetros de resposta
GetChannelByDateIntervalResult : Channel (opcional)

Nesta operação, o tipo Channel é composto pelos seguintes elementos:

Name : string (obrigatório)
Sigla : string (obrigatório)
Type : string (opcional)
Providers : ArrayOfProvider (obrigatório)
Programs : ArrayOfProgram (obrigatório)
Exemplos

Exemplo SOAP

O seguinte exemplo apresenta como obter a programação para um dado canal num intervalo de tempo. E, a resposta correspondente de um pedido bem sucedido:

Exemplo HTTP GET

O seguinte exemplo apresenta como obter a programação para um dado canal num intervalo de tempo. E, a resposta correspondente de um pedido bem sucedido:
Voltar ao topo

GetChannelDetail

Aceita a sigla de um canal e devolve todo o detalhe sobre o mesmo.
Parâmetros do pedido
channelSigla : string (opcional)
O identificador do canal.
Parâmetros de resposta
GetChannelDetailResult : Channel (opcional)

Nesta operação o tipo Channel  é composto pelos seguintes elementos:

Name : string (obrigatório)
Sigla : string (obrigatório)
Type : string (opcional)
Providers : ArrayOfProvider (obrigatório)
Programs : ArrayOfProgram (obrigatório)
Exemplos

Exemplo SOAP

O seguinte exemplo apresenta como obter os detalhes de um canal. E, a resposta correspondente de um pedido bem sucedido:

Exemplo HTTP GET

O seguinte exemplo apresenta como obter os detalhes de um canal. E, a resposta correspondente de um pedido bem sucedido:
Voltar ao topo

GetChannelList

Devolve a lista de canais da oferta de determinado(s) fornecedor(es)
Parâmetros de resposta
GetChannelListResult : ArrayOfChannel (opcional)

Uma lista de Channels.

Nesta operação o tipo Channel  é composto pelos seguintes elementos:

Name : string (required)
Sigla : string (required)
Type : string (optional)
Providers : ArrayOfProvider (required)
Programs : ArrayOfProgram (required)
Exemplos

Exemplo SOAP

O seguinte exemplo apresenta como obter uma lista de canais MEO. E, a resposta correspondente de um pedido bem sucedido:

Exemplo HTTP GET

O seguinte exemplo apresenta como obter uma lista de canais MEO. E, a resposta correspondente de um pedido bem sucedido:
Voltar ao topo

GetChannelListByDateInterval

Aceita uma lista de siglas de canais separadas por vírgulas e duas datas em texto n o formato yyyy-mm-dd hh:mm:ss e devolve uma lista de programas de canais para aquele período de tempo.
Parâmetros do pedido
channelSiglas : string (opcional)
Uma lista separada por vírgulas de identificadores de canais (siglas).
startDate : string (opcional)
A data e hora inicial pela qual será filtrada a lista de programas.
endDate : string (opcional)
A data e hora final pela qual será filtrada a lista de programas.
Parâmetros de resposta
GetChannelListByDateIntervalResult : ArrayOfChannel (opcional)

Uma lista de Channels.

Nesta operação o tipo Channel  é composto pelos seguintes elementos:

Name : string (required)
Sigla : string (required)
Type : string (optional)
Providers : ArrayOfProvider (required)
Programs : ArrayOfProgram (required)
Exemplos

Exemplo SOAP

O seguinte exemplo demonstra como obter o guia de programação digital para uma lista de identificadores de canais e um intervalo temporal. E, a resposta correspondente de um pedido bem sucedido:

Exemplo HTTP GET

O seguinte exemplo demonstra como obter o guia de programação digital para uma lista de identificadores de canais e um intervalo temporal. E, a resposta correspondente de um pedido bem sucedido:
Voltar ao topo

GetChannelListOrderByName

Devolve a lista de canais da oferta de determinado(s) fornecedor(es) ordenada pelo nome dos canais.
Parâmetros de resposta
GetChannelListOrderByNameResult : ArrayOfChannel (opcional)

Uma lista de Channels.

Nesta operação o tipo Channel  é composto pelos seguintes elementos:

Name : string (required)
Sigla : string (required)
Type : string (optional)
Providers : ArrayOfProvider (required)
Programs : ArrayOfProgram (required)
Exemplos

Exemplo SOAP

O seguinte exemplo apresenta como obter uma lista de canais MEO ordenada por nome. E, a resposta correspondente de um pedido bem sucedido:

Exemplo HTTP GET

O seguinte exemplo apresenta como obter uma lista de canais MEO ordenada por nome. E, a resposta correspondente de um pedido bem sucedido:
Voltar ao topo

GetProgramById

Aceita um identificador de um programa (id) e devolve todos os detalhes sobre esse programa.
Parâmetros do pedido
programId : int (opcional)
O identificador do programa. Pode obter este valor através de qualquer operação que forneça informação de um canal com os programas correspondentes.
Parâmetros de resposta
GetProgramByIdResult : Program (opcional)
Exemplos

Exemplo SOAP

O seguinte exemplo apresenta como obter os detalhes de um determinado programa. E, a resposta correspondente de um pedido bem sucedido:

Exemplo HTTP GET

O seguinte exemplo apresenta como obter os detalhes de um determinado programa. E, a resposta correspondente de um pedido bem sucedido:
Voltar ao topo

GetProgramListByChannelDateInterval

Aceita a sigla de um canal e duas em datas em texto no formato yyyy-mm-dd hh:mm:ss e devolve todos os detalhes sobre os programas daquele período.
Parâmetros do pedido
channelSigla : string (opcional)
O identificador do canal (sigla).
startDate : string (opcional)
A data e hora inicial pela qual será filtrada a lista de programas.
endDate : string (opcional)
A data e hora final pela qual será filtrada a lista de programas.
Parâmetros de resposta
GetProgramListByChannelDateIntervalResult : ArrayOfProgram (opcional)

Uma lista de Programs.

Voltar ao topo

EPG Entidades

ArrayOfChannel

Nome do atributo Descrição
Lista de Channel : Channel (opcional)
Voltar ao topo

ArrayOfFlag

Nome do atributo Descrição
Lista de Flag : Flag (opcional)
Voltar ao topo

ArrayOfProgram

Nome do atributo Descrição
Lista de Program : Program (opcional)
Voltar ao topo

ArrayOfProvider

Nome do atributo Descrição
Lista de Provider : Provider (opcional)
Voltar ao topo

ArrayOfValue

Nome do atributo Descrição
Lista de Value : Value (opcional)
Voltar ao topo

Channel

Nome do atributo Descrição
Name : string (opcional)
Sigla : string (opcional)
Type : string (opcional)
Providers : ArrayOfProvider (opcional)
Programs : ArrayOfProgram (opcional)
Genre : string (opcional)
Description : string (opcional)
TunerPosition : int (opcional)
IsHD : boolean (opcional)
CanonicalName : string (opcional)
PresentationId : string (opcional)
ProductId : string (opcional)
Image : string (opcional)
Voltar ao topo

Flag

Nome do atributo Descrição
Id : int (opcional)
Name : string (opcional)
PName : string (opcional)
Description : string (opcional)
Language : string (opcional)
Voltar ao topo

Program

Nome do atributo Descrição
Id : int (opcional)
Title : string (opcional)
Description : string (opcional)
Category : string (opcional)
Culture : string (opcional)
Actor : string (opcional)
Director : string (opcional)
ExecutiveProducer : string (opcional)
GuestStar : string (opcional)
Producer : string (opcional)
Writer : string (opcional)
StartTime : string (opcional)
Duration : int (opcional)
ChannelName : string (opcional)
ChannelSigla : string (opcional)
EndTime : string (opcional)
EpisodeTitle : string (opcional)
ShortDescription : string (opcional)
Flags : ArrayOfFlag (opcional)
Values : ArrayOfValue (opcional)
Voltar ao topo

Provider

Nome do atributo Descrição
Name : string (opcional)
Voltar ao topo

Value

Nome do atributo Descrição
Id : int (opcional)
Name : string (opcional)
PName : string (opcional)
Description : string (opcional)
Language : string (opcional)
ValueOf : string (opcional) O valor do ProgramValue.
Voltar ao topo

Autenticação da API SOAP

Autenticação de um pedido SOAP

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

Inserir caminho para obter a chave de acesso.

A autorização do uso da API é efectuada através da chave de acesso (ESBAccessKey) que é disponibilizada no final do processo de compra do produto.

Na sua área de cliente encontrará nos detalhes do produto a geração de chaves de acesso que podem ser geradas para si, para outros utilizadores da API registados no SAPO Services ou então por qualquer utilizador.

O elemento "ESBAccessKey" deverá aparecer num SOAP Header da mensagem após o SOAP Header "ESBCredentials".

Exemplo:

ESBCredentials

ESBCredentials é um tipo complexo que é usado para passar as credenciais de modo a autenticar o pedido SOAP.

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.

Pedido com ESBUsername e ESBPassword

Pedido com ESBToken

Usar um ESBToken ao invés do ESBUsername e ESBPassword pode ser útil se não pretende dar as suas credenciais a quem está a usar a API.

Para gerar um ESBToken deverá usar o serviço SAPO STS (Security Token Service). O ESB Token é válido por 12 horas.

Obter um ESB Token:

Resposta:

Token: id42ho234iwh234odihwdw786576413a3836467b94f8c2991f(...)wdwqdqwd

Voltar ao topo