Acerca de go4.es

Go4.es es un generador de url cortas que permite la incluion de extensiones, de esta manera puedes enlazar una imagen con una url corta.
Go4.es esta basado en SLUGER, un generador de url cortas escrito por Psicobyte para la OSL.

Gracias a que estaba distribuido bajo una licencia libre Codeko ha podido modificarlo para darle nuevas funcionalidades. Si tu tambien quieres modificarlo puedes disponer de los fuentes en La Forja.

Ahora mismo en Codeko seguimos trabajando sobre esta version, que es una rama distinta al que se halla en La Forja, así que si lo deseas puedes solicitarnos los fuentes a go4es@codeko.com

Crear mi propia utilidad basada en go4.es

Sientete libre de crear cualquier utilidad o de usar go4.es para todo lo que necesites.

Si quieres crear tu propia utilidad simplemente debe saber como hacer que Go4.es cree una urls corta.
Para ello una llamada a la URL http://go4.es/?modo=new&url=TU_URL creará la URL corta.

Lógicamente esto te devolverá un montón de HTML que no quieres. Para que Go4.es te devuelva tu url en el formato que quieres puedes añadir el parámetro "format" a la url.
Actualmente Go4.es te ofrece tres formatos de respuesta "text", "xml" y "json".

Así si llamas a la url http://go4.es/?modo=new&format=text&url=TU_URL Go4.es devolverá una cadena de texto con la url acortada. Por ejemplo para la url http://go4.es/?modo=new&format=text&url=http://codeko.com Go4.es devolverá una cadena de texto con http://go4.es/000y.
Si hubiese algún error devolverá la cadena ERROR: Descripción del error.

Si llamas a la url http://go4.es/?modo=new&format=xml&url=TU_URL Go4.es devolverá un xml con los datos de tu url acortada. Por ejemplo para la url http://go4.es/?modo=new&format=xml&url=http://codeko.com Go4.es devolverá una cadena de texto con:


<?xml version="1.0" encoding="UTF-8"?>
<request>
	<url>http://go4.es/000ylt;/url>
	<target>http://codeko.comlt;/target>
	<error>Descripción del error si lo hubiera, si no se omite esta etiqueta.</error>
</request>

Si llamas a la url http://go4.es/?modo=new&format=json&url=TU_URL Go4.es devolverá una cadena json con los datos de tu url acortada. Por ejemplo para la url http://go4.es/?modo=new&format=json&url=http://codeko.com Go4.es devolverá:


{
"url":"Url corta generada o null si hay error",
"target": "Url a la que apunta la url corta generada",
"error": "Si hay un error aquí se mostrará un texto descriptivo de este, si no se omite este atributo"
}

Si quieres acortar tus urls con ajax probablemente te de un error de cross-domain (no se permiten hacer llamadas ajax a un dominio diferente al que se encuentra el script). Para conseguir que todo funcione puedes usar la técnica denominada JSONP. Para ello Go4.es admite, cuando solicitas una url acortada en formato "json", un parámetro "callback" cuyo valor debe ser el nombre de la función que se llamará pasándole como parámetro el objeto con los datos de la petición. Así si, siguiendo el ejemplo anterior, llamas a la url http://go4.es/?modo=new&format=json&callback=miFuncion&url=http://codeko.com Go4.es devolverá:
miFuncion({"url":"http://go4.es/000y","target":"http://codeko.com","error":"Descripción del error. Si no hay error se omite este atributo."});

NOTA: Con anterioridad a estos cambios se usaba el parámetro "api=1" y "api=2" para recuperar los datos en texto y json respectivamente. Estas forma de solicitar las urls cortas sigue funcionando pero no se recomienda su uso.

Utilidades

Una de las ventajas de distribuir bajo una licencia libre tu código, es que todo el mundo puede colaborar haciendolo mejor de manera que toda la comunidad se beneficie de ello, las personas que han colaborado con Go4.es son las siguientes:

Gracias a :

Enlavin.com por programar el bookmarklet Go4.es

A Nauj27 por crear el favicon y desarrollar la intregración con Ubiquity que puedes encontrar aqui:http://gist.github.com/233775

A Draxus por su idea de los gofres para el logo.

A andaluciapeople.com por colaborar en la mejora de nuestra API.