Desarrollo de aplicaciones web de Series.ly

jun. 06, 2013

Si te gusta programar, es posible que esta entrada te interese. Desarrollar una aplicación web de Series.ly es una tarea muy sencilla y llena de posibilidades. El portal cuenta con una gigantesca base de datos repleta de información sobre series, películas, programas, documentales, webseries, etc. y también sobre usuarios que interactúan con todas ellas: eligen sus favoritas, les ponen puntuación, marcan aquellas tienen pendientes de ver, las que ya han visto, escriben comentarios, crean listas propias y muchas cosas más.

Toda esta información es fácilmente accesible mediante la API que facilita el propio sitio web. Los métodos para utilizarla se especifican en la documentación. Desde el mismo sitio, puedes darte de alta para conseguir tu clave de acceso como desarrollador y que es necesaria para que la aplicación funcione.

Cómo hacer tu aplicación en PHP

Lo primero que necesitas es dar de alta tu aplicación en la documentación de la API de Series.ly. Te facilitarán un ID de aplicación y un SECRET, que será el código privado con el que se verificará que la aplicación es tuya. Nadie más debe saberlo.

Hice un código en PHP que facilita el acceso a los datos de Series.ly. Puedes encontrarlo en este repositorio de GitHub. (Si te animas, puedes mejorarlo y enviar tu aportación en el propio repositorio de GitHub).

Para utilizarlo, sólo debes importarlo en tu código y crear el objeto seriesly_api.

<?php
	include("seriesly.class.php");
	$api = new seriesly_api();
?>

Para nuestro ejemplo, vamos a utilizar tres archivos:

api_config.php: En el que incluiremos la información básica para que la aplicación funcione con la API de Series.ly.

<?php
	include("seriesly.class.php");
	$api = new seriesly_api();

	// Parametros de tu app
	$id_app = "XXX"; //Cambiar por tu ID de app
	$secret = "XXXXXXXXXXXXX"; //Cambiar por tu clave secret
	$callback_url = "http://mydomain.com/page.php"; // Página a la que redireccionará despues de hacer el login (page.php)
?>

login.php : Permitirá al usuario entrar con su cuenta de Series.ly a la aplicación.

<?php
	include("api_config.php");
	$api->get_auth_token($id_app, $secret);
	$api->user_login($callback_url);
?>

page.php : Mostrará el contenido de nuestra aplicación.

A partir de aquí puedes crear cualquier acción en tu aplicación (page.php). Sobra decir
que necesitarás unos mínimos conocimientos de PHP y saber manejarte con array.

<?php
	include("api_config.php");
	$api->get_auth_token($id_app, $secret);
	$api->get_user_token();

	//Aqui empieza la aplicación...

	$user = $api->user();
	echo $user["userdata"]["nick"]; //Mostrar nick del usuario
?>
Este es un esquema de funcionamiento de la API. Puede ayudarte a entender el procedimiento y también a conocer algunos recursos que puedes utilizar, explicados en la documentación.

David Maillo

Desarrollador web. Me dedico a crear productos y servicios digitales que después tú puedes disfrutar en tu pantalla gracias a la magia de Internet.