Inkomba ye-API
Ama-endpoint e-API omphakathi entuthuko: amafomu, i-widget, i-product configurator lokunye.
Le nkomba ichaza kuphela ama-endpoint e-JSON eqiniso asetshenziswa ngumphakathi -- indlela (method), i-path, uhlobo lokuqinisekisa ubuwena, amapharamitha ayisibopho, isibonelo sesicelo lesempendulo kanye lamakhodi amaphutha abhaliweyo e-endpoint ngayinye. UZentor kalalo uhlelo olujwayelekileyo lwezikhiye ze-API zabathuthukisi; ukungena kwenziwa, kuye ngomzila, ngaphandle kokuqinisekisa ubuwena kumbe nge-Embed-Token ye-widget lokuhlolwa kwe-Origin. Imizila yangaphakathi ye-dashboard lama-endpoint e-Master-Admin ngabomu kawasiyo ingxenye yale nkomba yomphakathi, ngoba afinyeleleka kuphela ngesikhathi sokungena esijwayelekileyo.
Okungenisiweyo kwe-endpoint ngayinye kulephawu lokuhlola okuphilayo, elidalula ukuthi ulwazi luvela kusakhiwo se-Registry, ekuhloleni okuzenzakalelayo kumbe ekuboneni okuphilayo kweqiniso -- ukufanana nje lendlela yekhodi esebenzayo kakubalwa njengobufakazi obupheleleyo. Ukubiza okuphumeleleyo ngokobuchwepheshe kuhlala kuqinisekisa kuphela ukusetshenzwa kwesicelo sona ngokwaso, hatshi ngokuzenzakalela izinqubo ezilandelayo ezinjengokulethwa kwe-imeyili, ukuphela kokubhadala kumbe ukungena kwe-SSO okuphelileyo.
Ukuvikeleka kuncike eqenjini ngalinye. Ama-endpoint omphakathi ezomthetho, okukhangisa lamafomu kawadingi isikhathi sokungena ku-dashboard. I-widget yengxoxo yona isebenzisa i-header `X-Widget-Token` lohlu lwama-Origin avunyelweyo (allowlist). Ukungena ku-dashboard kunika i-Session-JWT esebenza amahola alitshumi lambili le-Refresh-Token esebenza insuku eziyisikhombisa. Ama-endpoint e-SSO asebenza ngamakhodi awo okusetshenziswa kanye lezinqubo ze-callback.
Fundani ikhasi le-endpoint ngalinye njengesivumelwano esizimeleyo. Okuqakathekileyo yindlela ye-HTTP, i-path, amapharamitha ayisibopho, inhlobo zedatha, i-request body, isakhiwo sempendulo, amakhodi amaphutha lokuba yi-idempotent. Isibonelo sitshengisa ifomethi engenzakala, kodwa kasithathi indawo yokuhlola impendulo yeqiniso. Isimo sokuhlela, ukuqinisekisa, imvumo labahlinzeki bangaphandle kungantshintsha umphumela.
Umkhawulo wezicelo oqinisekisiweyo we-platform yonke yizicelo ezingu-2.000 phakathi kwemizuzu engu-15. Imikhawulo ehlukeneyo ye-endpoint ngayinye kayibhalwanga yonke indawo. Ngakho amaklayenti kawamelanga asebenzise ama-polling loop amancane kakhulu angadingekiyo. Emisebenzini engasi-idempotent, ukuphinda okuzenzakalelayo kungadala amarekhodi kumbe imiyalezo ephindiweyo.
Amanani azwelayo kawamelanga abe kumalogi. Lokhu kuhlanganisa amaphasiwedi, ama-token okusetha kabutsha, amakhodi okuqinisekisa, ama-token e-widget, ama-ID ezikhathi zokungena ledatha yesibonelo yeqiniso yabantu. Sebenzisani amanani angaziwayo (anonymised) encwadini echazayo lekuhloleni. Izaziso zokuhlola okuphilayo kumele zibonise kahle ubufakazi beqiniso.