Application programming interface alebo skratkou API je rozhranie pre programovanie aplikácií.
API funkcie sú programové celky, ktoré programátor volá namiesto vlastného naprogramovania.
Náš API má veľmi jednoduchý zápis a takisto vracia jednoduchú odpoveď.
URL adresa musí na začiatku obsahovať prefix http:// alebo ftp://.
Ak požadujete len textový výstup s jednou premennou, máte možnosť si zvoliť, akú hodnotu chcete obdržať:
http://api.urlka.sk?request=<poziadavka>&longurl=<url>
kde <poziadavka> má tieto tvary:
"short" vráti len skrátenú adresu -> http://urlka.sk/7161a3
"preview" vráti adresu náhľadu -> http://nahlad.urlka.sk/7161a3
"stats" vráti adresu so štatistikami kliknutí -> http://urlka.sk/7161a3/4db4
a <url> je URL adresa, ktorú chcete skracovať.
V prípade, ak nezadáte parameter "request", API vráti odpoveď v zápise JSON:
{"longurl":"http://www.google.com","shorturl":"http://urlka.sk/7161a3","preview":"http://nahlad.urlka.sk/7161a3","stats":"http://urlka.sk/7161a3/4db4"}
V prípade, ak zadaná adresa v premennej "longurl" neobsahuje prefix http:// alebo ftp://, JSON odpoveď zo servera je {"errormsg":"URL in wrong format"} a to i v prípade použitia parametra "request".