Cartaz de Estreias de Cinema

Cartaz de Estreias de Cinema

Todas as estreias desta semana e das próximas semanas em todo o país.

Comprar produto  

Descrição Técnica

Serviço Cinema

Procurar cartaz por filme, cinema, localização e outros filtros. Consultar datas de estreias dos próximos filmes e informação detalhada sobre filmes, cinemas, pessoas e outros dados relacionados.

Acerca dos elementos Filme:

- incluem um elemento Release com os dados relativos ao lançamento num determinado país (por defeito é Portugal, mas pode ser alterado fornecendo um ReleaseCountryId)

Manual de Referência da API

Serviço Operação Descrição
Cinema GetContributorRoles Listar tipos de contribuições. Parâmetros: PageNumber (optional, defaults to 1); RecordsPerPage (optional, defaults to 0);
GetCountryAuthority Consultar detalhes da autoridade de um determinado país, incluindo a lista de classificações que atribui aos filmes. Parâmetro: CountryId (Sapo GIS CountryId);
GetGenres Consultar lista de géneros de filmes. Parâmetros: PageNumber (optional, defaults to 1), RecordsPerPage (optional, defaults to 10);
GetMoviePremieres Listar filmes com dados de estreia. Parâmetros: ReleaseCountryId (optional, default = PT); StartDate (ex. 2009-07-01, optional, default = start of current week, Sunday 00:00); EndDate (2009-07-01, optional, default = end of current week, Saturday 23:59); ProductionCountryIds (optional, ex. PT,ES); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, ex. M04,M18); PageNumber (optional, default = 1); RecordsPerPage (optional, default = 10)
GetMoviesWithShowTimes Listar filmes com horários de exibição dentro dos locais e período de tempo. Parâmetros: ReleaseCountryId (optional, default = PT); LocationIds (optional, must be within ReleaseCountry, ex. 11,13); StartDate (2009-07-10, optional, default = last Thursday); EndDate (2009-07-01, optional, default = next Thursday); ProductionCountryIds (optional, ex. ES,PT); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, ex. M04, M18); PageNumber (optional, default = 1); RecordsPerPage (optional, default = 10);
GetPersons Listar filmes de acordo com os filtros (paginado). IncludeReleaseWithCountryId default = PT; PageNumber default = 1; RecordsPerPage default = 10, Max itens = 20;
GetTheaters Lista de salas de cinema na localização, com quantidade de filmes em exibição.
GetTheatersWithShowTimes Listar filmes dentro dos locais com horários de exibição dentro do período de tempo. Parâmetros: ReleaseCountryId (optional, default = PT); LocationIds (optional, must be within ReleaseCountry, ex. 11,13); StartDate (2009-01-01, optional, default = last Thursday); EndDate (2009-09-01, optional, default = next Thursday), ProductionCountryIds (optional, ex. ES,PT); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, ex. M04, M18); PageNumber (optional, default = 1); RecordsPerPage (optional, default = 10)

Serviço Cinema

Operações

GetContributorRoles

Listar tipos de contribuições. Parâmetros: PageNumber (optional, defaults to 1); RecordsPerPage (optional, defaults to 0);
Parâmetros do pedido
PageNumber : int (opcional)
RecordsPerPage : int (opcional)
Parâmetros de resposta
GetContributorRolesResult : ListOfContributorRoles (mandatório)
Exemplos

Listar tipos de contribuições. Parâmetros: PageNumber (optional, defaults to 1); RecordsPerPage (optional, defaults to 0);
Voltar ao topo

GetCountryAuthority

Consultar detalhes da autoridade de um determinado país, incluindo a lista de classificações que atribui aos filmes. Parâmetro: CountryId (Sapo GIS CountryId);
Parâmetros do pedido
CountryId : string (mandatório)
Parâmetros de resposta
GetCountryAuthorityResult : Authority (mandatório)
Exemplos

Consultar detalhes da autoridade de um determinado país, incluindo a lista de classificações que atribui aos filmes. Parâmetro: CountryId (Sapo GIS CountryId);
Voltar ao topo

GetGenres

Consultar lista de géneros de filmes. Parâmetros: PageNumber (optional, defaults to 1), RecordsPerPage (optional, defaults to 10);
Parâmetros do pedido
PageNumber : int (opcional)
RecordsPerPage : int (opcional)
Parâmetros de resposta
GetGenresResult : ListOfGenres (mandatório)
Exemplos

Consultar lista de géneros de filmes. Parâmetros: PageNumber (optional, defaults to 1), RecordsPerPage (optional, defaults to 10);
Voltar ao topo

GetMoviePremieres

