Tiny.lt API

0Arūnas Liuiza • 11th Mar 2009 • Projektai, Tiny.lt

Aurelijus iš Blake.lt sako, kad Tiny.lt reikia turėti API. Jis sako, jis žino, nes viena ausim girdėjau gandus, kad pats kuria panašų daiktą. O mes pasiraitojom rankoves ir padarėm tai, kas slepiasi po burtažodžiu ‘API’.

O slepiasi viena paprasta funkcija: galimybė tiesiogiai, be grafinės sąsajos bendrauti su tiny.lt serveriu. Šiuo metu Tiny.lt API moka tris dalykus – įdėti naują nuorodą į sistemą, parodyti jau esamos nuorodos santrumpą ir parodyti pilną duotos santrumpos adresą. Toliau – plačiau.

1. Naujos nuorodos įdėjimas. Paprasta – GET arba POST metodu kreipiatės į skriptą http://tiny.lt/api.php ir perduodate norimą sutrumptinį adresą kaip parametrą url. Pavyzdžiui: http://tiny.lt/api.php?url=http://www.liuiza.lt/kompiuteriai-ir-internetas/tinklapiu-kurimas/ponai-ir-ponios-tinylt_117/. Serveris Jums grąžins santrumpos adresą: http://tiny.lt/651650n 
2. Esamos nuorodos santrumpa. Jei serveriui pateiksite jau įtrauktą nuorodą, bus sukurta ne nauja santrumpa, o parodyta jau esama. Veiksmų seka tokia pati kaip ir pirmu atveju.
3. Pilnos nuorodos grąžinimas. Atvirkštinis procesas – jei serveriui pateiksite egzistuojančios santrumpos adresą, pavyzdžiui: http://tiny.lt/651650n, serveris grąžins pilną nuorodos adresą, šiuo atveju: http://www.liuiza.lt/kompiuteriai-ir-internetas/tinklapiu-kurimas/ponai-ir-ponios-tinylt_117/. 

Mažutis funkcijos pavyzdys:

function getTinyLt($url) {
   if (($result = file_get_contents('http://tiny.lt/api.php?url='.$url))  === false) {
        throw new Exception( "Negaliu sutrumpinti $url " );
    }
    return($result);
}

try {
    echo getTinyLt("http://www.liuiza.lt");
} catch (Exception $e) {
    echo "įvyko klaida" ,  $e->getMessage() , "\n";
}