API ya Uthibitishaji wa Faili ya Wakimbizi Afrika Kusini (SW)

Kuingiza watumiaji nchini Afrika Kusini kunamaanisha kuthibitisha kuwa wao ni wale wanaodai kuwa. Inathibitisha nambari ya faili ya mkimbizi dhidi ya rejista ya wakimbizi ya Idara ya Mambo ya Ndani ya Afrika Kusini. Hati au maelezo yaliyoandikwa huonyesha tu kuwa data ipo — si kwamba ni halisi au inamhusu mtu aliyeko mbele yako. Uthibitishaji wa Faili ya Wakimbizi Afrika Kusini huziba pengo hilo kwa kuangalia data dhidi ya vyanzo vya data vya serikali vilivyo na mamlaka. Mwongozo huu unaelezea nini hundi inafanya, maelezo kamili ya kiufundi, na jinsi ya kuiunganisha kwa dakika.

Mambo muhimu:

• Inachothibitisha — Uthibitishaji wa Faili ya Wakimbizi Afrika Kusini huthibitisha rekodi za serikali dhidi ya vyanzo vya data vya serikali vilivyo na mamlaka.
• Unachopata — match_type iliyorekebishwa pamoja na matokeo ya kiwango cha uwanja unayoweza kuelekeza moja kwa moja kwenye mantiki ya kuidhinisha / kukagua / kukataa.
• Kwa nini ni muhimu — Rekodi zinazoshikiliwa na serikali ndio chanzo chenye mamlaka zaidi cha kuthibitisha kuwa mtu yupo kwa utambulisho uliotajwa.
• Jinsi ya kuitumia — POST moja kwenye endpoint ya uthibitishaji wa hifadhidata ya Didit. $1.10 kwa hoja yenye uhakika, matokeo kwa sekunde.

Nini Uthibitishaji wa Faili ya Wakimbizi Afrika Kusini unathibitisha

Inathibitisha nambari ya faili ya mkimbizi dhidi ya rejista ya wakimbizi ya Idara ya Mambo ya Ndani ya Afrika Kusini. Didit inaiweka wazi kupitia endpoint moja ili uweze kuthibitisha data iliyowasilishwa dhidi ya vyanzo vya data vya serikali vilivyo na mamlaka na kupokea matokeo yaliyopangwa, yaliyorekebishwa — si takataka ghafi ya rejista unayopaswa kuchambua mwenyewe.

Jibu lenye uhakika hurudisha source_data iliyolingana na block ya validation ya kila uwanja, ili injini yako ya hatari ipate uamuzi wazi, unaoweza kusomwa na mashine.

Kwa nini ni muhimu

Rekodi zinazoshikiliwa na serikali ndio chanzo chenye mamlaka zaidi cha kuthibitisha kuwa mtu yupo kwa utambulisho uliotajwa.

Kwa biashara zinazodhibitiwa nchini Afrika Kusini — fintechs, mifumo ya crypto, wakopeshaji, sokoni, na waendeshaji wa michezo ya kubahatisha — kuangalia dhidi ya chanzo chenye mamlaka hutoa rekodi inayoweza kutetewa, inayoweza kukaguliwa kwamba utambulisho ulithibitishwa kwenye chanzo, si tu kukusanywa kutoka kwa fomu au picha.

Maelezo ya kiufundi

Didit inaweka huduma hii wazi kupitia endpoint ya uthibitishaji wa hifadhidata iliyounganishwa. Ni POST moja — hakuna SDK inayohitajika.

Endpoint

POST /v3/database-validation/

Vigezo vya ombi

Kigezo	Aina	Inahitajika	Maelezo
issuing_state	string	Ndiyo	Msimbo wa nchi wa ISO 3166-1 alpha-3. Tumia ZAF.
services	string	Ndiyo	Kitambulisho cha huduma. Tumia zaf_refugee.
refugee_file_number	string	Ndiyo	Nambari ya faili ya mkimbizi.
phone_number	string	Hapana	Nambari ya simu (ukaguzi wa hiari).
email	string	Hapana	Barua pepe (ukaguzi wa hiari).