Listar filmes com dados de estreia. Parâmetros: ReleaseCountryId (optional, default = PT); StartDate (ex. 2009-07-01, optional, default = start of current week, Sunday 00:00); EndDate (2009-07-01, optional, default = end of current week, Saturday 23:59); ProductionCountryIds (optional, ex. PT,ES); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, ex. M04,M18); PageNumber (optional, default = 1); RecordsPerPage (optional, default = 10)
Parâmetros do pedido
ReleaseCountryId : string (opcional)
StartDate : date (opcional)
EndDate : date (opcional)
ProductionCountryIds : ArrayOfProductionCountryId (opcional)
GenreIds : ArrayOfGenreId (opcional)
ReleaseRatingIds : ArrayOfRatingId (opcional)
IncludeContributors : boolean (opcional)
IncludeSynopsis : boolean (opcional)
PageNumber : int (opcional)
RecordsPerPage : int (opcional)
Version : int (opcional)
Parâmetros de resposta
GetMoviePremieresResult : ListOfMovies (mandatório)
Exemplos

Listar filmes com dados de estreia. Parâmetros: ReleaseCountryId (optional, default = PT); StartDate (ex. 2009-07-01, optional, default = start of current week, Sunday 00:00); EndDate (2009-07-01, optional, default = end of current week, Saturday 23:59); ProductionCountryIds (optional, ex. PT,ES); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, ex. M04,M18); PageNumber (optional, default = 1); RecordsPerPage (optional, default = 10)

Listar filmes com dados de estreia. Parâmetros: ReleaseCountryId (optional, default = PT); StartDate (ex. 2009-07-01, optional, default = start of current week, Sunday 00:00); EndDate (2009-07-01, optional, default = end of current week, Saturday 23:59); ProductionCountryIds (optional, ex. PT,ES); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, ex. M04,M18); PageNumber (optional, default = 1); RecordsPerPage (optional, default = 10)
Voltar ao topo

GetMoviesWithShowTimes

Listar filmes com horários de exibição dentro dos locais e período de tempo. Parâmetros: ReleaseCountryId (optional, default = PT); LocationIds (optional, must be within ReleaseCountry, ex. 11,13); StartDate (2009-07-10, optional, default = last Thursday); EndDate (2009-07-01, optional, default = next Thursday); ProductionCountryIds (optional, ex. ES,PT); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, ex. M04, M18); PageNumber (optional, default = 1); RecordsPerPage (optional, default = 10);
Parâmetros do pedido
ReleaseCountryId : string (opcional)
LocationIds : ArrayOfLocationId (opcional)
StartDate : date (opcional)
EndDate : date (opcional)
ProductionCountryIds : ArrayOfProductionCountryId (opcional)
GenreIds : ArrayOfGenreId (opcional)
ReleaseRatingIds : ArrayOfRatingId (opcional)
IncludeShowTimesDetails : boolean (opcional)
IncludeContributors : boolean (opcional)
IncludeSynopsis : boolean (opcional)
IncludeGenres : boolean (opcional)
Desativa mostrar detalhes do genero na ficha do filme
IncludeReferences : boolean (opcional)
IncludeRelease : boolean (opcional)
IncludeMedia : boolean (opcional)
Version : int (opcional)
Filtra filmes pelo versionId
PageNumber : int (opcional)
RecordsPerPage : int (opcional)
Parâmetros de resposta
GetMoviesWithShowTimesResult : ListOfMovies (mandatório)
Exemplos

Listar filmes com horários de exibição dentro dos locais e período de tempo. Parâmetros: ReleaseCountryId (optional, default = PT); LocationIds (optional, must be within ReleaseCountry, ex. 11,13); StartDate (2009-07-10, optional, default = last Thursday); EndDate (2009-07-01, optional, default = next Thursday); ProductionCountryIds (optional, ex. ES,PT); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, ex. M04, M18); PageNumber (optional, default = 1); RecordsPerPage (optional, default = 10);
Voltar ao topo

GetPersons

Listar filmes de acordo com os filtros (paginado). IncludeReleaseWithCountryId default = PT; PageNumber default = 1; RecordsPerPage default = 10, Max itens = 20;
Parâmetros do pedido
BirthCountryId : string (opcional)
IncludeReleaseWithCountryId : string (opcional)
SearchTerms : string (opcional)
PageNumber : int (opcional)
RecordsPerPage : int (opcional)
Parâmetros de resposta
GetPersonsResult : ListOfPerson (mandatório)
Voltar ao topo

GetTheaters

