Verzioniran schema
Svaka breaking promjena dobiva novi major verziju (/v2, /v3) i najavljuje se 90 dana unaprijed. Stare verzije žive još 12 mjeseci — imaš vremena za migraciju bez hitnje.
Proizvod
Jedan API, cijela kulinarska vertikala
Recepti, nutritivne tablice, kulinarski putevi i analitika — sve kroz jedan verzioniran REST sučelje koje možeš pozvati iz bilo kojeg stacka.
Što točno dobiješ kad se integriraš?
Cooktrailq API dijeli se u četiri jasne grupe endpointa. Prva je /recipes, koja vraća paginiran katalog recepata s filterima po kuhinji, dijeti, vremenu pripreme i alergenu. Svaki recept dolazi s normaliziranim popisom sastojaka, mjernim jedinicama prevedenim u SI i imperialnu skalu, i sekvenciranim koracima. Druga je /nutrition, koja za bilo koji recept ili custom popis sastojaka vraća USDA-mapirane makro i mikronutrijente. Treća je /trails, koja modelira kulinarske putanje — skupove recepata organiziranih po temi, sezoni ili regiji — i pogodna je za sekcije „weekly plan” ili „tematski tjedan”. Četvrta je /analytics, koja daje agregirane podatke o trendu pretraživanja i popularnosti po kategoriji, korisna za content timove i data analytics. Sve grupe dijele isti auth, isti format grešaka i isti rate-limit header format.
Tehničke karakteristike koje su ti bitne
Izgrađeno za production-grade integracije, a ne za PoC demonstracije.
Webhook događaji
Pretplati se na događaje poput recipe.published ili trail.updated i dobivaš push notifikacije umjesto polling-a. Svaki webhook dolazi s HMAC potpisom za verifikaciju.
Batch endpointi
Umjesto 500 pojedinačnih poziva, jedan /batch poziv vraća do 100 recepata u jednom HTTP round-tripu. Idealno za generiranje statičnog sadržaja i pre-rendering.
Dashboard s metrikama
Svaki API ključ ima dashboard koji prikazuje pozive po endpointu, latenciju po danu i top grešaka u zadnjih 30 dana. Nema pretplate na treće alate — vidljivost je ugrađena.
Pristup u indigotehničkim bojama — moderno razvojno okruženje
Cooktrailq developer portal dizajniran je u duhu indigo-tech estetike — tamne pozadine, jasni kontrasti i sintaksno obojeni primjeri koda koji smanjuju kognitivni napor pri čitanju dokumentacije. Interaktivni playground omogućuje slanje pravih poziva direktno iz preglednika — bez Postmana, bez lokalnog setup-a. Kopiraj odgovor, zalijepiti ga u svoju aplikaciju i odmah vidiš kako izgleda produkcijski payload. Platforma podržava dark i light mode, a UI komponente dokumentacije dostupne su kao open-source React library koji možeš ugraditi u vlastiti developer portal.
„Batch endpoint nam je smanjio infrastrukturne troškove za 60% jer smo mogli prijeći s real-time fetchinga na noćni build pipeline. Promijenili smo jednu liniju koda i sljedeći dan dobili račun prepolovljen. Rijetko se u startupima dogodi tako jasan ROI bez tjednog refaktora.”
Maja Šimić, Lead Engineer — TasteCraft Labs, Split
Spreman pogledati što API može?
Otvori dokumentaciju, pokreni prvi poziv u interaktivnom playgroundu i uvjeri se sam.