API de shink.me con PHP

Introducción

En días anteriores vimos cómo trabajar con la API de ouo.io para acortar enlaces automáticamente desde PHP. Hoy veremos cómo trabajar con la API de shink.me en PHP para acortar enlaces.

Shinkme tiene su página web en shink.me. Vamos a ver cómo trabajar con ella. Dicha API responde en formato JSON.

Nota: puedes obtener tu id y clave en https://panel.shink.me/tools/api

Si no tienes cuenta puedes unirte en http://shon.xyz/r/63153

Cómo trabajar con la API de Shinkme en PHP

En este caso necesitamos el ID de la API y la clave API, las puedes obtener en tu panel de control. El punto en donde consumimos es en https://shon.xyz/api/0/id/[TU_ID]/auth_token/[TU_CLAVE]?s=[EL_LINK]

Shink.me devolverá un JSON. Entonces primero hacemos la petición con file_get_contents y luego lo decodificamos con json_decode.

Comprobamos si no hay errores y, al final, con una expresión regular, comparamos el enlace. Dicho enlace tiene la forma de shink.me/[letrasONumerosAquí].

Entonces el código fuente de ejemplo queda así:

<?php
/**
 *   Acortar con shink.me
 *   @author https://parzibyte.me/blog/
*/
function shinkme($enlace)
{
    $clave = "TU_CLAVE_AQUÍ";
    $id = "TU_ID_AQUÍ";
    $raw = file_get_contents(
        "https://shon.xyz/api/0/id/"
        . urlencode($id)
        . "/auth_token/"
        . urlencode($clave)
        . "?s=" . urlencode($enlace));
    if (false === $raw) {
        throw new \Exception("Error obteniendo JSON de shink.me");
    }
    $respuesta = json_decode($raw);
    # Comprobar si no hay errores
    if (isset($respuesta->error) && $respuesta->error === 0) {
        # Ahora este es el acortado, pero vamos a ver si coincide con una expresión regular
        $acortado = "http://shink.me/" . $respuesta->hash;
        if (preg_match('/^http:\/\/shink\.me\/\w+$/', $acortado) !== 1)# En caso de que no coincida
            throw new Exception("Enlace inesperado al acortar con shink.me: " . $acortado);
        return $acortado; #En caso de que sí regresamos el acortado
    } else {
        throw new Exception("Error al acortar $enlace con shink.me. #Error: " . $respuesta->error);
    }
}

?>

Encerramos todo dentro de la función. Una vez que hayamos puesto nuestro ID y clave API podemos llamar a la función con un enlace:

<?php
$enlaceAcortado = shinkme("https://parzibyte.me/blog/");

Por cierto, este enlace no puede ser un enlace de shink.me. Es decir, no podemos acortar un enlace acortado.

Ejemplos

Si llamamos a la función, nuestras claves están bien configuradas y el enlace es válido, se mostrará algo así:

Como se ve, se ha impreso el enlace acortado. En cambio, si mis claves son incorrectas recibo el error #2:

Finalmente, si mis claves son correctas pero el enlaces es inválido, sale el error #1:

Ya después podemos encerrar la llamada a esta función en un bloque try/catch y listo.