[PITCH] TVShow - Uma API para buscar filmes/séries · neto

Olá pessoal, tudo bem ?

Fiz uma publicação recentemente sobre minha aventura no ambiente mobile criando um app e uma api para buscar filmes/séries, mencionei também algumas features que o aplicativo tem, para saber mais clique aqui -> TabNews - TVShow

Hoje vim falar um pouco mais sobre a API e comentar as funcionalidades dela, ela pode ser consumida através do RapidApi - TVShow que consiste em 6 features de uma forma geral

/Movies (Filmes)
/Series (Série)
/Genre (Gênero)
/Cast (Elenco)
/Provider (Onde assistir)
/Language (Idiomas)

Agora irei detalhar um pouco mais o que é possível fazer em cada endpoint

/Languages

Será retornado uma lista de idiomas suportados na aplicação, será retornado uma lista de códigos onde é possível utilizar para realizar as buscas dos titulos

[... { code:"pt-BR" name:"Portuguese brazil" } ...]

/Movie

Aqui teremos todos os endpoints relacionados a filmes

/Movie/Search

Esse endpoint serve para buscar, de forma paginada, filmes a partir de um idioma para isso você pode informar os seguintes parametros na query:

params: { Language: 'pt-BR', Content: 'Exterminador do futuro', Adult: 'false', Page: '1' }

exemplo: /Movie/Search?language=pt-BR&content=Exterminador do futuro&adult=false&page=1

/Movie/TopRated

Aqui vai ser retornados os filmes mais bem avaliados

params: { Language: 'pt-BR', Adult: 'false', Page: '1' }

exemplo: /Movie/TopRated?language=pt-BR&adult=false&page=1

/Movie/Popular

Aqui vai ser retornados os filmes mais populares do momento, são filmes que podem estar em cartaz, que recentemente tiveram muitas avaliações nos streams ou mais assitidos

params: { Language: 'pt-BR', Adult: 'false', Page: '1' }

exemplo: /Movie/Popular?language=pt-BR&adult=false&page=1

/Movie/UpComing

Nesse endpoint serão retornados os filmes que estão em cartaz ou que entrará nos cinemas/streams na próxima semana

params: { Language: 'pt-BR', Adult: 'false', Page: '1' }

exemplo: /Movie/UpComing?language=pt-BR&adult=false&page=1

/Movie/Discover

Aqui vai ser retornado filmes aleatorios mais assistidos ou que está em cartaz e não é popular.

params: { Language: 'pt-BR', Adult: 'false', Page: '1' }

exemplo: /Movie/Discover?language=pt-BR&adult=false&page=1

/Movie/Detail

Esse endpoint serve para retornar os detalhes de um ou mais filmes como:

Titulo
Data de lançamento
Filme com classificação +18
Popularidade
Sinopse

params: { Items: '1029575,466420,940721,976573,1143183', Language: 'en-US' }

exemplo: /Movie/Detail?items=1029575,466420,940721,976573,1143183&language=pt-BR

/Serie

Aqui teremos todos os endpoints relacionados as séries

/Serie/Search

Esse endpoint serve para buscar,de forma paginada, séries a partir de um idioma para isso você pode informar os seguintes parametros na query:

params: { Language: 'pt-BR', Content: 'Exterminador do futuro', Adult: 'false', Page: '1' }

exemplo: /Serie/Search?language=pt-BR&content=Exterminador do futuro&adult=false&page=1

/Serie/OnTheAir

Nesse endpoint serão retornados as séries que irão entrar no stream ou que ainda estão em exibição

params: { Language: 'pt-BR', Adult: 'false', Page: '1' }

exemplo: /Serie/OnTheAir?language=pt-BR&adult=false&page=1

/Serie/Discover

Aqui vai ser retornado séries aleatorias mais assistidas ou que está em cartaz e não é popular.

params: { Language: 'pt-BR', Adult: 'false', Page: '1' }

exemplo: /Serie/Discover?language=pt-BR&adult=false&page=1

/Serie/Detail

Esse endpoint serve para retornar os detalhes de uma ou mais séries como:

Titulo
Data de lançamento
Filme com classificação +18
Popularidade
Sinopse
Número de episódios
Número de temporadas
Se ainda está em produção

params: { Items: '1029575,466420,940721,976573,1143183', Language: 'en-US' }

/Serie/Episodes

Aqui vai ser retornado dados dos episódios de uma série de uma temporada informada na requisição.

Nome
Sinopse
Data de exibição
Número do episódio
Número da season
Uma imagem do episódio

params: { ItemId: '1434', SeasonNumber: '1', Language: 'en-US' }

exemplo: /Serie/Episodes?itemId=1434&language=pt-BR&seasonNumber=1

/Genre

Aqui é o endpoint destinado a padronização dos gêneros, é retornado um id e nome que servem para identificar os gêneros dos títulos

exempo do retorno: [...{id:10759, name:"Ação e aventura"}...]

/Genre/Serie

params: { Language: 'en-US' }

exemplo: /Genre/Serie?language=pt-BR

/Genre/Movie

params: { Language: 'en-US' }

exemplo: /Genre/Movie?language=pt-BR

/WatchProvider

É o endpoint destinado a informar onde pode ser assistido, alugado ou comprado aquele título

/WatchProvider/Movie

params: {ItemId: '872585'}

exemplo: /WatchProvider/Movie?itemId=872585

/WatchProvider/Serie

params: {ItemId: '872585'}

exemplo: /WatchProvider/Serie?itemId=872585

/Cast

É o endpoint destinado a retornar o elenco de um título e seu respectivo personagem

/Cast/Movie

params: { ItemId: '872585', Language: 'pt-BR' }

exemplo: /Cast/Movie?itemId=872585

/Cast/Serie

params: { ItemId: '872585', Language: 'pt-BR' }

exemplo: /Cast/Serie?itemId=872585

Conclusão

No RapidApi - TVShow há exemplos de chamadas e retornos de todos os endpoints para que possam ser consumidos, porém qualquer dúvida estarei a disposição no privado para conversar

Atualmente estou trabalhando na inclusão de parametros em algumas rotas para que seja possível realizar uma espécie de funíl nas buscas e fazer com que cada vez mais o usuário receba indicações de titulos que seja do seu perfil.

Além disso estou buscando sempre melhorar o desempenho e segurança da aplicação para que fique sempre disponível para o uso.

Espero que de alguma forma esse post seja útil, seja em algum estudo ou na criação de sua própria aplicação.

Obrigado!