OpenAPI 3.0 specifikacija
Potpuna masinski čitljiva specifikacija koja omogućuje automatsko generiranje klijentskih SDK-ova u bilo kojoj programskoj platformi. Uključuje primjere requestova i responsa za svaki endpoint.
Usluga · API razvoj
API koji programeri zapravo žele koristiti
Gradimo REST i GraphQL API-je s potpunom OpenAPI dokumentacijom, sandbox okruženjem i SDK-ovima za brzu integraciju.
Zašto je developer experience dio naše arhitekture?
Loš API je skup. Programeri koji ne mogu brzo shvatiti kako integrirati servis troše sate na istraživanje, pišu workaroundove i povećavaju tehničku dugovanje u bazi koda. Svaki API koji isporučujemo ima verzioniranje od v1, jasne poruke grešaka s actionable savjetima, te rate limiting koji ne iznenađuje. Postavljamo sandbox s realističnim test podacima koji oponašaju produkcijsko okruženje — što znači da možeš integrirati i testirati bez touchanja živih podataka.
Ključne komponente svakog Softgardenz API-ja
Ono što dobijete uz svaki isporučeni API endpoint.
Interaktivni sandbox
Testni environment s unaprijed učitanim podacima koji odražavaju produkcijski model. Programeri mogu slati prave HTTP pozive kroz browser bez ikakve konfiguracije.
Semantičko verzioniranje
Breaking changes nikada ne stižu bez upozorenja. Održavamo stare verzije paralelno s novima kroz minimum 12 mjeseci, a changelog je dio repozitorija, ne zasebna wiki stranica.
OAuth 2.0 i API key autentikacija
Podržavamo oba glavna autentikacijska obrasca ovisno o use-caseu. Server-to-server integracije koriste API ključeve s IP whitelistingom; korisnički kontekst koristi OAuth 2.0 s JWT tokenima.
„Integrirali smo Softgardenz payment routing API u naš backend za manje od dva radna dana. Dokumentacija je bila toliko jasna da nisam ni kontaktirao podršku. Sandbox je oponašao produkcijsko okruženje do detalja — prelazak na live bio je trivijalan.”
Matej Perković, Senior Developer, Hvar Digital
Česta pitanja o API integraciji
Koliko brzo mogu dobiti pristup sandboxu?
Nakon potpisivanja NDA-a i tehničkog onboardinga, sandbox pristup šaljemo unutar jednog radnog dana. Ne trebaš čekati na pravni tim da završi — tehničku integraciju možeš početi odmah.
Podržavate li webhookove uz REST?
Da. Svaki API koji gradimo uključuje event-driven webhook sustav za asinkroni push podataka. Događaji su definirani u OpenAPI specifikaciji i imaju isti format kao i sync odgovori.
Što se događa kad API stigne na rate limit?
Vraćamo HTTP 429 s Retry-After headerom i jasnom porukom koja objašnjava koji limit je prekoračen. Rate limiti su prikazani u dashboardu u stvarnom vremenu i mogu se povećati uz odgovarajući plan.
Možemo li koristiti vlastiti autentikacijski sustav?
Možete. Podržavamo federation s vanjskim identity providerima kroz OIDC protokol. Konfiguracija traje oko pola sata uz naše onboarding upute.
Trebate prilagođeni API za vaš sustav?
Opišite nam use-case — procjenimo izvedivost i vremenski okvir bez naknade.
Pošalji upit