Semantičko verzioniranje
Sve promjene API-ja prate SemVer konvenciju. Deprecated endpointi ostaju aktivni najmanje 12 mjeseci uz upozorenja u odgovorima, a svaka breaking change dolazi uz migration guide i period paralelne podrške.
API
API koji se ponaša onako kako ste zamislili — ne kako je zgodno nama
Dizajniran prema načelima REST i GraphQL standarda, Gardentrailv API pruža predvidive odgovore, jasne kodove grešaka i potpunu kontrolu nad formatom podataka.
Kako je izgrađen Gardentrailv API?
Gardentrailv API izgrađen je prema principu „design-first” — što znači da OpenAPI specifikacija postoji prije implementacije, a ne kao naknadna bilješka. Svaki endpoint prolazi internu reviziju konzistentnosti imenovanja, sheme odgovora i upravljanja greškama prije nego što postane javno dostupan. Podržavamo OAuth 2.0 i API ključeve kao mehanizme autentifikacije, s mogućnošću fine kontrole dozvola na razini resursa. Rate limiting je konfigurabilni po timu i okruženju, a burst dozvole za kratke pikove prometa dolaze uključene na svim planovima. Webhookovi su asinkroni i dolaze s automatskim ponovnim pokušajem i delivery logom — nikada ne gubite događaj jer server vaše strane trenutačno nije dostupan.
Tehničke karakteristike API sloja
Latencija ispod 50 ms
Median latencija API odgovora iz EU regije iznosi 38 ms pri standardnom opterećenju. Edge PoP-ovi u Frankfurtu, Amsterdamu i Varšavi osiguravaju da vaši korisnici u Hrvatskoj i regiji dobivaju odgovore bez nepotrebnih okruštenja.
Pouzdani webhookovi
Svaki webhook događaj pohranjen je 72 sata. Automatski retry slijedi eksponencijalnu strategiju s do 10 pokušaja. Delivery log dostupan je u nadzornom panelu i putem API-ja, pa možete programatski pratiti svaki isporučeni događaj.
Sandbox okoline za testiranje
Sandbox API okoline zrcale produkcijsko ponašanje s kontroliranim mock podacima. Simulacija scenarija grešaka — timeout, rate limit, 5xx — dostupna je jednom zastavicom u zaglavlju, što olakšava pisanje robusnih integracijskih testova.
Ograničenja koja trebate znati unaprijed
Gardentrailv API nije namijenjen streaming prijenosu velikih binarnih datoteka — za to preporučamo namjenska object storage rješenja. Maksimalna veličina payload-a po zahtjevu je 10 MB na svim planovima; zahtjevi koji premašuju tu granicu bit će odbijeni s jasnom porukom greške. Garancija latencije od 50 ms primjenjuje se na standardne CRUD operacije — složeni aggregation upiti u GraphQL modu mogu trajati dulje ovisno o veličini dataseta. Transparentnost o tehničkim ograničenjima nije slabost — to je osnova za realističnu arhitekturnu odluku.
„Gardentrailv API dokumentacija je prva koju smo koristili bez jedinog pitanja upućenog podršci u prvih 48 sati. OpenAPI specifikacija bila je toliko precizna da smo generirali klijentski kod automatski i odmah počeli s integracijom.”
Luka Perić, senior backend inženjer, Rijeka
Pregledajte specifikaciju — bez registracije
Naša javna API dokumentacija dostupna je svima. Registracija je potrebna samo za produkcijske API ključeve.
Otvorite dokumentaciju