API

Prati.ba API

API je skraćenica za engleski izraz application programming interface, što znači interfejs za programiranje (date) aplikacije. To je skup protokola i rutina koji računarski sistem, računarska biblioteka ili aplikacija obezbjeđuje drugim aplikacijama za obavljanje zahtjeva i usluga tim aplikacijama.
Konkretno, Prati.ba nalog je moguće ažurirati na automatski način upotrebom API-a. Dole ispod su instrukcije kako se to radi:

1. Odakle početi ?

Prati.ba API se zasniva na slanju HTTP GET zahtjeva našim serverima. Svaki zahtjev koji šalješ Prati.ba API-ju izgleda nešto poput: 

http://www.prati.ba/api?key=tvojApiKey&sta=staZelisDobiti


Da biste poslali bilo kakav API zahtjev Prati.ba, morate biti učlanjeni i imati svoj API ključ, koji ćete slati zajedno sa ostalim parametrima.



2. Ograničenja

Naš API ima neke limite na broj upita koji možeš tražiti, tj. trenutno možeš poslati ukupno 500 zahtjeva Prati.ba API-ja dnevno. Zbog ovoga je preporučeno koristiti neku metodu keširanja pri prikazu sadržaja sa Prati.ba.



3. Parametri očekuju vrijednosti

Da bi poslali ikakav API zahtjev, prvo što moraš imati je API ključ ( Link ). Ovaj ključ služi kao tvoj login ( username / password ), zato oprezno sa njim i ne daj nikakvim geekovima blizu računara dok si ulogovan na Prati.ba =)

  1. Vrijednosti parametara trebaju biti konvertovane u UTF-8 i URL enkodirane
  2. Sa svakim zahtjevom moraš poslati API key ( key=tvojApiKey ), komandu koju želiš izvršiti kroz api ( sta=StaZelis ) i parametre koje ta komanda zahtjeva
  3. Vraćeni sadržaj je u XML ili JSON formatu, u zavisnosti od format parametra ( format=json ili format=xml )


4. Šta se sve može kroz API ?

  1. Mjenjanje statusa
    sta=objavi
    tekst=vaš tekst ( koji je prethodno url enkodiran i konvertovan u UTF-8 )
  2. Posljednji postovi
    sta=mojipostovi ( parametar koji API-ju govori da kao odgovor želiš svoje postove )
    limit ( min. 1 , max. 30 )
    format - ( xml ili json )

5. Najlakši način za korištenje

Korisnicima našeg API-ja smo omogućili da na vrlo jednostavan način implementirati API pozive našem sajtu. Trenutno postoji olakšica samo za PHP, uskoro očekujte i za ostale najpopularnije jezike.

  1. Skinite našu PHP klasu
  2. Počnite koristiti API Jednostavno je, nakon što klasu skinete, sve što trebate jeste da ju dodate u svoj kod negdje pri vrhu

    require_once('api_call.php');
  3. Kreirajte novi objekat na mjestu gdje želite koristiti API. 

    $api = new Prati_API('$_tvoj_api_key');

    Bitno je samo da kao $_tvoj_api_key uneseš ključ koji si dobio.
  4. Uradi API poziv 

    $api->objavi('Ovo je tekst koji objavljujem na Prati.ba');

    $api->uzmiPostove('moji', 15, 'xml' );

    Trenutno su jedine dvije dostupne API funkcije objavi i uzmiPostove.