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!).