http://iKr.me/ts2

http://iKr.me/t9u

http://iKr.me/t9s

http://iKr.me/t99

http://iKr.me/t9Q

API dokumentacija

iKrme ima relativno jednostavan API (Application Programming Interface) koji druge aplikacije mogu koristiti za automatsko skraćivanje internet adresa. API funkcioniše tako što aplikacija pošalje zahtev na odredjenu adresu u kojoj je kao parametar postavljena adresa koju treba skratiti. iKrmisana adresa (ili poruka ako je došlo do greške) će biti vraćena u HTTP odgovoru.


Korišćenje iKrme API-ja

Jednostavno pozovi adresu

http://iKr.me/api/url=http://www.primer.com

Naravno, umesto http://www.primer.com postavi adresu koju želiš da skratiš. Protokol http:// je opcionalan ali ako nije naznačen protokol, HTTP će biti automatski postavljen.

Naravno, postoji podrška i za opcionalne lozinke. Ukoliko želiš da postaviš lozinku za pregled dovoljno je da dodaš parametar key dok parametar pwd koristiš da bi postavio lozinku za statistiku. Sa opcionalnim parametrima bi pozivna API adresa izgledala ovako:

http://iKr.me/api/url=http://www.primer.com&key=lozinka1&pwd=lozinka2

Takodje, ako iz bilo kog razloga želiš da dobiješ samo generisani iKrme kod dovoljno je da dodaš parametar code, na primer ovako:

http://iKr.me/api/code=1&url=http://www.primer.com


Dobijanje iKrmisane adrese

Nakon što si pozvao gore navedenu API adresu sa odgovarajućim parametrima sama stranica će sadržati samo iKrmisanu adresu.
Kao primer klikni na ovaj link: http://iKr.me/api/url=http://preferans.rs i pogledaj kako izgleda odgovor:

http://iKr.me/R

Ako si koristio parametar code sama stranica će sadržati samo iKrmisan kod.
Za ovaj primer klikni na ovaj link: http://iKr.me/api/code=1&url=http://preferans.rs i pogledaj kako izgleda odgovor:

R

Moguće greške

Ako zahtev nije uspešno prošao, kao odgovor će stranica sadržati jednu od sledećih poruka o grešci:


Kodiranje specijalnih karaktera (Encoding)

Ukoliko internet adresa koju želiš da iKrmišeš sadrži specijalne karaktere postoji mogućnost da iKrmisanje neće biti uspešno.
Sve osim velikih i malih slova, brojeva i ovih karaktera: - _ . ! ~ * ' ( ) spada u "specijalne karaktere" koje je neophodno kodirati.

Na primer, umesto & moraš da koristiš %26, a umesto # koristiš %23 i tako dalje.
Za brzo i jednostavno kodiranje poseti ovaj link: The URLEncode and URLDecode Page.
A za svaki slučaj evo i mini tabele najčešće korišćenih specijalnih karaktera:

karakterencoding
#%23
%%25
&%26
+%2B
:%3A
;%3B
?%3F


Zabranjeno je koristiti iKrme servis za slanje nepoželjnih mailova i poruka (SPAM)!


Primeri u kodu

Ispod se nalaze direktni primeri u različitim jezicima. Pošalji nam tvoje primere na iKrme mail.


Java


public static String getIKrmeLink(final String orig)
{
     String iKrme = "";
     try
     {
          URL url = new URL("http://iKr.me/api/url=" + orig);
          URLConnection conn = url.openConnection();
          BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));

          String inputLine;
          while ((inputLine = in.readLine()) != null)
               iKrme += inputLine;
          in.close();

          return iKrme.trim();
     }
     catch (Exception e)
     {
          return "ERROR: Cannot access remote site.";
     }
}


PHP


function getIKrmeLink($orig)
{
     $content = file_get_contents("http://iKr.me/api/url=".urlencode($orig));
     if ($content === FALSE)
          return "ERROR: Cannot access remote site.";
     return trim($content);
}
PHP kod napisao Milan Babuškov iz GuacoSoft - Software for you


This site uses Thumbshots previews