# Ninapata wapi ufunguo wa API, workflow ID na siri ya webhook?

Source: https://help.didit.me/sw/integration/api-key-workflow-id-and-webhook-secret
Updated: 2026-11-12

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](https://docs.didit.me/getting-started/api-authentication) |

> **Note:** 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](https://help.didit.me/sw/getting-started/contacting-didit-support). Ukitaka siri mpya, ibadilishe badala yake: ya zamani inaendelea kufanya kazi kwa saa 24. Zaidi katika [kupata matokeo ya uthibitishaji kwa webhooks](https://help.didit.me/sw/integration/webhooks-basics).

## Kagua usanidi wako

1. **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.

2. **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.

3. **Unda kikao**

   Piga endpoint ya create session kwenye `https://verification.didit.me` ukitumia 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](https://help.didit.me/sw/integration/api-errors).

4. **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](https://help.didit.me/sw/integration/webhook-troubleshooting).

## Yanayohusiana

- [Kusimamia funguo zako za API](https://help.didit.me/sw/account-organization/api-keys)
- [Kupata matokeo ya uthibitishaji kwa webhooks](https://help.didit.me/sw/integration/webhooks-basics)
- [Kujenga workflow ya uthibitishaji](https://help.didit.me/sw/workflows/build-a-verification-workflow)
- [Uthibitishaji wa API](https://docs.didit.me/getting-started/api-authentication) kwenye docs.didit.me