Jinsi uthibitishaji unavyofanya kazi katika Zentor App
Hakuna mfumo wa funguo za API za Developer — kuna tu kuingia kwenye Dashboard na Tokeni ya Widget-Embed. Hivi ndivyo vyote viwili vinavyofanya kazi.
Ilikaguliwa mara ya mwisho: 2026-07-20
Zentor App kwa sasa haitoi ufunguo wa API wa kawaida na wa kudumu kwa watengenezaji. Kuna njia mbili halisi za uthibitishaji: kuingia kwenye Dashboard (kwa msingi wa Session, kwa wewe kama mtumiaji) na Tokeni ya Widget-Embed (kwa kuingiza Widget yako ya Chat hadharani kwenye tovuti yako).
Hatua kwa hatua
- Kuelewa kuingia kwenye DashboardBaada ya kuingia unapata tokeni ya ufikiaji inayotumika kwa saa 12, pamoja na Refresh-Token yenye muda wa siku 7 ili kubaki umeingia bila kuweka nenosiri tena. Tokeni ya ufikiaji hubadilishwa kila upyaji (inatumika mara moja tu).
- Washa uthibitishaji wa vipengele viwili (hiari)Unaweza kuwasha uthibitishaji wa hatua mbili unaotegemea TOTP (unaoendana na programu za kawaida za uthibitishaji) kwa akaunti yako, pamoja na misimbo ya akiba kwa dharura.
- Single Sign-On (ikiwa inapatikana)Ikiwa SSO (SAML/OIDC) imesanidiwa kwa mpangaji wako, kuingia kunaweza kulazimishwa kupitia Identity-Provider wako pekee — kuingia kwa kawaida kwa nenosiri kunakuwa kumefungwa.
- Kuelewa Tokeni ya Widget-EmbedKwa Widget yako ya Chat, tokeni yake mwenyewe huundwa wakati wa kuunda, na huonyeshwa kwa maandishi wazi mara moja tu. Imewekewa kikomo kikali kwa endpoints za umma za Widget (ujumbe wa Chat, tathmini, uingizaji/utoaji wa sauti) na haitoi ufikiaji wa kazi za Dashboard au Admin. Zaidi ya hayo, domain inayopiga simu hukaguliwa dhidi ya orodha ya kuruhusiwa.
Matokeo yaliyotarajiwa
Unaelewa ni ipi kati ya njia hizo mbili halisi zilizopo inayohusika na hali yako ya matumizi (kuingia kwako mwenyewe dhidi ya kuingiza Widget).
Hali za kawaida za makosa
Ninatafuta ufunguo wa API ili kuendesha skripti zangu dhidi ya API ya Zentor App.
Sababu: Mfumo kama huo wa funguo za API za Developer haupo kwa sasa.
Suluhisho: Njia pekee ya ufikiaji wa kimpango ni endpoint ya kawaida ya kuingia (login) ikifuatiwa na matumizi ya tokeni — pamoja na vikwazo vilivyotajwa (muda wa kuisha, uhusiano na Session). Kwa muunganisho wa kudumu, wasiliana na Zentor.
Tokeni yangu ya ufikiaji huisha muda wakati skripti inaendelea kuendeshwa.
Sababu: Tokeni ya ufikiaji imewekewa kikomo cha saa 12 na lazima ifanywe upya kupitia endpoint ya Refresh.
Suluhisho: Tekeleza upyaji wa tokeni kupitia endpoint ya Refresh, au ingia tena inapohitajika.
Tokeni ya Widget yangu inaweza kupata data za Dashboard kwa makosa — je, hii ni hatari ya usalama?
Sababu: Hapana — Tokeni ya Widget imewekewa kikomo kikali kitaalamu kwa endpoints za umma za Widget pekee na haifanyi kazi kama mbadala wa kuingia kwa Session.
Suluhisho: Hakuna hatua inayohitajika; hata hivyo, tibu Tokeni ya Widget kama siri, kwa kuwa pamoja na ukaguzi wa domain inatoa ufikiaji wa Widget yako.