Inicio 9 MFC Meta API

MFC meta API

Introdução

MFC meta API é uma API aberta que permite o uso de categorias criadas pelos editores do MFC em sua plataforma. É possível usar a meta API para qualquer fim não comercial, tal como para seu blog ou aplicativo.

Como usar meta API

Acesse o link pelo protocolo HTTPS:
https://www.mfcopenapi.info/open/api/playlist/videos/v1
*Método de solicitação: GET

Dados que podem ser solicitados:

 

Caráter Descrição Tipo de dado Necessário Observação
playlistId ID da playlist que deseja usar
*É necessário um link
Long Sim
language Linguagem de metadados. A linguagem padrão é o inglês, a API também suporta espanhol e português. String Não EN – English
ES – Spanish
PT – Portuguese
pageId Número de página que deseja solicitar. Se deseja um melhor desempenho, você pode solicitar os dados por paginação. Int Não
pageSize Quantidade de itens em cada página. A opção padrão é de 10 itens. Int Não

 

Dado que MFC meta API devolve:

 

Caractere Tipo Necessário Descrição
retCode number Sim Código de retorno
errCode number Sim Código de erro
message string Sim Resultado da solicitação
totalCount number Sim Número total de itens
pageId number Sim Número de página
pageSize number Sim Número de itens em cada página
count number Sim Número de itens na solicitação atual
result object [] Sim Conjunto de resultados
metaId number Sim ID do vídeo ou playlist ID, como 1234567890
title string Sim Título do vídeo ou playlist
poster string Sim Pôster do vídeo ou playlist
backdrop string Sim Fundo do vídeo ou playlist
rating string Sim Classificação do vídeo
genres object [] Sim Gênero do vídeo, como Animação, Drama…
genreId number Sim ID do gênero
name string Sim Nome do gênero, como Animação, Drama…
playlistId number Sim ID da playlist
runtime number Sim Duração do vídeo, como 100 min
metaType string Sim Tipo de meta doitem, como MOVIE, SERIES
pageType string Sim Tipo de página do item para abrir o app e entrar em uma página específica
success boolean Sim Se uma ação é bem-sucedida ou não. 0 significa bem-sucedida.

Códigos de erro

 

Código de retorno Código de erro Mensagem Descrição
0 0 vazio Pedidos normais
3 250

EN – Error: Playlist does not exist

ES – Error: La playlist no existe

PT – Erro: A playlist não existe

O ID da playlist solicitada não é o mesmo que o publicado pelo MFC
3 251

EN – Error: Playlist is empty

ES – Error: La playlist está vacía

PT – Erro: A playlist está vazia

O campo do ID está vazio ao solicitar os dados
3 253

EN – Current playlist is not supported

ES – La playlist actual no es compatible

PT – A playlist atual não é compatível

Tipo de playlist não suportado
4 40001

EN – Error: Request limit exceed

ES – Error: Límite excedido

PT – Erro: Limite excedido

Limite de solicitações excedido, o limite é de 10 vezes/60s

 

Exemplo:

https://www.mfcopenapi.info/open/api/playlist/videos/v1?playlistId=1

{

“result”: [

{

“metaId”: 30,

“title”: “Trending”,

“poster”: “”,

“backdrop”: “”,

“rating”: 0.0,

“genres”: [],

“runtime”: 0,

“metaType”: “PLAYLIST”,

“displayType”: null,

“pageType”: 3

},

{

“metaId”: 104870912,

“title”: “Downton Abbey: A New Era”,

“poster”: “http://image.mfcopenapi.info/api/resize/v1?imagePath=std/202206/7/a/7af05a5598454456d4e0860824b526bb.jpg“,

“backdrop”: “http://image.mfcopenapi.info/api/resize/v1?imagePath=opt/recommend/DOWNTON ABBEY THE MOVIE Poster.jpg“,

“rating”: 7.6,

“genres”: [

{

“genreId”: 7,

“name”: “Drama”,

“playlistId”: 565

},

{

“genreId”: 15,

“name”: “Romance”,

“playlistId”: 572

}

],

“runtime”: 124,

“metaType”: “MOVIE”,

“displayType”: null,

“pageType”: 1

},

{

“metaId”: 104871003,

“title”: “Physical”,

“poster”: “http://image.mfcopenapi.info/api/resize/v1?imagePath=std/202205/b/5/b5d283ba4563fd6f87f45a7dc07ff0b4.jpg“,

“backdrop”: “http://image.mfcopenapi.info/api/resize/v1?imagePath=opt/recommend/sojDujW1w3VHN3tjyKUU5pKgwsR.jpg“,

“rating”: 7.3,

“genres”: [

{

“genreId”: 4,

“name”: “Comedy”,

“playlistId”: 703

},

{

“genreId”: 7,

“name”: “Drama”,

“playlistId”: 706

}

],

“runtime”: 30,

“metaType”: “SERIES”,

“displayType”: null,

“pageType”: 1

},

{

“metaId”: 3000019,

“title”: “Popular EpicFilms”,

“poster”: “http://image.mfcopenapi.info/api/resize/v1?imagePath=std/201912/1/5/1573be7bdf91af5e4472f13842472161.jpg”,

“backdrop”: “http://image.mfcopenapi.info/api/resize/v1?imagePath=opt/recommend/ppphhh.jpg”,

“rating”: 0.0,

“genres”: [],

“runtime”: 0,

“metaType”: “PLAYLIST”,

“displayType”: “TYPE_LIST_TOPIC”,

“pageType”: 2

}

],

“retCode”: 0,

“errCode”: 0,

“message”: “ok”,

“totalCount”: 12,

“pageId”: 1,

“pageSize”: 12,

“count”: 12

}

Como abrir o MFC automaticamente em uma página específica

Crie um URL, como explicado a seguir, e empacote como “Intent” para que seu programa possa executar o MFC APP automaticamente. Em seguida, entre a uma página específica. Por exemplo:

String url = “mfccontent://vod.detail?pageId=x&id=xx”;
Intent intent = new Intent(“android.intent.action.VIEW”, Uri.parse(url));
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK|
Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
context.startActivity(intent);

Caracteres requeridos pela URL:
a. *pageId = 1,2,3 é equivalente ao valor de “pageType” que a API devolve, não a pageId
b. *id = faz referência ao “metaId” que a API devolve
c. Fondo = faz referência à URL da imagem que a API devolve

 

Playlists abertas

Open id Nome Descrição
1000001 Novas séries Novas séries da última semana
1000002 Novos filmes Novos filmes da última semana
1000003 Narcoseries As melhores séries hispânicas sobre narcotráfico
1000004 Oceanos Séries e filmes infantis sobre o mar
1000005 Filmes que não pode perder Filmes populares e novas estreias
10000060002 Melhores filmes do mês passado Os favoritos dos usuários no último mês