# Kusimamia funguo zako za API

Source: https://help.didit.me/sw/account-organization/api-keys
Updated: 2026-10-12

Pata na uunde funguo za API chini ya Watengenezaji, Funguo za API. Kila huduma ipate ufunguo wake, weka funguo upande wa server, na rekebisha 401 na 403.

**Watengenezaji → Funguo za API**, zinahusiana na programu uliyochagua. Kila
programu ina ufunguo wa **Msingi**, na unaweza kuunda zaidi, mmoja kwa kila huduma,
kila mmoja na ufikiaji wake na muda wake wa kuisha. Ufunguo ni siri ya upande wa
server: kamwe usiwe kwenye msimbo wa frontend au ndani ya app bundle.

[Video: Weka funguo za API na ujaribu webhooks zako - Didit Academy](https://www.youtube.com/watch?v=thOMIGbNLP0&t=38)

[Video: Muunganisho wa KYC API kwa hatua 5, pamoja na maelekezo ya usanidi wa AI kwa Cursor - Didit Academy](https://www.youtube.com/watch?v=kTAarcImy7E)

Funguo zako za API ziko chini ya **Watengenezaji → Funguo za API** kwenye console, zikihusiana na programu unayofanyia kazi. Tendea kila ufunguo kama nywila: unatoa ufikiaji wa API kwa niaba ya programu hiyo.

## Kupata ufunguo wako

1. **Ingia kwenye Business Console**

   Nenda [business.didit.me](https://business.didit.me) na uingie.

2. **Chagua programu yako**

   Chagua programu kutoka kwenye kadi ya programu iliyo juu ya upau wa pembeni. Kila programu ina funguo zake.

3. **Fungua Watengenezaji, kisha Funguo za API**

   Kichupo cha **Funguo** kinaorodhesha kila ufunguo, kuanzia na ufunguo wa **Msingi**, pamoja na ufikiaji wake, ulipotumika mara ya mwisho na unapoisha.

![Ukurasa wa Funguo za API kwenye console ya Didit wenye orodha ya funguo](https://help.didit.me/screenshots/api-keys-light.webp)

*Kila ufunguo wa programu hii: ufunguo wa Msingi kwanza, kisha ile uliyounda.*

## Kuunda ufunguo

Mpe kila huduma inayoita Didit ufunguo wake, ili uweze kuona kila moja inachofanya na kuubatilisha peke yake.

1. **Bonyeza Unda ufunguo**

   Kwenye **Watengenezaji → Funguo za API**.

2. **Upe jina na uchague mazingira**

   Upe ufunguo jina la huduma itakayoutumia, chagua **Hai** (uthibitishaji halisi, unaotozwa) au **Sandbox** (data ya majaribio, haitozwi kamwe; ufunguo unaundwa kwenye programu ya Sandbox ya shirika lako), na uchague lini unaisha: kamwe, baada ya siku 30, siku 90 au mwaka mmoja, au tarehe unayochagua.

3. **Chagua ufikiaji wake**

   **Ufikiaji kamili** unasoma na kuandika kila kitu, kwa backend yako mwenyewe. Ufunguo wa **Kusoma tu** unaona session, maamuzi na media lakini hauwezi kubadilisha chochote, kwa mshirika anayehitaji matokeo tu. **Maalum** inakuruhusu kuchagua, rasilimali kwa rasilimali. Ondoa alama kwenye **Jumuisha media** wakati huduma inahitaji uamuzi tu, si picha za kitambulisho, selfie, video au ripoti za PDF.

4. **Kagua na unakili siri**

   Siri kamili inaonyeshwa mara moja tu, ufunguo unapoundwa. Inakili moja kwa moja kwenye kidhibiti chako cha siri.

Ufunguo wa **Msingi** ni siri asili ya programu. Daima una ufikiaji kamili na unaweza kuzungushwa lakini hauwezi kubatilishwa.

## Ufunguo wa API na siri ya kusaini ni vitu tofauti

Inafaa kusema hili wazi, kwa sababu kuvichanganya hutokeza hitilafu za kutatanisha:

| | Inatumika kwa nini | Wapi |
|---|---|---|
| **Ufunguo wa API** | Kuthibitisha maombi yako kwa Didit, kwenye kichwa cha `x-api-key` | Kwa kila programu, kadiri unavyohitaji |
| **Siri ya kusaini ya webhook** | Kuthibitisha kuwa webhook inayoingia kweli imetoka kwa Didit | Kwa kila **endpoint** ya webhook |

Kutuma siri ya kusaini kama ufunguo wako wa API hutokeza 401. Kuthibitisha webhook ukitumia ufunguo wako wa API hutokeza kutolingana kwa saini. Yote mawili ni ya kawaida.

> **Warning:** Ufunguo wako wa API ni siri. Kamwe usiuweke kwenye msimbo wa frontend, hifadhi ya
> umma, au ndani ya app bundle ya simu - uweke upande wa server pekee. Ufunguo
> uliomo ndani ya app bundle iliyosambazwa ni ufunguo ambao mshambuliaji tayari
> anao. Angalia
> [uthibitishaji wa API](https://docs.didit.me/getting-started/api-authentication).

## Kupata ufunguo kwa ajili ya majaribio

Usijaribu dhidi ya production. Badilisha console iwe **Sandbox** na uunde ufunguo hapo, au chagua **Sandbox** kama mazingira unapounda ufunguo. Session za sandbox huiga kila ukaguzi wa nje, hazitozwi kamwe, na hazigusi data halisi ya mtumiaji.

Ufunguo ni wa programu moja, na kupitia hiyo ni wa mazingira ya programu hiyo: ufunguo wa sandbox hauundi kamwe uthibitishaji wa live, na ufunguo wa live hauundi kamwe uthibitishaji wa sandbox. Inafaa kuzipa funguo zako majina yasiyo na utata popote unapohifadhi siri zako. Angalia [kujaribu kwenye sandbox](https://help.didit.me/sw/getting-started/sandbox-and-testing).

## Kuzungusha ufunguo wako

Kama ufunguo huenda ulifichuliwa, uufungue na uchague **Zungusha ufunguo**. Unapata siri mpya, na ile ya zamani inaendelea kufanya kazi kwa **saa 24**, ili uweze kuweka siri mpya bila kukatiza huduma. Baada ya hapo, kila ombi lenye siri ya zamani linarudisha 401.

Kama ufunguo lazima uache kufanya kazi sasa hivi, chagua **Batilisha ufunguo** badala yake. Kubatilisha kunausimamisha papo hapo na hakuwezi kutenduliwa. Ufunguo wa Msingi unaweza kuzungushwa tu.

Kuzungusha funguo kwa ratiba ni tabia nzuri. Kupange kama deploy, si bonyezo la haraka.

## Kurekebisha 401 na 403

| Hitilafu | Chanzo | Suluhisho |
|---|---|---|
| `401` | Ufunguo haupo, umeharibika, umeisha muda, umebatilishwa, au ulizungushwa zaidi ya saa 24 zilizopita | Kagua ufunguo chini ya **Watengenezaji → Funguo za API** kwa programu hiyo. Angalia nafasi zisizohitajika au alama za nukuu, na hakikisha hukubandika siri ya kusaini |
| `403` | Ufunguo ni sahihi lakini ombi hili haliruhusiwi | Kwa kawaida ni programu isiyo sahihi, sehemu ya sandbox pekee kwenye ufunguo wa live (au kinyume chake), ufikiaji ambao ufunguo haukupewa (kwa mfano ufunguo wa kusoma tu unaojaribu kuandika), au kipengele kisichowashwa kwenye akaunti yako |

`403` kwenye workflow mahususi karibu kila mara humaanisha ufunguo ni wa **programu tofauti** na ile inayomiliki workflow hiyo. Badilisha programu kwenye console na utumie mmoja wa funguo zake badala yake. Maelezo kamili: [hitilafu za API na maana yake](https://help.didit.me/sw/integration/api-errors).

## Kuzuia kile ufunguo unachoweza kufanya

Chagua ufikiaji unapounda ufunguo, na uubadilishe baadaye kwa **Hariri ufikiaji** (siri inabaki ileile; ufikiaji wa ufunguo wa Msingi hauwezi kuhaririwa). **Kusoma tu** kunamzuia mshirika kubadilisha chochote, **Maalum** kunaweka Hakuna, Kusoma au Kuandika kwa kila rasilimali (session, maamuzi, media, watu, kampuni na zaidi), na kuacha **Jumuisha media** ikiwa imezimwa kunaizuia huduma kupakua picha za kitambulisho, selfie, video na ripoti za PDF. Chini ya **Vikomo**, ufunguo unaweza pia kuwekewa baadhi ya workflow tu, session zilizoidhinishwa tu, au orodha ya anwani za IP: ombi kutoka nje ya orodha linajibu 403, na session iliyo nje ya workflow au hali za ufunguo inajibu 404. Fungua ufunguo kuona hasa kile unachoweza kufanya; ufunguo hauwezi kamwe kufanya zaidi ya ufikiaji wake unavyoruhusu.

## Nani kwenye timu yako anaweza kuona funguo

Uonekano wa funguo unafuata jukumu: kuona ukurasa kunahitaji ruhusa ya kusoma funguo za API, ambayo jukumu la **Msanidi** linajumuisha. Siri zinabaki zimefichwa kwenye console. Kama mwenzako hawezi kupata ukurasa, angalia jukumu lake kabla ya kuripoti tatizo. Angalia [kualika wanachama wa timu na kuweka majukumu](https://help.didit.me/sw/account-organization/team-members-and-roles).

## Kila ombi linarekodiwa

Maombi ya ufunguo wa API yanaonekana kwenye **Kumbukumbu za ukaguzi** yakihusishwa na ufunguo badala ya mtu. Ndiyo hasa sababu ufunguo mmoja unaoshirikiwa na huduma kadhaa hufanya tukio kuwa gumu zaidi kuchunguza: ufunguo mmoja kwa kila mtumiaji ni rahisi zaidi kuelewa. Angalia [kutumia audit logs](https://help.didit.me/sw/account-organization/audit-logs).