Langsung ke konten utama
POST
curl
Didit Address Validation API memastikan bahwa sebuah alamat pos ada, lalu mengembalikannya dalam bentuk yang sudah dinormalisasi, lengkap dengan baris pengiriman, komponen, dan koordinatnya. Gunakan POST /v3/address-validation/ ketika backend Anda memiliki sebuah alamat dan perlu mengetahui apakah alamat itu ada, serta dalam bentuk normalisasi apa. Address Validation hanya memastikan alamatnya. Layanan ini tidak pernah mengaitkan alamat dengan seseorang: hasil verified berarti tempatnya ada, bukan berarti ada orang yang tinggal di sana.

Kirim alamat

Kirim alamat dalam satu baris di address, atau sebagai kolom terstruktur: address_line_1 dan, jika Anda memilikinya, address_line_2, city, region, dan postal_code. Jangan pernah mengirim kedua bentuk tersebut dalam satu permintaan. country selalu wajib diisi, dalam kode ISO 3166-1 alpha-2 atau alpha-3.

Menafsirkan respons

  • address_validation.status adalah jawaban yang menjadi dasar keputusan Anda:
    • verified: alamat dikonfirmasi sampai ke tingkat gedung (atau unit apartemen atau kotak pos).
    • partially_verified: alamat hanya dikonfirmasi sampai ke tingkat jalan, atau sampai tingkat paling presisi yang dimiliki data referensi pos untuk tempat tersebut.
    • not_verified: hanya wilayah atau kota yang cocok, atau tidak ada yang cocok.
    • unavailable: validasi tidak dapat dijalankan. Coba lagi nanti.
  • address_validation.verification_level adalah tingkat paling presisi yang cocok: administrative_area, locality, thoroughfare, premise, atau delivery_point.
  • address_validation.address dan address_validation.formatted_address memuat alamat yang sudah dinormalisasi, ditulis sesuai cara negara tersebut menulis alamat.
  • address_validation.latitude dan address_validation.longitude menunjukkan lokasi alamat yang cocok.
  • request_id mengidentifikasi permintaan. Tidak ada sesi yang dibuat dan hasilnya hanya dikembalikan dalam respons ini, jadi simpan apa pun yang Anda butuhkan.
HTTP-nya adalah 200 untuk setiap permintaan yang selesai, termasuk unavailable.

Address Validation di dalam alur kerja

Pemeriksaan yang sama tersedia sebagai add-on pada langkah alur kerja Verifikasi Identitas dan Bukti Alamat. Aktifkan address_validation_enabled di pengaturan langkah tersebut, dan alamat yang diberikan pengguna (tercetak pada dokumen identitas, atau pada bukti alamat) akan divalidasi satu kali setelah unggahannya dibaca. Hasilnya berupa objek address_validation dalam entri langkah tersebut pada keputusan sesi (id_verifications[] atau poa_verifications[]). Alamat dengan status partially_verified atau not_verified memunculkan peringatan ADDRESS_NOT_VERIFIED, yang tindakannya mengikuti address_not_verified_action pada langkah tersebut (secara default NO_ACTION, yang hanya mencatat peringatan). Validasi dengan status unavailable tidak pernah memunculkan peringatan tersebut dan tidak pernah mengubah verifikasi.

Perilaku sandbox

Kunci sandbox memvalidasi permintaan dan selalu mengembalikan hasil verified yang deterministik, yang mengembalikan alamat yang Anda kirim. Kunci sandbox tidak menggunakan kredit.

Penagihan

Satu panggilan Address Validation API dikenakan biaya $0.10 per alamat yang divalidasi. Hasil `unavailable` tidak dikenakan biaya. Dalam alur kerja, add-on dikenakan biaya $0.10 per alamat yang divalidasi oleh sebuah langkah.

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Body

application/json

Satu alamat: dalam satu baris (address) atau sebagai kolom terstruktur dengan setidaknya address_line_1, tidak boleh keduanya.

country
string
wajib

Kode ISO 3166-1 alpha-2 atau alpha-3 dari negara alamat.

Maximum string length: 3
Contoh:

"US"

address
string

Seluruh alamat dalam satu baris.

Maximum string length: 500
Contoh:

"Paseo de la Castellana 259, 28046 Madrid"

address_line_1
string

Jalan dan nomor.

Maximum string length: 255
Contoh:

"1600 Amphitheatre Pkwy"

address_line_2
string

Apartemen, suite, lantai, atau gedung.

Maximum string length: 255
city
string

Kota atau lokalitas.

Maximum string length: 128
Contoh:

"Mountain View"

region
string

Negara bagian, provinsi, atau wilayah.

Maximum string length: 128
Contoh:

"CA"

postal_code
string
Maximum string length: 32
Contoh:

"94043"

Respons

Validasi selesai. Baca address_validation.status; HTTP selalu 200 untuk permintaan yang selesai.

request_id
string<uuid>
wajib

Pengenal permintaan ini; kutip ke tim dukungan. Tidak ada sesi yang dibuat.

address_validation
object
wajib

Hasil dari satu Validasi Alamat: apakah alamat tersebut ada, dan bentuk yang telah dinormalisasi. Ini hanya mengonfirmasi alamat; ini tidak pernah menautkan alamat ke seseorang.

created_at
string<date-time>
wajib
Terakhir diubah pada 7 November 2026