Si vols fer servir l'aplicació per mitjà d'algun client com twitter o altres eines de tercers, en un parell de senzills passos ho tindràs assolit!
Paràmetres
url : Simplement l'adreça a escurçar; si no s'envia convertida amb la funció urlencode no es podrà emmagatzemar.
format : El format amb què s'espera la resposta del servidor.
Hi ha tres formats disponibles :
-
text :
status:Ok
link:http://ves.cat/_3a
url:http://www.exemple.com/document.php?id=valor -
json :
{
"status":"Ok",
"link":"http://ves.cat/_3a",
"url":"http://www.exemple.com/document.php?id=valor"
} -
xml
<?xml version="1.0" encoding="utf-8"?>
<response>
<status>Ok</status>
<link><![CDATA[http://ves.cat/_3a]]></link>
<url><![CDATA[http://www.exemple.com/document.php?id=valor]]></url>
</response>
S'han afegit a l'api funcions per a conèixer informació adicional sobre les adreces escurçades.
Per tal de conèixer qualsevol informació relacionada amb l'adreça escurçada, n'hi ha prou amb afegir a l'identificador de l'adreça escurçada el texte .info
Exemple :
Per tant si volguèssim conèixer la informació de l'adreça escurçada http://ves.cat/afaQ hauríem d'enviar el següent :
Ens durà a una pàgina on veurem tota la informació relacionada amb l'adreça emmagatzemada, com a la imatge següent.
També accepta el paràmetre de format, per si volem interactuar amb el servidor de ves.cat, per tant, si enviem http://ves.cat/afaQ.info?format=xml, la sortida en xml serà:
Exemples :
-
text :
id:21456
shortenedUrl:http://ves.cat/afaQ
deflatedUrl:http://ves.cat/api.html
lastSavedDate : 2010-05-13 17:37:35
numberOfClicks : 0
numberOfSaves : 1 -
json :
{
"id" : "21456",
"shortenedUrl" : "http://ves.cat/afaQ",
"deflatedUrl" : "http://ves.cat/api.html",
"lastSavedDate" : "2010-05-13 17:37:35",
"numberOfClicks" : "0",
"numberOfSaves" : "1"
} -
xml
<?xml version="1.0" encoding="utf-8"?>
<response>
<id>21456</id>
<shortenedUrl>http://ves.cat/afaQ</shortenedUrl>
<deflatedUrl>http://ves.cat/api.html</deflatedUrl>
<lastSavedDate>2010-05-13 17:37:35</lastSavedDate>
<numberOfClicks>0</numberOfClicks>
<numberOfSaves>1</numberOfSaves>
</response>
Aquesta actualització de l'api de ves.cat pot ajudar a crear eines de tercers per a evitar l'enviament d'adreces escurçades amb codi maliciós, per mitjà d'una ràpida consulta al servidor es pot saber quina és l'adreça de destí i així comprovar la fiabilitat del lloc.