API ya Programu

API ya Programu ya Mfuko inaruhusu wanachama, washirika, na mifumo iliyoidhinishwa kushirikiana na huduma za Mfuko kwa usalama na ufanisi. Imejengwa juu ya kanuni za RESTful na kulindwa na Mamlaka ya Cheti ya Mfuko.

1. Usanifu wa RESTful: Mbinu za HTTP za kawaida (GET, POST, PUT, DELETE) zenye miili ya ombi/jibu ya JSON.
2. Usalama wa PKI: Uthibitishaji wa mTLS wa pande zote mbili ukitumia vyeti vya mteja vilivyotolewa na AC ya Mfuko.
3. Ufikiaji Kulingana na Jukumu: Ruhusa zinazooana na haki za uanachama wa Darasa A (utawala) na Darasa B (kiuchumi).
4. Upatikanaji wa Juu: Miundombinu inayorudiwa inayobaki inafanya kazi na kupatikana karibu asilimia 100 ya wakati.
5. Utenganishaji wa Toleo: Matoleo thabiti ya API yenye notisi za kupitisha ili kuhakikisha uaminifu wa ujumuishaji wa muda mrefu.

Usalama ni muhimu sana. API inahitaji uthibitishaji imara kwa kutumia vyeti vya dijiti vilivyotolewa na Mamlaka ya Cheti ya Mfuko. Hii inahakikisha kutokukataliwa, usimbaji fiche, na udhibiti mkali wa ufikiaji unaooana na ulinzi wa kisheria wa Mfuko.

1. Vyeti vya Mteja: Maombi yote ya API lazima yawasilishe cheti halali cha mteja cha X.509 kilichotolewa na AC ya Mfuko.
2. TLS ya Pande Zote: Miunganiko hutumia mTLS kuthibitisha utambulisho wa mteja na seva, kuzuia mashambulizi ya man-in-the-middle.
3. Upigaji wa Cheti: Wateja wanapaswa kupiga cheti cha mzizi cha AC ya Mfuko ili kuzuia kujifanya kwa AC zisizoidhinishwa.
4. Uthibitishaji Bila Tokeni: Hakuna tokeni za OAuth wala funguo za API; uthibitishaji unatokana na somo na mabadiliko ya cheti cha mteja.
5. Usimbaji Fiche katika Usafirishaji: Trafiki yote imesimbwa fiche kupitia TLS 1.3; data nyeti imesimbwa fiche zaidi wakati wa mapumziko kulingana na Ibara ya 17.

Tunatoa nyaraka za kina, SDK, na mazingira ya sandbox ili kusaidia wanachama kujumuisha na API ya Mfuko kwa usalama na ufanisi.

1. Nyaraka za API: Maelezo ya OpenAPI ya mwingiliano yanayoelezea kwa undani vituo vyote, mipangilio, na nambari za makosa.
2. SDK: Maktaba rasmi za mteja kwa Python, JavaScript, Java, na Go ili kurahisisha uthibitishaji na usainiaji wa maombi.
3. Mazingira ya Sandbox: Mazingira ya majaribio yenye data ya mfano kwa maendeleo; yanahitaji vyeti tofauti vya majaribio.
4. Webhooks: Sanidi webhooks kupokea arifa za wakati halisi kuhusu hali ya mkopo, kura za utawala, au matukio ya kifedha.
5. Njia ya Msaada: Barua pepe ya msaada wa wasanifu programu iliyotengwa na mfumo wa tikiti kwa msaada wa kiufundi.

Uko tayari kujumuisha mifumo yako na Mfuko wa Jamii wa Afrika? Anza kwa kulinda utambulisho wako wa dijiti na kuomba vitambulisho vya ufikiaji wa API.

• Maombi ya Ufikiaji wa API
  Wezesha Ujumuishaji
• Msaada wa Wasanifu Programu
  Msaada wa Kiufundi
• Usalama na Uzingatiaji
  Maswali ya Sera