Cari nama penelepon

Dapatkan hasil nama penelepon yang tersedia untuk suatu nomor telepon. Pencarian ini dijalankan di lingkungan produksi dan dapat membebankan biaya ke akun Anda, termasuk jika hasilnya berasal dari tembolok layanan. Pencarian ini tidak mengubah nama panggilan keluar untuk nomor milik Anda.

Nama yang dikembalikan bukan bukti identitas, kepemilikan, atau izin menelepon yang telah diverifikasi. Nama mungkin tidak tersedia, sudah kedaluwarsa, disingkat, berupa label geografis, atau diganti dengan nomor telepon.

Permintaan

Gunakan akun API Anda yang telah diaktifkan dari alamat IP sumber yang diizinkan. Simpan kredensial di penyimpanan rahasia pada sisi server. Contoh ini menggunakan variabel lingkungan dan nomor fiktif Amerika Utara; jangan tempatkan kredensial dalam URL atau kode peramban yang dapat diakses publik.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cnam/12025550123

Masukkan nomor lengkap berupa deretan angka termasuk kode negara, misalnya sebelas angka yang diawali dengan 1 untuk Amerika Utara. Jangan mengandalkan pemroses permintaan untuk menormalkan tanda baca atau tanda tambah. Isi permintaan maupun pemilih wilayah tidak diperlukan. Konfirmasikan cakupan yang didukung kepada MultiTEL untuk penggunaan yang Anda rencanakan.

Respons

Nilai hanya sebagai ilustrasi; biaya tersebut bukan penawaran harga.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE NAME",
    "cost": 0.0037,
    "balance": 9.9963
  }
}

Kolom pencarian nama penelepon
Kolom	Arti
number	Nomor yang diminta.
name	Nama yang tersedia atau teks pengganti. Ini bukan verifikasi identitas.
cost	Harga pencarian yang dikonfigurasi untuk akun atau layanan dan dilaporkan oleh alur ini. Gunakan tarif akun saat ini, bukan nilai ilustrasi.
balance	Saldo yang dihitung untuk respons. Ini bukan hasil kueri transaksional terbaru atas saldo akun.

Biaya dan rekonsiliasi

Hasil yang memuat nama dikenai biaya sesuai harga CNAM yang dikonfigurasi untuk akun. Pencarian berulang atau pencarian dari tembolok dapat menimbulkan biaya tambahan; tidak ada kunci idempotensi yang disediakan. Periksa tarif akun saat ini sebelum mengaktifkan pencarian otomatis.

Ada keterbatasan respons yang diketahui untuk nama kosong dalam tembolok: pemroses permintaan dapat mengembalikan kode API 200 dengan nama kosong, biaya bukan nol, dan saldo hasil perhitungan yang berkurang, meskipun cabang alur tersebut tidak mendebit akun. Jangan menganggap respons itu saja sebagai bukti pembebanan biaya. Lakukan rekonsiliasi dengan catatan penagihan akun dan hasil terbaru dari pencarian saldo, dan hubungi dukungan jika hasilnya tidak jelas.

Pemeriksaan prabayar saat ini mensyaratkan saldo minimal 0.004 sebelum pencarian, terlepas dari harga per kueri yang dikonfigurasi. Akun dengan pembelian yang dinonaktifkan juga ditolak. Pemeriksaan tersebut tidak menjadikan titik akhir ini sebagai API untuk penawaran harga atau pembatasan pengeluaran.

Kesalahan dan percobaan ulang

Periksa status HTTP dan status.code/status.msg dalam JSON. Kode API 403 dapat berarti kredit prabayar tidak mencukupi, pembelian dilarang, ada masalah otorisasi akun, atau nama penelepon tidak ditemukan. Alur tanpa nama dapat mengembalikan kode tersebut sebagai string. Periksa pesannya alih-alih menganggap setiap 403 sebagai kesalahan kredensial. Konflik konfigurasi dapat mengembalikan kode API 500.

Batas waktu dapat terlampaui setelah pencarian yang dikenai biaya. Gunakan percobaan ulang dalam jumlah terbatas dengan jeda yang meningkat hanya jika sesuai untuk aplikasi Anda, dan rekonsiliasikan terlebih dahulu percobaan yang hasilnya belum pasti. Jangan terus mengulangi permintaan untuk nomor yang ditolak atau kegagalan akibat izin maupun saldo akun. Tembolok respons di aplikasi Anda sendiri dapat mengurangi permintaan berulang, dengan tetap mematuhi perjanjian dan persyaratan akurasi Anda.

Operasi nomor lainnya

Operasi baca ini terpisah dari pembaruan nama panggilan keluar/LIDB, pencantuman dalam direktori, atau pendaftaran penelepon. Operasi tersebut memiliki kolom wajib, otorisasi, dan biaya masing-masing. Gunakan cakupan alokasi untuk memeriksa tabel prefiks atau pencarian nomor untuk melihat persediaan nomor yang dapat dipesan. Tidak satu pun dari operasi ini membuktikan bahwa identitas penelepon sesuai dengan pengakuannya.