Lista de salas de cinema na localização, com quantidade de filmes em exibição.
Parâmetros do pedido
ReleaseCountryId : string (mandatório)
LocationIds : ArrayOfLocationId (opcional)
PageNumber : int (opcional)
RecordsPerPage : int (mandatório)
Parâmetros de resposta
GetTheatersResult : ListOfTheaters (mandatório)
Voltar ao topo

GetTheatersWithShowTimes

Listar filmes dentro dos locais com horários de exibição dentro do período de tempo. Parâmetros: ReleaseCountryId (optional, default = PT); LocationIds (optional, must be within ReleaseCountry, ex. 11,13); StartDate (2009-01-01, optional, default = last Thursday); EndDate (2009-09-01, optional, default = next Thursday), ProductionCountryIds (optional, ex. ES,PT); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, ex. M04, M18); PageNumber (optional, default = 1); RecordsPerPage (optional, default = 10)
Parâmetros do pedido
ReleaseCountryId : string (opcional)
LocationIds : ArrayOfLocationId (opcional)
StartDate : date (opcional)
EndDate : date (opcional)
ProductionCountryIds : ArrayOfProductionCountryId (opcional)
GenreIds : ArrayOfGenreId (opcional)
ReleaseRatingIds : ArrayOfRatingId (opcional)
IncludeShowTimeDetails : boolean (opcional)
IncludeLocation : boolean (opcional)
PageNumber : int (opcional)
RecordsPerPage : int (opcional)
Version : int (opcional)
Parâmetros de resposta
GetTheatersWithShowTimesResult : ListOfTheaters (mandatório)
Exemplos

Listar filmes dentro dos locais com horários de exibição dentro do período de tempo. Parâmetros: ReleaseCountryId (optional, default = PT); LocationIds (optional, must be within ReleaseCountry, ex. 11,13); StartDate (2009-01-01, optional, default = last Thursday); EndDate (2009-09-01, optional, default = next Thursday), ProductionCountryIds (optional, ex. ES,PT); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, ex. M04, M18); PageNumber (optional, default = 1); RecordsPerPage (optional, default = 10)

Listar filmes dentro dos locais com horários de exibição dentro do período de tempo. Parâmetros: ReleaseCountryId (optional, default = PT); LocationIds (optional, must be within ReleaseCountry, ex. 11,13); StartDate (2009-01-01, optional, default = last Thursday); EndDate (2009, optional, default = next Thursday); ProductionCountryIds (optional, ex. Es,PT); GenreIds (optional, ex. 2,3); ReleaseRatingIds (optional, PT,ES); PageNumber (optional, default = 1), RecordsPerPage (optional, default = 10);
Voltar ao topo

Cinema Entidades

ArrayOfContribution

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

ArrayOfContributor

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

ArrayOfContributorRole

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

ArrayOfCountry

Voltar ao topo

ArrayOfExternalId

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

ArrayOfGenre

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

ArrayOfGenreId

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

ArrayOfLink

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

ArrayOfLocationId

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

ArrayOfMediaItem

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

ArrayOfMovie

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

ArrayOfMovieShowTimes

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

ArrayOfPerson

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

ArrayOfProductionCountryId

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

ArrayOfQuote

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

ArrayOfRating

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

ArrayOfRatingId

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

ArrayOfShowTime

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

ArrayOfTheater

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

ArrayOfTheaterShowTimes

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

ArrayOfThumbnail

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

ArrayOfVersions

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

Authority

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

Contact

Nome do atributo Descrição
URL : string (opcional)
Email : string (opcional)
Phone : string (opcional)
CellPhone : string (opcional)
Voltar ao topo

Contribution

Nome do atributo Descrição
Movie : Movie
Role : ContributorRole
Voltar ao topo

Contributor

Nome do atributo Descrição
SourceId : string
Source : string
Voltar ao topo

ContributorRole

Nome do atributo Descrição
Id : string
Name : string
Voltar ao topo

Country

Voltar ao topo

ExternalId

Nome do atributo Descrição
Source : ExternalIdSource
Id : string
Voltar ao topo

ExternalIdSource

Valor Descrição
Meo
Sercultur
IMDB
Voltar ao topo

Genre

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

Link

Voltar ao topo

ListOfContributorRoles

Nome do atributo Descrição
ContributorRoles : ArrayOfContributorRole
PaginationDetails : PaginationDetails
Voltar ao topo

ListOfGenres

Nome do atributo Descrição
Genres : ArrayOfGenre
PaginationDetails : PaginationDetails
Voltar ao topo

ListOfMovies

Nome do atributo Descrição
Movies : ArrayOfMovie
PaginationDetails : PaginationDetails
Voltar ao topo

ListOfPerson

Nome do atributo Descrição
Persons : ArrayOfPerson
PaginationDetails : PaginationDetails
Voltar ao topo

