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 |