Validasi Format NIK di HR Onboarding Tanpa Integrasi Dukcapil

Form onboarding karyawan hampir selalu meminta NIK. Tanpa integrasi resmi ke Dukcapil, tim HR tetap bisa menolak input yang jelas salah format dan mengisi field turunan (tanggal lahir, kode provinsi) secara otomatis dari digit NIK.

Endpoint POST /validasi/nik memeriksa panjang, digit, dan pola tanggal lahir pada NIK — lalu mengembalikan kode provinsi/kabupaten serta tanggal lahir yang ter-encode. Sertakan disclaimer di UI: ini validasi struktural, bukan bukti keabsahan identitas.

Endpoint

Method	Endpoint	Keterangan
POST	/nik	Validasi & parse NIK 16 digit

curl -X POST "https://use.apiindonesia.id/api/v1/validasi/nik" \
  -H "x-api-key: aip_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"nik":"3201010101900001"}'

import requests

def parse_nik_onboarding(nik: str) -> dict | None:
    r = requests.post(
        f"https://use.apiindonesia.id/api/v1/validasi/nik",
        json={"nik": nik},
        headers={"x-api-key": "aip_live_xxx"},
    )
    body = r.json()
    if not body.get("data", {}).get("valid"):
        return None
    return body["data"]

Contoh Response

{
  "data": {
    "valid": true,
    "province_code": "32",
    "birth_date": "1990-01-01"
  },
  "meta": {
    "disclaimer": "Validasi struktural saja..."
  }
}

Kasus Pakai di HRIS

• Pre-fill tanggal lahir dari NIK agar karyawan tidak mengetik ulang.
• Validasi sebelum payroll — NIK invalid ditolak sebelum masuk database gaji.
• Audit trail — simpan hasil parse + disclaimer di log onboarding.

FAQ

Bisakah mendeteksi NIK palsu? Tidak. Hanya format; keabsahan wajib lewat kanal resmi pemerintah.

Apakah gender bisa di-parse? Digit ke-7 mengindikasikan gender dan tanggal — detail ada di respons API.

Mulai Sekarang

Dapatkan API key gratis di dashboard.apiindonesia.id/register dan pelajari parameter lengkap di docs.apiindonesia.id.