OpenAPI 3.1 specifikacija
Kompletna strojno-čitljiva specifikacija dostupna na /openapi.json. Uvezi je u Postman, Insomnia, generatore SDK-ova ili vlastiti CI pipeline — format je standardni, bez vendor lock-ina.
API platforma
Integriraj što god trebaš — naš API to podržava
REST i GraphQL sučelja s OpenAPI 3.1 dokumentacijom, rate limitingom i sandbox okruženjem za brzo testiranje.
Zašto developer-first API dizajn nije buzzword
Previše API-ja nastaje kao sporedni produkt — dokumentacija je nepotpuna, endpoint-i su nedosljedni, a verzioniranje je na razini dobre volje. Kod Lijepog Ateljea API je primarni produkt, a aplikacija ga konzumira jednako kao svaki vanjski klijent. To znači da svaki endpoint prolazi kroz code review, da su breaking changes zabranjene bez major verzije i da sandbox okruženje uvijek odražava produkcijsko stanje — bez „radi kod mene” scenarija koji gube sate.
Što developer dobiva od prvog dana
Svaki API plan dolazi s ovim tehničkim kapacitetima uključenim — ne kao dodaci.
Sandbox okruženje
Izolirana instanca sa seed podacima za testiranje svih endpointa bez straha od nuspojava na produkcijskim podacima. Sandbox se resetira svake nedjelje u ponoć ili na zahtjev putem jednog API poziva.
OAuth 2.0 i API ključevi
Podrška za OAuth 2.0 Authorization Code flow za end-user akcije i API ključeve s granularnim scope-ovima za server-to-server komunikaciju. Svaki ključ može biti ograničen na IP range i vremenski period.
Rate limiting i webhook-ovi
Konfigurabilan rate limiting po korisniku, organizaciji ili IP-u. Webhook sustav s retry logikom (eksponencijalni backoff do 72 sata) i HMAC potpisom za provjeru autentičnosti primljenih događaja.
Koja ograničenja trebaš znati unaprijed?
Naš API nije prikladan za real-time streaming podataka s latencijom ispod 50ms — za takve slučajeve preporučujemo WebSocket rješenja koja možemo integrirati kao poseban servis. Također, API ne nudi native mobile SDK-ove izvan JavaScripta i Pythona — za Swift ili Kotlin wrapere tim ih generira iz OpenAPI specifikacije uz minimalan effort, ali to nije uključeno u standardni plan. Svjesni smo tih granica i komuniciramo ih otvoreno, jer neočekivana ograničenja u produkciji koštaju više od iskrenoga razgovora na početku.
„Integrirali smo Lijepi Atelje API s našim legacy sustavom za upravljanje skladištem. Sandbox okruženje nam je uštedilo tjedan dana testiranja jer su seed podaci pokrili svaki edge case koji smo imali na meti. OpenAPI specifikacija je bila toliko uredna da smo generirali Python SDK za manje od sat vremena.”
— Ivan Brkić, Lead Engineer, Splitska Logistika d.d.
Spreman testirati API?
Pristup sandbox okruženju dobiva se u roku od 24 sata — pošalji nam zahtjev i odmah počinjemo.
Zatraži sandbox pristup