Sanggunian ng API.

Inilalarawan ng reference na ito ang mga totoo at pampublikong magagamit na JSON endpoint lamang -- method, path, uri ng authentication, mga kinakailangang parameter, halimbawang request at response, pati ang mga dokumentadong error code sa bawat endpoint. Walang pangkalahatang sistema ng developer API key ang Zentor; depende sa route, ang access ay walang authentication o sa pamamagitan ng Widget embed token na may pagsusuri ng origin. Sadyang hindi kasama sa pampublikong reference na ito ang mga internal na dashboard route at mga Master Admin endpoint, dahil maaabot lamang ang mga ito sa pamamagitan ng karaniwang naka-login na session.

Bawat endpoint entry ay may tala ng live test na nagsasaad kung ang impormasyon ay galing sa registry schema, sa isang automated test, o sa aktwal na live na obserbasyon -- ang simpleng pagkakahawig sa isang gumaganang code path ay hindi itinuturing na buong patunay. Bukod dito, ang isang teknikal na matagumpay na tawag ay nagpapatunay lamang na naproseso ang mismong request, hindi awtomatikong ang mga kasunod na proseso gaya ng paghahatid ng email, pagkumpleto ng bayad, o natapos na SSO login.

Nakadepende ang proteksyon sa bawat grupo. Hindi kailangan ng dashboard session ang mga pampublikong legal, marketing at form endpoint. Ang chat widget naman ay gumagamit ng header na `X-Widget-Token` at isang origin allowlist. Ang mga dashboard login ay nagbibigay ng session JWT na may bisa nang labindalawang oras at refresh token na may bisa nang pitong araw. Ang mga SSO endpoint ay gumagamit ng sarili nilang one-time code at callback flow.

Basahin ang bawat endpoint page bilang hiwalay na kontrata. Mahalaga ang HTTP method, path, mga kinakailangang parameter, mga uri ng data, request body, istruktura ng response, mga error code at idempotency. Ipinapakita ng isang halimbawa ang posibleng format, ngunit hindi nito pinapalitan ang pagsusuri sa aktwal na response. Maaaring baguhin ng configuration status, mga validation, mga pahintulot at mga panlabas na provider ang resulta.

Ang kumpirmadong rate limit para sa buong platform ay 2,000 request sa loob ng 15 minuto. Hindi pare-parehong dokumentado ang hiwalay na limit sa bawat endpoint. Kaya hindi dapat gumamit ang mga client ng hindi kinakailangang masisikip na polling loop. Sa mga operasyong hindi idempotent, maaaring lumikha ng dobleng record o mensahe ang mga awtomatikong pag-ulit.

Hindi dapat ilagay sa mga log ang mga sensitibong value. Kabilang dito ang mga password, reset token, verification code, widget token, session ID at totoong personal na halimbawang data. Gumamit ng mga anonymized na value sa dokumentasyon at mga test. Dapat tumpak na ilarawan ng mga tala ng live test ang aktwal na patunay.