so-smart URL API

Pour les développeurs qui aiment le service so-smart URL et souhaitent l’utiliser dans leurs applications, voici un petit truc pour pouvoir raccourcir des URL sans nécessairement passer par le formulaire du mini-site.

Il suffit de faire une requête HTTP (POST) sur l’URL http://url.so-smart.be/post.php?format=json en passant en paramètre l’URL à raccourcir (url – obligatoire) et l’alias personnalisé (alias – facultatif).

Dans la réponse au format JSON, vous recevrez d’une part le status qui peut être ok (tout s’est bien passé) ou error (une erreur est survenue). Si tout s’est bien passé, vous recevrez l’alias (alias) ce qui vous permettra de reconstituer l’URL raccourcie en le faisant précéder par http://so-smart.be/~. Si une erreur est survenue, vous recevrez un message d’erreur (message).

Comme je conçois que tout ça n’est pas très clair, voici un exemple d’utilisation en PHP :

<?php

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, "http://url.so-smart.be/post.php?format=json");
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, "url=https://vinch.be//category/yulbiz/&alias=yulbiz");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$result = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($result));

?>

La réponse dans ce cas sera la suivante :

object(stdClass)#1 (2) { ["status"]=> string(5) "error" ["message"]=> string(26) "This alias already exists!" }

Oui, nous obtenons un message d’erreur car l’alias a déjà été utilisé.

Bon amusement !