OpenAPI 3.1 spec
Preuzmi strojno čitljiv opis svakog endpointa i generiraj klijentski kod u bilo kojem jeziku koji podržava OpenAPI generatore — Go, Java, Ruby, PHP i drugi.
API
API koji se uklapa u tvoj stack, ne obrnuto
Brightfieldx REST API daje tvojim developerima čist, verzioniran pristup svim podacima i pipelineima — s dokumentacijom koja odgovara na prava pitanja.
Što točno nudi Brightfieldx API?
Brightfieldx REST API (v2) izlaže sve resurse platforme kao JSON endpointe s OpenAPI 3.1 specifikacijom. Autentikacija je temeljena na API ključevima s mogućnošću OAuth 2.0 za produkcijske integracije. Svaki endpoint je verzioniran — nadogradnje nikad ne lome postojeće integracije. Developerima su na raspolaganju SDK-ovi za Python i JavaScript/TypeScript, Postman kolekcija sa svim primerima i sandbox okruženje s fiktivnim podacima za testiranje bez ograničenja. Rate limiti su transparentni i prikazani u response headerima uz svaki poziv. Webhooks omogućuju push notifikacije na tvoj server čim se dogodi definirani podatkovni događaj — bez pollinga.
Zašto developeri biraju naš API
Dizajniran za minimalan friction od prvog poziva do produkcije.
Verzioniran bez prekida
Svaka breaking promjena dobiva novi major verziju, a stare verzije ostaju aktivne minimalno 12 mjeseci s unaprijed najavljenim end-of-life datumom.
Latencija ispod 80 ms
P95 latencija naših endpointa izmjerena u Q1 2024. iznosi 74 ms iz europskih regija. Podaci su keširani na edge nodovima u Frankfurtu i Amsterdamu.
Dokumentacija s primjerima
Svaki endpoint prate funkcionalni code snippeti u cURL, Pythonu i JavaScriptu. Nema apstraktnih opisa — samo copy-paste primjeri koji rade od prve.
Što klijent dobiva na kraju integracije?
Nakon uspješne integracije Brightfieldx API-ja klijent raspolaže s: potpuno konfiguriranom API vezom u svom produkcijskom okruženju, testiranim webhook handlerom za minimalno dva podatkovna događaja, pristupom privatnom Slack kanalu za tehničku podršku i arhivom svih API poziva dostupnom 90 dana unazad za debugiranje. Prosječna integracija jednostavnijeg use-casea traje između četiri i osam radnih sati za iskusnog backend developera — zahvaljujući jasnoj dokumentaciji i dostupnom sandbox okruženju. Za složenije slučajeve naš tim može pružiti code review sesiju bez dodatnih troškova.
„Integracija je trajala točno jedan dan. OpenAPI spec je bio kompletan, sandbox je radio bez greške i webhook notifikacije su proradile pri prvom pokušaju. Rijetko se to dogodi s eksternim API-jima.”
— Dino Krstičević, senior backend developer, Vela Tech
Pokreni prvu integraciju danas
Registriraj se i dobivaš API ključ i 14 dana besplatnog sandbox pristupa — bez kreditne kartice.