Desarrollador

Aquí explico como usar la nueva API de SRVRATS.TK. Han habido algunos cambios en esta para facilitar las peticiones a los desarrolladores.

Registrandose para una Clave de la API

Como antes, una Clave de la API es necesaria para ser procesada por el sistema. Cuando un usuario se registra, una Clave de la API se genera automáticamente para ese usuario. La Clave de la API debe ser enviada en la petición con el parámetro api (vea un ejemplo completo debejo).

Enviando una petición para acortar una URL

Para enviar una petición, el usuario debe usar el siguiente formato donde las variables api y url están requeridas. Para pedir un alias personalizado, simplemente añada &custom= al final.

  GET https://srvrats.tk/api?api=APIKEY&url=THELONGURLTOBESHORTENED&custom=CUSTOMALIAS

Respuesta del servidor

Como antes, la respuesta estará codificada en formato JSON (por defecto). Eso es para facilitar el uso cross-language. El primer elemento de la respuesta siempre dice si ha ocurrido un error (error: 1) o no (error: 0). El segundo elemento cambiará respecto al primer elemento. Si ha habido un error, el siguiente elemento se llamará “msg”. que contendrá el mensaje de error, si no hay error se llamará “short” y contendrá la URL. (Vea un ejemplo debajo)

// Sin errores
{
  "error":0,
  "short":"https:\/\/srvrats.tk\/DkZOb"
}
// Ha ocurrido un error
{
  "error":1,
  "msg":"Please enter a valid email"
}

Usando formato de texto plano

Ahora puedes pedir que la respuesta esté en texto plano añadiendo &format=text al final de la petición. Esto unicamente devolverá https://srvrats.tk/DkZOb en vez de la respuesta JSON. Si ocurriese algún error, no devolverá nada.

Usando la API en PHP

Para usar la API en tu aplicación PHP, deberás enviar una petición GET a través de file_get_contents o cURL: Ambos són métodos confiables. Puedes ver un ejemplo debajo usando file_get_contents.

<?php
  // Usando respuesta JSON
  $api_url="https://srvrats.tk/api?api=APIKEY&url=LAURLLARGAPARASERACORTADA&custom=ALIASPERSONALIZADO";
  $res= @json_decode(file_get_contents($api_url),TRUE);
  if($res["error"]){
    echo $res["msg"];
  }else{
    echo $res["short"];
  }

  // Usando respuesta en Texto Plano
  $api_url="https://srvrats.tk/api?api=APIKEY&url=LAURLLARGAPARASERACORTADA&custom=ALIASPERSONALIZADO&format=text";
  $res= @file_get_contents($api_url);
  if($res){
    echo $res;
  }
?>

Somos sociales

Siganos en Twitter