API para Desarrolladores.

Para utilizar el API de src.mx es muy sencillo y además te damos todas las herramientas para que de forma alternativa (si así lo deseas) puedas armar tu propio código.

SDK PHP.

Debido a que es el lenguaje de preferencia en la red y es multiplataforma, te proporcionamos el código que puede incluir en sus proyectos de desarrollo para facilitar el acortamiento con src.mx:

SDK - Introducción.

El SDK utiliza el método socket y/o cURL para comunicación con el servidor y obtener la url acortada, por lo cual dentro del SDK veras srcmx.php que es un ejemplo de las definiciones y librería (incluidas en el sDK) que necesitas para utilizar los servicios de src.mx.

SDK - Peticiones al API.

Las peticiones al servidor api es mediante POST, y la respuesta enviada por el servidor API hacia el cliente es recepcionada en JSON.
Es importante y recomendable que la url_larga la envíes encodeada (utiliza: urlencode($longurl) ).

Ejemplo en Plano (trama salida):

Host: src.mx
POST /api/
Content-Type: application/json
{"url":"google.com"}

SDK - Respuestas del Servidor.

El Servidor API al recepcionar la información por el flujo GET, verificara si la URL Larga no ha sido acortada con anterioridad, si ya ha sido acortada entonces solo proporcionara la URL Corta. Caos contrario si aun no ha sido acortada, entonces generara la URL Corta.

El Servidor responderá con un dato JSON, con los siguientes elementos:

Ejemplo Transacción Exitosa: {"url":"src.mx/hash","error":"no"}

Ejemplo Transacción Fallida: {"url":":(","error":"No URL detectada para acortar"}

SDK - Manejo de Datos JSON

Recepcionado los datos JSON de respuesta del Servidor API de src.mx es necesario convertirlos a datos funcionales en nuestro proyecto PHP (o cualquier lenguaje), para PHP la función que debes usar es json_decode($urljson), y esto convertirá los datos JSON en un Arreglo (array).

Array Transacción Exitosa: Array( [url]="src.mx/hash",[error]="no" )

Array Transacción Fallida: Array( [url]=":(",[error]="No URL detectada para acortar" )

Reporte de Vulnerabilidades.

Si tienes interés en el proyecto y quieres ayudarnos en la notificación de Vulnerabilidades, puedes contactarnos a contacto@sie-group.net y hacernos llegar tu reporte o descripción del problema, y con gusto nosotros haremos los cambios pertinentes y publicación de tu informe en este sitio.

Grupos de Trabajo en Medios Sociales.

También contamos con grupos de trabajo en medios sociales por si quieres comunicarte con nosotros, reportarnos una vulnerabilidad o bien participar con código.

Facebook Dev-Team Group: https://www.facebook.com/groups/apidevsiegroup/
FanPage (Danos un Like!): https://www.facebook.com/siegroupmexico
Twitter: @sie_group
Google+: https://plus.google.com/100850614072077226094