Ufunguo wa API uko chini ya Wasanidi, Funguo za API; workflow ID kwenye Mitiririko ya kazi; siri ya kusaini webhook ni ya kila endpoint chini ya Webhooks.
Unahitaji thamani tatu kutoka kwenye console. Ufunguo wa API unaundwa chini ya Wasanidi → Funguo za API. Workflow ID inanakiliwa kutoka ukurasa wa Mitiririko ya kazi. Siri ya kusaini webhook ni ya kila endpoint chini ya Wasanidi → Webhooks, na unaweza kuiona tena wakati wowote kwa Onyesha. Chukua zote tatu kutoka programu ileile na mazingira yaleyale, Live au Sandbox.
Programu ya kuanzia au mradi ulioundwa na AI mara nyingi huorodhesha vigeu vya mazingira kama DIDIT_API_KEY, DIDIT_WORKFLOW_ID na DIDIT_WEBHOOK_SECRET. Majina hayo ni ya programu hiyo: Didit haikuwekei. Jedwali hili linaeleza kila thamani inatoka wapi.
#Kila thamani iko wapi
| Thamani | Mahali pa kuipata | Cha kujua |
|---|---|---|
| Ufunguo wa API | Wasanidi → Funguo za API, kisha Unda ufunguo (kila programu pia ina ufunguo wa Msingi) | Siri kamili huonyeshwa mara moja, unapounda au kubadilisha ufunguo, kwa hiyo iniakili kwenye kidhibiti chako cha siri wakati huo. Programu ya Live na programu ya Sandbox zina funguo tofauti: ufunguo wa sandbox hauundi kamwe uthibitishaji wa live. Utume kwenye kichwa cha x-api-key, kutoka kwa seva yako pekee |
| Workflow ID | Uthibitishaji wa utambulisho → Mitiririko ya kazi: fungua menyu ya safu na uchague Nakili ID ya mtiririko wa kazi (paneli ya hakiki ina kitufe kilekile) | Kila workflow ina ID yake katika kila programu. Nakala ya workflow hupata ID mpya |
| Siri ya kusaini webhook | Wasanidi → Webhooks, fungua endpoint, kisha siri yake ya kusaini na ubonyeze Onyesha | Siri moja kwa kila endpoint, si kwa kila programu. Onyesha inakuomba uthibitishe ni wewe, kisha siri hujificha tena ndani ya sekunde 60. Unaweza kuionyesha tena wakati wowote unapohitaji |
| API base URL | Haiko kwenye console: docs.didit.me inaitaja | https://verification.didit.me inahudumia API ya uthibitishaji (vikao, workflows, orodha, webhooks), inayothibitishwa kwa kichwa cha x-api-key. Angalia uthibitishaji wa API |
Ufunguo wa API na siri ya kusaini ni thamani tofauti. Ufunguo wa API huthibitisha maombi yako kwa Didit; siri ya kusaini hukuwezesha kukagua kuwa webhook ilitoka kweli kwa Didit. Kutumia moja badala ya nyingine husababisha 401 au saini isiyolingana.
#Naweza kuona siri ya kusaini webhook tena?
Ndiyo. Fungua Wasanidi → Webhooks, fungua endpoint na ubonyeze Onyesha. Thibitisha ni wewe, na siri itaonyeshwa hadi sekunde 60. Ikiwa Onyesha imefifia kwako, mwombe mwenzako mwenye ufikiaji au wasiliana na msaada. Ukitaka siri mpya, ibadilishe badala yake: ya zamani inaendelea kufanya kazi kwa saa 24. Zaidi katika kupata matokeo ya uthibitishaji kwa webhooks.
#Kagua usanidi wako
- Linganisha mazingira
Chagua programu na mazingira ya Live au Sandbox kwenye console kwanza, kisha nakili ufunguo, workflow ID na uunde endpoint ya webhook huko. Ufunguo wa sandbox pamoja na workflow ID ya live ni sababu ya kawaida ya 401 au 403.
- Weka thamani kwenye usanidi wa seva yako
Zihifadhi kama siri za upande wa seva. Usiweke kamwe ufunguo wa API au siri ya kusaini kwenye msimbo wa frontend, hazina ya umma au programu ya simu.
- Unda kikao
Piga endpoint ya create session kwenye
https://verification.didit.meukitumia ufunguo wako na workflow ID. 401 inamaanisha ufunguo si sahihi, umeisha muda au umebatilishwa; 403 kwenye workflow kwa kawaida inamaanisha ufunguo ni wa programu nyingine. Angalia hitilafu za API. - Tuma tukio la majaribio
Katika Wasanidi → Webhooks, fungua endpoint yako na ubonyeze Tuma tukio la majaribio. Seva yako inapaswa kukagua saini kwa siri ya kusaini na kujibu kwa 2xx. Ikiwa hakuna kinachofika, angalia wakati webhook haifiki kabisa.
#Yanayohusiana
- Kusimamia funguo zako za API
- Kupata matokeo ya uthibitishaji kwa webhooks
- Kujenga workflow ya uthibitishaji
- Uthibitishaji wa API kwenye docs.didit.me
Bado umekwama? Zungumza na binadamu.
Weka kitambulisho cha shirika lako na kitambulisho cha kikao unachouliza kukihusu.