Natrag na OpenClaw vodič

Oriphiel OpenClaw vodič

API contracts i versioning

Kako izložiti stabilan CRM API s autentikacijom, shemama, verzijama, paginacijom, idempotentnošću i jasnim greškama.

Oriphiel stručni tim Ažurirano 22. 7. 2026. 3 min čitanja

Odgovor ukratko

API ugovor opisuje ponašanje koje potrošači smiju očekivati; interna promjena entiteta ne smije tiho slomiti forme, import ili AI alate.

Ključne odluke

  • Koja polja su javni ugovor
  • Kako se verzija bira
  • Koja je granica rate limita
  • Kako izgleda standardna greška

Provedba korak po korak

Cilj ove lekcije je Kako izložiti stabilan CRM API s autentikacijom, shemama, verzijama, paginacijom, idempotentnošću i jasnim greškama. Korake treba provoditi redom i svaki potvrditi prije širenja opsega.

Preporučeni redoslijed

  • Dokumentirati request i response sheme
  • Validirati payload na granici
  • Uvesti cursor paginaciju i status kodove
  • Objaviti deprecation i migracijski rok

Praktičan primjer

Kontakt forma šalje v1 lead payload s idempotency ključem, a API vraća 201 i stabilni lead ID ili 422 s preciznim popisom nevaljanih polja.

Kontrolna lista prije nastavka

Ova provjera odvaja završenu implementaciju od postavke koja samo izgleda dovršeno.

Provjerite

  • 401 i 403 se razlikuju
  • Validation greška pokazuje polje
  • Stari klijent radi tijekom migracije
  • Tajne nisu u URL-u ili logu

Najčešće pogreške i rizici

Rizike treba provjeriti prije povećanja prometa, automatizacije ili ovlasti sustava.

Na što treba paziti

  • Breaking change bez nove verzije
  • Endpoint vraća cijeli CRM zapis
  • Greške uvijek vraćaju 200
  • API ključ nema scope

Mjerenje rezultata

Učinak se procjenjuje kroz mali skup metrika koje su povezane s ciljem lekcije i stvarnim poslovnim ishodom.

Metrike koje imaju smisla

  • API error rate
  • p95 latency
  • Pozivi po verziji
  • Deprecated klijenti

Česta pitanja

Koji je prvi korak za temu „API contracts i versioning”?

Dokumentirati request i response sheme Prije nastavka potvrdite odluku: Koja polja su javni ugovor

Kako provjeriti da je provedba uspješna?

401 i 403 se razlikuju Nakon toga pratite metriku: API error rate.

Koju pogrešku treba prvo spriječiti?

Breaking change bez nove verzije Problem ispravite prije automatizacije ili povećanja budžeta.

Službeni i stručni izvori

Sučelja, pravila i preporuke mogu se mijenjati. Prije produkcijske izmjene provjerite aktualnu dokumentaciju.

Povezane OpenClaw lekcije

Webhook signature i idempotencyKako potvrditi pošiljatelja webhooka, spriječiti replay, sigurno ponoviti obradu i zadržati dokaz izvornog događaja. Role-permission matrica za CRMKako razdvojiti pregled, uređivanje, izvoz, administraciju, slanje kampanja i pristup osjetljivim podacima prema ulozi. Automatizirani testovi i fixturesKako testirati statusne prijelaze, prava, forme, queue, suppression, import i izvještaje s realističnim, ali sigurnim testnim podacima. CRM domain model: entiteti i vezeKako modelirati kontakte, organizacije, leadove, prilike, aktivnosti, kampanje i privole bez dupliranja poslovnog značenja.

Povežite ovu temu s ostatkom sustava

AI agenti u produkcijiDodajte AI tek nakon dozvola, evaluacije, audit loga i rollback plana. Google alati i CRMPovežite analitiku, kampanje i prodajne statuse bez gubitka izvora. Google Ads i CRMVratite kvalitetu leadova iz prodaje u optimizaciju kampanje.

Primijenite lekciju na stvarni projekt

Pošaljite postojeću konfiguraciju, cilj i problem koji želite riješiti. Dobit ćete prijedlog sljedećeg tehničkog ili operativnog koraka.

Pošaljite upitPregledajte sve vodiče