REST API · Webhooks · SDK

API koji možeš integrirati za jedan dan, ne za tjedan

Naturecornerk REST API dolazi s potpunom dokumentacijom, sandbox okruženjem i primjerima koda — tako da tvoj tim može krenuti odmah.

Naturecornerk API dokumentacija — pregled endpointa

REST API za ozbiljne integracije

Naturecornerk API je RESTful sučelje s JSON odgovorima, Bearer token autentifikacijom i rate limitingom koji se prilagođava pretplatnom planu. Svi endpointi su verzonirani (v1, v2) s unaprijed najavljenim deprecation periodom od najmanje 12 mjeseci — tako da tvoj kod ne puca iznenada. Sandbox okruženje je identična kopija produkcije s generiranim testnim podacima, dostupna odmah nakon registracije bez čekanja na odobrenje. Dokumentacija uključuje interaktivni API explorer, primjere u cURL-u, Node.js-u, Pythonu i PHP-u te Postman kolekciju s više od 80 zahtjeva. Prosječno vrijeme odgovora u produkcijskom okruženju iznosi ispod 120 ms za standardne endpointe.

Što dobiva tvoj razvojni tim

Sve što je potrebno za brzu, stabilnu integraciju bez iznenađenja u produkciji.

Interaktivni API explorer

Isprobaj svaki endpoint direktno u pregledniku bez ikakve konfiguracije. Explorer prikazuje stvarne zahtjeve i odgovore, uključujući zaglavlja i HTTP status kodove.

Webhook retry logika

Isporuka događaja s eksponencijalnim ponovnim pokušajima do pet puta, uz detaljne logove svake isporuke i mogućnost ručnog ponovnog slanja iz nadzorne ploče.

Bearer token + OAuth 2.0

Jednostavna autentifikacija za server-to-server pozive ili OAuth 2.0 flow za korisničke aplikacije. Rotacija API ključeva s nultim zastojem podržana je standardno.

Versioning bez iznenađenja

Svaka promjena API-ja unaprijed se objavljuje u changelogu s datumom deprecationa. Stare verzije ostaju aktivne još 12 mjeseci — dovoljno vremena za mirnu migraciju.

„Backend integracija koja nam je inače uzimala tjedan dana napravljena je za jedan radni dan zahvaljujući Naturecornerk sandboxu i Postman kolekciji. Naš junior developer je samostalno prošao kroz cijeli flow. To govori samo po sebi.”

— Petar Blažević, Lead Engineer, Pulse Commerce d.o.o.

Pitanja o API-ju

Tehnička pitanja koja programeri najčešće postavljaju prije nego što počnu integraciju.

Koji su limiti zahtjeva po planu?

Starter plan uključuje 10.000 API poziva mjesečno. Growth plan nema hard limit, ali primjenjuje soft throttling iznad 500.000 poziva i obavještava te 72 sata unaprijed ako se blizite kapacitetu. Enterprise plan nema ograničenja.

Postoji li SDK za mobilne platforme?

Trenutačno nudimo službene SDK-ove za Node.js i Python. React Native i Swift SDK su u razvoju s planiranim izdanjem u Q3 2025. Do tada, REST API radi bez ikakvih problema i s mobilnim klijentima koji koriste standardne HTTP biblioteke.

Kako prijaviti grešku ili zatražiti novi endpoint?

Sve API zahtjeve i prijave grešaka pratimo kroz javni GitHub repozitorij. Kritične greške adresiramo unutar 24 sata, a zahtjevi za novim endpointima ulaze u kvartalnu roadmap reviziju s javnim glasanjem.

Pokreni sandbox odmah

Registracija je besplatna i traje manje od dvije minute. Testni podaci su unaprijed generirani — možeš odmah slati zahtjeve.

Registriraj se besplatno