API referenca.
Javni API-endpunkti za programere: obrasci, widgeti, konfigurator proizvoda i još mnogo toga.
Ova referenca opisuje isključivo stvarne, javno dostupne JSON krajnje točke -- metodu, putanju, vrstu autentifikacije, obvezne parametre, primjer zahtjeva i odgovora te dokumentirane kodove pogrešaka za svaku krajnju točku. Zentor nema opći sustav API ključeva za developere; ovisno o ruti, pristup je moguć bez autentifikacije ili putem tokena za ugradnju widgeta uz provjeru izvora (Origin). Interne rute nadzorne ploče i krajnje točke Master Admina namjerno nisu dio ove javne reference jer su dostupne isključivo putem redovite prijavljene sesije.
Svaki unos krajnje točke sadrži napomenu o testu uživo koja otkriva potječe li podatak iz sheme registra, iz automatiziranog testa ili iz stvarnog promatranja uživo -- puka sličnost s ispravnom putanjom koda ne smatra se potpunim dokazom. Osim toga, tehnički uspješan poziv uvijek potvrđuje samo obradu samog zahtjeva, a ne automatski i naknadne procese kao što su isporuka e-pošte, dovršetak plaćanja ili dovršena SSO prijava.
Zaštita ovisi o pojedinoj skupini. Javne pravne, marketinške krajnje točke i krajnje točke obrazaca ne zahtijevaju sesiju nadzorne ploče. Chat widget pak koristi zaglavlje `X-Widget-Token` i popis dopuštenih izvora (Origin allowlist). Prijave na nadzornu ploču daju sesijski JWT s trajanjem od dvanaest sati i token za osvježavanje valjan sedam dana. SSO krajnje točke rade s vlastitim jednokratnim kodovima i callback tijekovima.
Čitajte svaku stranicu krajnje točke kao zaseban ugovor. Presudni su HTTP metoda, putanja, obvezni parametri, tipovi podataka, tijelo zahtjeva, struktura odgovora, kodovi pogrešaka i idempotentnost. Primjer prikazuje mogući format, ali ne zamjenjuje provjeru stvarnog odgovora. Status konfiguracije, validacije, ovlasti i vanjski pružatelji mogu promijeniti ishod.
Potvrđeno ograničenje broja zahtjeva na razini cijele platforme iznosi 2.000 zahtjeva unutar 15 minuta. Zasebna ograničenja po krajnjoj točki nisu dosljedno dokumentirana. Klijenti stoga ne bi trebali koristiti nepotrebno guste petlje prozivanja (polling). Kod operacija koje nisu idempotentne automatska ponavljanja mogu stvoriti duplicirane zapise ili poruke.
Osjetljive vrijednosti ne pripadaju u zapisnike. To uključuje lozinke, tokene za ponovno postavljanje, verifikacijske kodove, tokene widgeta, ID-ove sesija i stvarne osobne primjere podataka. U dokumentaciji i testovima koristite anonimizirane vrijednosti. Napomene o testu uživo moraju točno odražavati stvarni dokaz.