Langsung ke konten utama
POST
Memverifikasi kredensial ID pemilih INE / IFE Meksiko terhadap registri INE (modelo, vigencia, válida-como-identificación, derecho-a-votar). Didit menyediakan layanan ini melalui POST /v3/database-validation/ sehingga Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil pencocokan yang ternormalisasi.

Cakupan

  • Cakupan: —
  • Negara: Meksiko
  • ID layanan: mex_ine_vigencia
  • Domain data: Identitas
  • Kategori: NationalIDRegistry

Input

  • Input wajib: —
  • Input opsional: cic, identificador_ciudadano, ocr, voter_number, emission_number, first_name, last_name, date_of_birth, vendor_data
  • Persetujuan: Tidak diperlukan
  • Ketersediaan alur kerja: Tersedia dalam alur kerja
  • Cakupan: —
  • Harga: $0.20 per kueri yang berhasil

Parameter body

string
default:"MEX"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: MEX
string
default:"mex_ine_vigencia"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya berlaku untuk database yang tepat ini.Contoh: mex_ine_vigencia
string
default:"123456789"
Nilai cic yang dibutuhkan oleh layanan database ini.Contoh: 123456789
string
Nilai identificador_ciudadano yang dibutuhkan oleh layanan database ini.Contoh: 123456789
string
Nilai ocr yang dibutuhkan oleh layanan database ini.Contoh: 1234567890123
string
Nilai voter_number yang dibutuhkan oleh layanan database ini.Contoh: ABCDEF123456
string
Nilai emission_number yang dibutuhkan oleh layanan database ini.Contoh: 01
string
Nama depan yang akan divalidasi.Contoh: John
string
Nama keluarga yang akan divalidasi.Contoh: Doe
string
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
string
default:"user-1234"
Referensi pengguna yang stabil untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi noise deteksi duplikat.Contoh: user-1234

Aturan input & catatan validasi

  • Berikan setidaknya satu pengenal kredensial: cic, identificador_ciudadano, ocr, atau voter_number. Jika semua kolom tersebut tidak diberikan, Didit mengembalikan HTTP 400 beserta kolom yang diterima, tanpa memanggil penyedia. Permintaan yang ditolak sebelum pencarian ke sumber tidak dikenai biaya.
  • Untuk kredensial lama yang diidentifikasi dengan voter_number, sertakan emission_number.
  • Penolakan dari penyedia tetap berupa validasi HTTP 200 yang telah selesai dan membawa hasil ternormalisasi yang sebenarnya. Misalnya, kode penyedia 4 dikembalikan sebagai outcome_code: "INVALID_DOCUMENT_FORMAT", outcome_detail: "4", dan source_data.message: "Error de datos". Gunakan kolom-kolom ini alih-alih memperlakukan setiap penolakan sebagai error ketersediaan umum.
  • Kode penyedia 0 berarti kredensial yang dikirim tidak ditemukan. Kode ini dikembalikan sebagai outcome_code: "DOCUMENT_NOT_FOUND", dengan outcome_detail: "0" dan penjelasan asli di source_data.message.
  • Kode penyedia 1 dan 10 berarti data kredensial yang dikirim tidak cocok dengan catatan INE. Kode ini dikembalikan sebagai outcome_code: "NO_MATCH", dengan kode penyedia di outcome_detail dan penjelasan asli di source_data.message.

Cara memanggilnya

Data yang dikembalikan

Kolom yang tepat yang ditampilkan di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk mex_ine_vigencia saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • emission_number
  • emission_year
  • expiration_date
  • federal_district
  • identification_number
  • message
  • message_code
  • ocr
  • registration_year
  • validation_code
  • voter_number

Harga & SLA

Kueri verifikasi masa berlaku kredensial INE Meksiko hanya ditagih ketika Didit menerima hasil yang pasti dari sumber validasi.
  • Harga per panggilan: $0.20 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenai biaya ketika registri tidak dapat dijangkau, ketika kolom wajib tidak diisi, atau ketika permintaan ditolak sebelum mencapai sumber.
  • Latensi: p95 tipikal < 2 s.
  • Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber yang mendasarinya bervariasi menurut negara dan set data.

Lanjut membaca

Terakhir diubah pada 7 November 2026