Integrasi CNAM

Referensi API REST CNAM

Minta nama penelepon melalui HTTPS dan tangani hasil, biaya, dan kesalahannya.

Pilih perilaku pencarian

Tingkatan	Harga publik per kueri	Fungsinya
Starter	US$0,0026	Menggunakan informasi nama penelepon milik sendiri dan yang di-cache.
Standard	US$0,0037	Melakukan pencarian jaringan secara real-time untuk setiap kueri.
Mixed	US$0,004	Mencoba pencarian real-time terlebih dahulu, lalu beralih ke data Starter jika tidak ada nama yang ditemukan.

Layanan yang dipilih menentukan perilaku pencarian; Mixed bukan pencarian yang mengutamakan cache. Tinjau tarif yang ditetapkan untuk akun Anda sebelum digunakan di produksi. Nama penelepon bukan bukti identitas atau kepemilikan.

Kirim pencarian terautentikasi

Endpoint: GET https://api.multitel.net/v3/cnam/NUMBER. Tuliskan nomor telepon dalam format internasional, hanya berupa angka dan termasuk kode negara, tanpa tanda baca atau tanda plus di depan. Jalankan dari server aplikasi Anda menggunakan kredensial API yang disetujui.

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  "https://api.multitel.net/v3/cnam/12025550123"

Sediakan kedua variabel lingkungan melalui konfigurasi rahasia di sisi server. Kredensial bearer yang disediakan hanya menjadi alternatif jika akses tersebut diaktifkan dan pembatasan IP sumbernya terpenuhi. Jangan pernah menaruh rahasia API ke dalam bundel browser publik.

Panduan autentikasi API dan permintaan pertama

Baca respons JSON

Respons ini hanya ilustrasi. Nama dan biaya yang dikembalikan bergantung pada pencarian dan layanan yang dipilih.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE CALLER",
    "cost": "0.004",
    "balance": "24.9960"
  }
}

status.code: Kode hasil aplikasi; normalkan nilai string/numerik sebelum membandingkannya dengan 200.
status.msg: Pesan hasil atau penolakan yang menyertainya.
response.number: Nomor yang dikueri.
response.name: Nama penelepon yang tersedia.
response.cost: Biaya yang dilaporkan untuk kueri ini; perlakukan sebagai jumlah desimal.
response.balance: Saldo akun yang dilaporkan, bila ada.

Hasil tanpa nama dan kesalahan

Permintaan yang berhasil tidak menjamin nama penelepon yang berguna. Tangani nama kosong, nomor yang dikembalikan sebagai pengganti nama, dan pencarian yang ditolak. Kode aplikasi 403 dapat menggambarkan kredit yang tidak mencukupi, pembelian yang dilarang, atau nomor tanpa hasil; periksa pesannya.

Periksa status HTTP dan status JSON sebelum mengakses response.name. Objek respons mungkin tidak ada saat terjadi kesalahan. Nama yang hilang tidak boleh menghalangi panggilan normal untuk dirutekan.

Penagihan, percobaan ulang, dan perbedaannya dengan memperbarui ID penelepon

Pencarian baru dapat menimbulkan biaya kueri. Antarmuka pencarian ini tidak mendokumentasikan kunci idempotensi, sehingga percobaan ulang yang baru dapat menjadi kueri berbayar kedua. Gunakan backoff terbatas untuk kegagalan transport/layanan, selesaikan kesalahan akun terlebih dahulu, dan rekonsiliasi biaya kueri yang dilaporkan. Lakukan cache hanya selama periode yang sesuai untuk aplikasi Anda; data nama penelepon dapat berubah.

Pencarian CNAM membaca sebuah nama. Pencarian ini tidak mengubah nama yang ditampilkan pada panggilan keluar Anda. Pembaruan nama penelepon LIDB adalah operasi terpisah dengan kolom, otorisasi, harga, dan pemrosesannya sendiri.

Panduan integrasi CNAM akun Dapatkan bantuan integrasi