Mfano wa ombi

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_refugee" \
  -F "refugee_file_number=1111111"

Mfano wa jibu (kulingana na uhakika)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

Utendaji na bili

• Ucheleweshaji: kwa kawaida sekunde chache.
• Gharama: $1.10 kwa hoja yenye uhakika. Unatozwa tu kwa matokeo yenye uhakika — hakuna malipo kwa kukatika kwa chanzo, sehemu zinazokosekana, au kukataliwa kabla ya chanzo.
• Kuegemea: inaendeshwa kwenye miundombinu ya Didit na lengo la 99.9% la muda wa kufanya kazi kwa robo mwaka.

Matumizi

• Fintech & neobanks — thibitisha mmiliki halisi, anayeweza kuthibitishwa kabla ya kufungua mkoba au kutoa mkopo nchini Afrika Kusini.
• Crypto & Web3 — kukidhi mahitaji ya kuingiza VASP na uthibitisho wa utambulisho kutoka chanzo chenye mamlaka.
• Ukopeshaji — punguza utambulisho wa bandia na udanganyifu wa wahusika wa kwanza kwa data iliyothibitishwa na chanzo.
• Sokoni na mifumo ya gig — thibitisha watumiaji dhidi ya data yenye mamlaka, si tu fomu iliyoripotiwa mwenyewe.
• iGaming — kukidhi ukaguzi wa utambulisho na ustahiki kwa wachezaji wa Afrika Kusini na rekodi inayoweza kukaguliwa.

Jinsi ya kuunganisha na Didit

Unaweza kuendesha Uthibitishaji wa Faili ya Wakimbizi Afrika Kusini kwa njia mbili:

1. API ya moja kwa moja tu. Huduma hii inaendeshwa kupitia API badala ya mjenzi wa mtiririko wa kazi usio na msimbo.
2. API ya moja kwa moja. Piga endpoint /v3/database-validation/ iliyoonyeshwa hapo juu na services=zaf_refugee. Soma match_type na block ya validation ya kila uwanja ili kuendesha mantiki yako ya kuidhinisha / kukagua / kukataa.

Kila akaunti ya Didit inajumuisha uthibitishaji 500 bila malipo kwa mwezi, kwa hivyo unaweza kujaribu mtiririko kamili kutoka mwanzo hadi mwisho kabla ya kulipa kwa hoja moja.

Maswali yanayoulizwa mara kwa mara

Nini hundi ya Uthibitishaji wa Faili ya Wakimbizi Afrika Kusini inathibitisha?

Inathibitisha data iliyowasilishwa dhidi ya vyanzo vya data vya serikali vilivyo na mamlaka na hurudisha matokeo ya mechi yaliyorekebishwa, kwa hivyo unajifunza ikiwa rekodi za serikali zipo kwenye chanzo chenye mamlaka na ni sehemu gani zilizolingana.

Nini kinatokea ikiwa chanzo hakipatikani kwa muda?

Hautatozwa. Bili inatumika tu kwa matokeo yenye uhakika — kukatika kwa chanzo, sehemu zinazokosekana, na kukataliwa kabla ya chanzo ni bure.

Hundi ni ya haraka kiasi gani?

Uthibitishaji wa hifadhidata kwa kawaida hurudisha kwa sekunde chache, kwa hivyo inafaa ndani ya mtiririko wa wakati halisi wa kuingia.

Je, ninahitaji SDK?

Hapana. Hundi ni POST moja ya HTTPS kwenye endpoint moja.

Uko tayari kuanza?

Thibitisha rekodi zako za kwanza za serikali ya Afrika Kusini leo.

• Soma rejeleo la API: Uthibitishaji wa Faili ya Wakimbizi Afrika Kusini
• Angalia uthibitishaji wote wa hifadhidata: Bei na chanjo ya Uthibitishaji wa Hifadhidata
• Anza kujenga: Fungua akaunti ya bure ya Didit — uthibitishaji 500 kwa mwezi, bure.