API dokumentacija
Za developere.
Uvod
Što je API?
Solo API (Application Programming Interface) omogućuje slanje, primanje i brisanje podataka s tvog korisničkog računa putem REST (Representational state transfer) poziva.
Postoje mnoge situacije u kojima bi to moglo biti korisno. Recimo da imaš online trgovinu (webshop) i želiš automatski poslati klijentu račun (bez da ga ručno unosiš) nakon svake obavljene kupnje. To je moguće uz samo nekoliko linija koda pomoću API-ja.
API nije ograničen na specifičan programski jezik, a može se koristiti na bilo kojem jeziku koji ima podršku za slanje podataka putem HTTP POST poziva.
Kako funkcionira?
Metoda se uvijek poziva uz odgovarajući zahtjev HTTP POST/GET/DELETE. Bilo da je poziv bio uspješan ili neuspješan, API vraća rezultat u JSON formatu. U odgovoru će biti navedene sve relevantne informacije.
Dostupne metode
Trenutno je putem API-ja moguće napraviti (POST), prikazati (GET) ili izbrisati (DELETE) pojedinačni račun ili ponudu.
API možeš pozvati na ovaj način:
GET https://api.solo.com.hr/racun
Provjera autentičnosti
Pristup API-ju zahtjeva provjeru autentičnosti. Iz sigurnosnih razloga koristimo jedinstveni API token umjesto lozinke tvog računa. Ovaj API token treba biti objavljen kao parametar poziva. Možeš pronaći svoj API token u postavkama nakon prijave u servis.
Svaki API token je unikatan i tajan, stoga ga nemoj davati nepoznatim osobama ;)
API token je jedinstveni niz znamenki (brojke i slova) i izgleda otprilike ovako:
k2f85a47b75f20h21da9zg1337co5a1g
Encoding
Solo API vraća odgovore u UTF-8 (Unicode) encodingu.
Trebaš pomoć?
Slobodno nas kontaktiraj ako imaš bilo kakvih pitanja ili želiš prijaviti bug (prijavljene bugove nagrađujemo!).