Tiny.lt

Tiny.lt API

2009-03-11 17:03

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.

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

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.

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";
}



(c) GeArSoft, 2009. Visos teisės saugomos.