Rondedzero yeAPI
Zvishandiso zvevagadziri: nzvimbo dzekupinda dzeveruzhinji, chat widget, kupinda neREST-API nemakiyi eAPI.
API Reference inotsanangura zvibatanidzo zveZentor App zamunogona kudana kubva kumawebhusaiti nemapurogiramu enyu pachenyu: nzvimbo dzekupinda dzeveruzhinji dzemafomu, mugadziri wezvigadzirwa nezvinyorwa, chat widget, demo yechatbot pamwe nekupinda kusanganisira kupinda kamwe chete. Peji rimwe nerimwe renzvimbo yekupinda rinotaura nzira, gwara, kusimbiswa, ma-parameter, muenzaniso wechikumbiro nemhinduro pamwe nemakodhi ekukanganisa akanyorwa.
Kusimbiswa: nzvimbo dzekupinda dzemafomu, mugadziri wezvigadzirwa nezvinyorwa dzinosvikika pasina kupinda. Nzvimbo dzekupinda dzechat widget dzinotarisira tokheni yekuisa yewidget yenyu muheader `X-Widget-Token` uye dzinogamuchira chete zvikumbiro zvinobva madomeni akabvumidzwa ewidget. Nzvimbo dzekupinda dzekupinda dzinopa tokheni yekupinda (JWT) netokheni yekuvandudza yesesheni dzevashandisi.
Kuwana API nemakiyi eAPI: kumapurogiramu enyu pachenyu nekubatanidzwa kweseva-kuseva, iREST-API inowanikwa panzvimbo yehwaro URL `https://zentor-app.de/api/v1`. Zentor inovhura kuwana API kana kukumbirwa kuakaundi yenyu. Mushure meizvozvo vatongi vanogadzira mudashboard pasi pe„Makiyi eAPI“ makiyi avo uye vanotara kodzero dzavo (scopes) – misangano nekubhuka, chatbot, kutaurirana, mafaira, dura reruzivo, mishumo nedata yewebhu. Pachikamu chimwe nechimwe, pane scope yekuverenga (`<chikamu>.read`, GET chete) uye scope yekunyora (`<chikamu>.write`, inosanganisira kuverenga), semuenzaniso `appointments.read` kana `knowledge.write`. Tumirai kiyi muheader `Authorization: Bearer <kiyi yeAPI>` kana muheader rimwe `X-API-Key`. Ne-`GET /api/v1/me` munoongorora kuti kiyi ndeyeakaundi ipi uye ndedzipi scope.
Kiyi yakazara inoratidzwa kamwe chete pakugadzirwa. Chengetedzai iri zvakachengeteka uye kuseva chete, haitombonyorwi mukodhi yebhurauza kana mapurogiramu emafoni. Makiyi anogona kuwana zuva rekupera, kuchinjwa uye kudzorwa. Ne-REST-API panowanikwa chete mabasa ari mupakeji yenyu, uye data yese inoramba yakaganhurirwa kuakaundi yenyu. Zvikanganiso zinowanzoitika: 401 `API_KEY_INVALID`, `API_KEY_EXPIRED` kana `API_KEY_REVOKED` (kiyi isipo, isina kukodzera, yapera kana yadzorwa), 403 `API_ACCESS_NOT_ENABLED` (kuwana API kweakaundi hakusati kwavhurwa), 403 `API_SCOPE_MISSING` (kiyi haina scope inodikanwa), 403 `TENANT_NOT_ACTIVE` kana `TENANT_LOCKED` (akaundi haisi kushanda kana yakavharwa) uye 404 `API_ENDPOINT_NOT_AVAILABLE` (nzvimbo yekupinda haiwanikwi ne-REST-API).
Mhinduro nemiganhu: nzvimbo dzese dzekupinda dzinopindura ne-JSON. Mhinduro yakabudirira ine mamiriro e-2xx uye `"ok": true`; mhinduro yekukanganisa ine kodhi yekukanganisa inoverengwa nemuchina (mufield `error` kana `error.code`) nemeseji. Pa-IP-adiresi panogona kuitika zvikumbiro 2 000 mumaminitsi 15; nzvimbo dzekupinda dzemafomu, dzekusimbisa nedzekupinda dzine miganhu yakasimba, inotaurwa papeji rakakodzera. Kana kwapfuurwa, seva inopindura ne-429 `RATE_LIMIT_EXCEEDED`. Nzvimbo dzekupinda dzakanyorwa sedzisiri idempotent hadzifaniri kudzokororwa zvega mushure mekudambuka kwekubatana, nekuti kunogona kugadzira zvikumbiro kana mameseji akadzokororwa.
Tumirai pasiwedhi, tokheni, makiyi eAPI nemakodhi ekusimbisa chete muzviri zvechikumbiro kana muheader kuburikidza neHTTPS – kwete muma-URL, rekodhi kana mibvunzo yerubatsiro.