ListOfTheaters

Nome do atributo Descrição
Theaters : ArrayOfTheater
PaginationDetails : PaginationDetails
Voltar ao topo

Location

Nome do atributo Descrição
CountryId : string (opcional)
CountryName : string (opcional)
DistrictId : string (opcional)
DistrictName : string (opcional)
MunicipalityId : string (opcional)
MunicipalityName : string (opcional)
ParishId : string (opcional)
ParishName : string (opcional)
Latitude : float (opcional)
Longitude : float (opcional)
Metadata : LocationMetadata (opcional)
ZipCode : string (opcional)
Locality : string (opcional)
Street : string (opcional)
HouseNumber : string (opcional)
MatchLevel : string (opcional)
Voltar ao topo

LocationMetadata

Nome do atributo Descrição
Provider : string
TrustLevel : string (opcional)
ISP : string (opcional)
Voltar ao topo

MediaCategory

Valor Descrição
Poster
Trailer
Image
Video
Voltar ao topo

MediaItem

RandName é o identificador único de um vídeo na plataforma SAPO Videos. Para mais informação, consultar: http://services.sapo.pt/Metadata/Service/Videos
Nome do atributo Descrição
Type : MediaType
Category : MediaCategory
Name : string (opcional)
URL : string (opcional)
RandName : string (opcional)
Extension : string (opcional)
Width : float (opcional)
Height : float (opcional)
Thumbnails : ArrayOfThumbnail (opcional)
Voltar ao topo

MediaType

Valor Descrição
Image
Video
Voltar ao topo

Movie

Nome do atributo Descrição
Id : string
Url : string (opcional)
Title : string (opcional)
Release : Release (opcional)
Year : int (opcional)
ProductionCountries : ArrayOfCountry (opcional)
Runtime : int (opcional)
Synopsis : string (opcional)
Contributors : ArrayOfContributor (opcional)
Genres : ArrayOfGenre (opcional)
Media : ArrayOfMediaItem (opcional)
References : References (opcional)
TheaterShowTimesList : ArrayOfTheaterShowTimes (opcional)
CreateDate : dateTime
UpdateDate : dateTime (opcional)
Quotes : ArrayOfQuote (opcional)
Version : int (opcional)
VersionAbbr : string (opcional)
Versions : ArrayOfVersions (opcional)
Rating : int (opcional)
Voltar ao topo

MovieShowTimes

Nome do atributo Descrição
Movie : Movie
ShowTimes : ArrayOfShowTime
TheaterTicketOfficeURL : string (opcional)
Voltar ao topo

PaginationDetails

Nome do atributo Descrição
CurrentPage : integer
RecordsPerPage : integer
RecordsTotal : integer
Voltar ao topo

Person

Nome do atributo Descrição
Id : string
Url : string (opcional)
Name : string
BornDate : date (opcional)
DiedDate : date (opcional)
Country : Country (opcional)
Biography : string (opcional)
Media : ArrayOfMediaItem (opcional)
Contributions : ArrayOfContribution (opcional)
CreateDate : dateTime (opcional)
UpdateDate : dateTime (opcional)
Voltar ao topo

Quote

Nome do atributo Descrição
Title : string
CharacterName : string
Movie : Movie (opcional)
Voltar ao topo

Rating

Nome do atributo Descrição
Id : string
Name : string
Voltar ao topo

References

Nome do atributo Descrição
ExternalIds : ArrayOfExternalId (opcional)
Links : ArrayOfLink (opcional)
Voltar ao topo

Release

Nome do atributo Descrição
Country : Country
Title : string (opcional)
Distributor : string (opcional)
ReleaseDate : dateTime (opcional)
Rating : Rating (opcional)
Authority : Authority (opcional)
Voltar ao topo

ShowTime

Nome do atributo Descrição
TimeStart : dateTime
ShowTimeTicketOfficeURL : string (opcional)
Voltar ao topo

Theater

Nome do atributo Descrição
Id : string
Name : string
Contact : Contact (opcional)
TicketOfficeURL : string (opcional)
Location : Location (opcional)
Description : string (opcional)
MovieShowTimesList : ArrayOfMovieShowTimes (opcional)
CreateDate : dateTime
UpdateDate : dateTime (opcional)
MoviesTotal : int (opcional)
Voltar ao topo

TheaterShowTimes

Nome do atributo Descrição
Theater : Theater
ShowTimes : ArrayOfShowTime
TheaterTicketOfficeURL : string (opcional)
Voltar ao topo

Thumbnail

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

Version

Nome do atributo Descrição
Id : int
Abbr : string
IsMain : boolean
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

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