Validasi Database Afrika Selatan - API Verifikasi Berkas Pengungsi

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 "vendor_data=user-1234" \
  -F "refugee_file_number=RF123456"

{
  "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"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

POST

database-validation

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 "vendor_data=user-1234" \
  -F "refugee_file_number=RF123456"

{
  "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"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

Memverifikasi nomor berkas pengungsi terhadap registri pengungsi Departemen Urusan Dalam Negeri Afrika Selatan. Didit menyediakan layanan ini melalui POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim terhadap sumber resmi dan menerima hasil pencocokan yang sudah dinormalisasi.

Cakupan

Cakupan: —
Negara: Afrika Selatan
ID layanan: zaf_refugee
Domain data: Identitas
Kategori: Pemerintah

Input

Kolom	Wajib	Contoh
`refugee_file_number`	Ya	`RF123456`
`phone_number`	Tidak	`+15550101000`
`email`	Tidak	`john.doe@example.com`
`vendor_data`	Tidak	`user-1234`

Input wajib: refugee_file_number
Input opsional: phone_number, email, vendor_data
Persetujuan: Tidak diperlukan
Ketersediaan alur kerja: Tersedia dalam alur kerja dengan pemetaan kolom
Cakupan: —
Harga: $1.28 per kueri yang berhasil

Dalam alur kerja, refugee_file_number tidak tercetak pada dokumen identitas, sehingga tidak ada langkah yang menghasilkannya sendiri. Kumpulkan nilainya dari jawaban Kuesioner, kolom hasil ekstraksi Document AI, atau nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database. Sampai nilai tersebut dipetakan, editor alur kerja menampilkan layanan ini dalam keadaan nonaktif dan menyebutkan input yang belum ada. Saat dijalankan, input yang hilang berarti pemeriksaan dilewati sebelum kueri apa pun, sehingga Anda tidak pernah ditagih untuk database yang tidak dapat dikueri.

Parameter body

string

default:"ZAF"

wajib

Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: ZAF

string

default:"zaf_refugee"

wajib

Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya mengarah ke database yang tepat ini.Contoh: zaf_refugee

string

default:"RF123456"

wajib

Nilai refugee_file_number yang diperlukan oleh layanan database ini.Contoh: RF123456

string

Nilai phone_number yang diperlukan oleh layanan database ini.Contoh: +15550101000

string

Alamat email.Contoh: john.doe@example.com

string

default:"user-1234"

Referensi pengguna Anda yang stabil untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan mandiri ke pengguna akhir yang sama dan mengurangi gangguan deteksi duplikat.Contoh: user-1234

Aturan input & catatan validasi

Kirim kolom yang tercantum di atas persis seperti yang diambil dari pengguna atau dokumen.
Didit memvalidasi kolom wajib sebelum memanggil database. Permintaan yang ditolak sebelum pencarian ke sumber tidak dikenai biaya.

Cara memanggil

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 "vendor_data=user-1234" \
  -F "refugee_file_number=RF123456"

Setiap panggilan yang berhasil mengembalikan HTTP 200. Kolom outcome_code menunjukkan apa yang sebenarnya terjadi, misalnya membedakan ketidakcocokan biometrik yang sebenarnya (BIOMETRIC_NO_MATCH) dari swafoto yang tidak dapat dibaca (BIOMETRIC_IMAGE_UNUSABLE). status yang ditampilkan adalah status fitur default. Tindakan Kecocokan Sebagian / Tidak Cocok yang Anda konfigurasi dapat menggantinya.

MATCH — Registri mengonfirmasi identitas dan setiap kolom yang diperiksa cocok.

{
  "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"
      }
    }
  ]
}

NO_MATCH — Registri tidak mengembalikan kecocokan untuk data yang dikirim.

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

Data yang dikembalikan

Kolom yang muncul di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk zaf_refugee saat ini mendokumentasikan struktur ternormalisasi berikut:

Bervariasi menurut respons registri.

Harga & SLA

Kueri Verifikasi Berkas Pengungsi Afrika Selatan hanya ditagihkan ketika Didit menerima hasil yang konklusif dari sumber validasi.

Harga per panggilan: $1.28 USD.
Penagihan: per kueri yang berhasil. Anda tidak ditagih ketika registri tidak dapat dijangkau, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
Latensi: p95 tipikal < 2 s.
Ketersediaan: 99.9% per kuartal di pihak Didit; ketersediaan sumber downstream bervariasi menurut negara dan dataset.

Lanjutkan membaca

Terakhir diubah pada 7 November 2026

​Cakupan

​Input

​Parameter body

​Aturan input & catatan validasi

​Cara memanggil

​Data yang dikembalikan

​Harga & SLA

​Lanjutkan membaca

Cakupan

Input

Parameter body

Aturan input & catatan validasi

Cara memanggil

Data yang dikembalikan

Harga & SLA

Lanjutkan membaca