MFC meta API
Introducción
La MFC meta API es una API abierta que permite que uses las categorías creadas por los editores de MFC en tu plataforma. Puedes usar la meta API para fines no comerciales, como tu blog o aplicación.
Cómo usar meta API
Accede al enlace mediante método HTTPS:
https://www.mfcopenapi.info/open/api/playlist/videos/v1
*Método de solicitud: GET
Datos que pueden ser requeridos:
Caracter | Descripción | Tipo de datos | Necesario | Notas |
playlistId | ID de la playlist que quieres usar *Se necesita un enlace |
Long | Sí | |
language | Lenguaje de los metadatos. El lenguaje predeterminado es inglés, y la API también soporta español y portugués. | String | No | EN – Inglés ES – Español PT – Portugués |
pageId | Número de página que quieres solicitar. Si quieres un mejor desempeño, puedes solicitar los datos por paginación. | Int | No | |
pageSize | Cantidad de ítems en cada página. La opción predeterminada es de 10 ítems. | Int | No |
Datos que la API devuelve
Código de retorno | Código de error | Mensaje | Descripción |
0 | 0 | vacío | Pedidos normales |
3 | 250 |
EN – Error: Playlist does not exist ES – Error: La playlist no existe PT – Erro: A playlist não existe |
El ID de la playlist solicitada no coincide con la playlist publicada por MFC |
3 | 251 |
EN – Error: Playlist is empty ES – Error: La playlist está vacía PT – Erro: A playlist está vazia |
El campo del ID estaba vacío cuando se solicitaron los datos |
3 | 253 |
EN – Current playlist is not supported ES – La playlist actual no es compatible PT – A playlist atual não é compatível |
No se soporta el tipo playlist |
4 | 40001 |
EN – Error: Request limit exceed ES – Error: Límite excedido PT – Erro: Limite excedido |
Se excedió el límite de pedidos, el límite es 10 veces/60s |
Códigos de error
Caracter | Tipo | Necesario | Descripción |
retCode | number | Sí | Código de retorno |
errCode | number | Sí | Código de error |
message | string | Sí | Resultado de tu pedido |
totalCount | number | Sí | Número total de ítems |
pageId | number | Sí | Número de página |
pageSize | number | Sí | Cantidad de ítems en cada página |
count | number | Sí | Cantidad de ítems en el pedido actual |
result | object [] | Sí | Conjunto de resultados |
metaId | number | Sí | ID del video o playlist, como 1234567890 |
title | string | Sí | Título del video o playlist |
poster | string | Sí | Póster del video o playlist |
backdrop | string | Sí | Fondo del video o playlist |
rating | string | Sí | Clasificación del video |
genres | object [] | Sí | Género del video, como Animación, Drama… |
genreId | number | Sí | ID del género |
name | string | Sí | Nombre del género, como Animación, Drama… |
playlistId | number | Sí | ID de la playlist |
runtime | number | Sí | Duración del video, como 100 min |
metaType | string | Sí | Tipo de meta del ítem, como MOVIE, SERIES |
pageType | string | Sí | Tipo de página del ítem para abrir la app e ingresar a una página específica |
success | boolean | Sí | Determina si una acción es exitosa o no. 0 signfica que fue exitosa |
Ejemplos
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
}
Cómo abrir MFC automáticamente en una página específica
Crea una URL tal y como se explica a continuación y empaquétala como “Intent” para que tu programa pueda ejecutar la APP de MFC automáticamente. Luego, ingresa la página específica.
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 para la URL:
a. *pageId = 1,2,3 es equivalente al valor de «pageType» que la API devuelve, no a la pageId
b. *id = hace referencia a la «metaId» que la API devuelve
c. Fondo = hace referencia a la URL de la imagen que la API devuelve
Playlists abiertas
Open id | Nombre | Descripción |
1000001 | Nuevas series | Todas las novedades en series de la última semana |
1000002 | Nuevas películas | Todas las novedades en películas de la última semana |
1000003 | Narcoseries | Las mejores series hispanas sobre narcotráfico |
1000004 | El océano | Series y películas infantiles sobre el mar |
1000005 | Películas que no puedes dejar de ver | Películas populares y grandes estrenos |
1000006 | Las mejores pelis del mes pasado | Las favoritas de los usuarios del último mes |