En este post te mostraré cómo usar PHP para consumir la API de adf.ly.
El sitio web de adf.ly sirve para acortar enlaces y ganar dinero cada que alguien los visita y salta la publicidad. Podemos hacer un software con PHP para encerrar esta funcionalidad y hacer las cosas más fáciles.
Configurar adf.ly para consumir API
Lo primero que tienes que hacer es crearte una cuenta de adf.ly, si no tienes una puedes ir al siguiente sitio:
https://join-adf.ly/12358221
Después ve a Herramientas y haz click para habilitar el acceso a la API. Copia tu id y tu token como se ve en la imagen:
Una vez que has habilitado la api podemos usar la siguiente función de PHP.
Función de PHP para consumir API de adf.ly
Veamos el código fuente. He encerrado todo el funcionamiento en una función que recibe un enlace sin acortar y devuelve un enlace acortado (o lanza una excepción) de adf.ly
Si te preguntas, necesitamos el id y el token para que las ganancias se vayan a nuestra cuenta del acortador. En fin, el código es el siguiente:
<?php
# Ayudante para saber si cadena comienza con otra cadena
function comienzaCon($pajar, $aguja)
{
return $aguja === ''
|| strrpos($pajar, $aguja, -strlen($pajar)) !== false;
}
/**
* Acortar enlaces usando API de adf.ly
* @author parzibyte
* @see https://parzibyte.me/blog
* @param string $enlace
* @return bool|string
* @throws Exception
*/
function acortarAdfLy($enlace)
{
# Si no los tienes, únete en https://join-adf.ly/12358221
$key = "tu_llave"; # Llave pública de API
$uid = "tu_id"; # Id de usuario
$datos = [
'key' => $key,
"uid" => $uid,
'advert_type' => 'interstitial',
'domain' => 'q.gs',
"url" => $enlace,
];
$resultado = @file_get_contents('http://api.adf.ly/api.php?' . http_build_query($datos));
if ($resultado === false) {
throw new Exception(
"Error al realizar la conexión para acortar $enlace con adf.ly!"
);
}
/*
* Si no respondieron con un JSON entonces
* respondieron con la URL, y todas las cosas
* están bien
* */
$respuestaDecodificada = json_decode($resultado);
if ($respuestaDecodificada === null) {
if (comienzaCon($resultado, "ERROR:")) {
throw new Exception("El enlace $enlace no es válido: $resultado");
}
$acortado = $resultado;
if (preg_match('/^http:\/\/q\.gs\/\w+$/', $acortado) !== 1) {
throw new Exception("Enlace inesperado al acortar con adf.ly: " . $acortado);
}
return $acortado;
} else {
throw new Exception(
"Error en la respuesta del servidor al acortar con adf.ly"
. json_encode($respuestaDecodificada->errors, true)
. "!"
);
}
}
Primero tenemos una función ayudante que indica si una cadena comienza con otra; la he colocado así porque en ocasiones la API devuelve una cadena (y podemos confundirla con un enlace acortado) de error, así que para eso se usa.
Después usamos file_get_contents para hacer la petición a la API de adf.ly y obtenemos el resultado; al mismo le aplicamos ciertas comprobaciones como la forma del enlace usando una expresión regular.
Modo de uso
Un ejemplo de PHP para consumir API de adf.ly es el siguiente:
<?php
# Modo de uso
$enlace = "https://parzibyte.me/blog";
try {
$acortado = acortarAdfLy($enlace);
if ($acortado != false) {
echo "El enlace acortado es $acortado";
}
} catch (Exception $e) {
echo "Error acortando: " . $e->getMessage();
}
Hay que encerrarlo con un try catch
y comprobar si no se devuelve false
. Obviamente puedes modificar la función como tú quieras, yo solo estoy tratando de hacer que el código no tenga errores, o mejor dicho, que realmente sea un enlace acortado lo que se obtiene.
Al usarla en mi caso aparece esto:
Nota: aunque en el ejemplo estoy ejecutando PHP desde el CMD, puedes usar esta función en la web, en un formulario o en cualquier otro lugar que use PHP.
Conclusión
De este modo podemos consumir la API de Adf.ly; te invito a leer la documentación para que analices otras opciones.
Si quieres ver otros tutoriales como estos, te dejo los enlaces de consumo de API con PHP para acortar con ouo.io, shorte.st o shink.me