Ajukan pencantuman nomor telepon dalam direktori

Ajukan pencantuman dalam direktori operator

Kirimkan nama dan alamat yang akan digunakan untuk mencantumkan nomor telepon milik Anda yang memenuhi syarat di MultiTEL dalam direktori. Ini adalah pembaruan berbayar pada operator, bukan pencarian nama penelepon, entri buku alamat pribadi, atau pembaruan umum pada kolom inventaris LIDB di portal.

Kirimkan hanya informasi yang telah diizinkan pelanggan untuk dicantumkan dalam direktori. Pastikan operator mendukung nomor tersebut sebelum menggunakan rute lama ini. Penangan yang ditinjau tidak memvalidasi kelayakan penyedia atau format nomor internasional; permintaannya kepada operator mengasumsikan nomor Amerika Utara dan menghapus digit pertama yang tersimpan.

Persyaratan akun dan nomor

Gunakan akun API yang diaktifkan melalui HTTPS dari alamat IP sumber yang diizinkan. Nomor yang persis sama harus tercatat sebagai baris nomor yang dibeli dan tidak dibatalkan, serta menjadi milik akun tersebut. Gunakan seluruh digit nomor internasional dalam inventaris Anda, misalnya format dengan kode negara 1 untuk nomor Amerika Utara yang didukung. Jangan gunakan ID paket harga, UUID nomor, atau nomor milik akun lain.

Permintaan POST formulir

Tetapkan NUMBER ke nomor milik Anda. Ganti contoh fiktif dengan informasi pencantuman yang telah diizinkan. Rute ini membaca kolom formulir dari POST; rute ini tidak mengurai badan permintaan application/json.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "lastname=EXAMPLE" \
  --data-urlencode "firstname=EXAMPLE" \
  --data-urlencode "streetnum=1" \
  --data-urlencode "streetname=Example" \
  --data-urlencode "streetpredir=N" \
  --data-urlencode "streetpostdir=W" \
  --data-urlencode "city=Example City" \
  --data-urlencode "state=NY" \
  --data-urlencode "postalcode=10001" \
  "https://api.multitel.net/v3/directory/$NUMBER"

Arah dan alamat dalam contoh hanyalah isian contoh, bukan alamat pos yang disarankan. Jangan tambahkan arah fiktif pada data pelanggan yang sebenarnya. Pemeriksaan kolom wajib oleh API bersifat terbatas: pemeriksaan tersebut tidak memastikan bahwa alamat valid atau diterima operator, dan situs web lama menerapkan persyaratan formulir yang berbeda.

Implementasi ini dapat mengeluarkan peringatan kunci larik yang tidak ditemukan ketika komponen arah opsional tidak ada atau kosong. Jika respons tidak terbentuk dengan benar atau operator menolak alamat, simpan referensi permintaan dan minta tim dukungan memastikan pencantuman tersebut, alih-alih berulang kali mengirimkan tebakan alamat yang diubah-ubah.

Perilaku pembebanan biaya dan percobaan ulang

Penangan yang ditinjau memeriksa ketersediaan setidaknya 10.00 satuan saldo sebelum menghubungi operator. Setelah operator melaporkan keberhasilan dan pembaruan nomor lokal melaporkan keberhasilan, penangan tersebut memotong 10.00 dari saldo akun dan mencatat transaksi penyiapan direktori. Ini adalah jumlah yang saat ini diterapkan, bukan usulan harga baru; sebelum mengajukan, pastikan mata uang penagihan yang berlaku dan layanan yang didukung sesuai dengan ketentuan akun Anda.

Operasi ini tidak memiliki kunci idempotensi, pencegah pesanan duplikat, atau transaksi yang mencakup pengajuan ke operator, pembaruan lokal, dan penagihan. Permintaan berulang yang berhasil dapat menyebabkan pengajuan lain ke operator dan biaya tambahan. Batas waktu yang terlampaui atau kesalahan API tidak membuktikan bahwa operator menolak permintaan sebelumnya: penyedia mungkin telah menerimanya sebelum pembaruan lokal gagal.

Respons

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": ""
}

Respons sukses yang normal memiliki string kosong pada response dan tidak mengembalikan ID pencantuman atau rincian penyelesaian. Artinya, alur operator dan pembaruan lokal melaporkan keberhasilan; hal ini tidak membuktikan publikasi di setiap direktori eksternal, penyebaran pembaruan secara langsung, atau tampilan identitas penelepon pada masa mendatang.

Kesalahan pada sistem lama

Baca status HTTP dan juga nilai JSON status.code/status.msg. Autentikasi dan pembatasan IP sumber juga dapat menghalangi diterimanya respons yang dapat digunakan. Jangan gunakan GET atau parameter kueri untuk meminta pembaruan hanya karena penangan lama tidak memiliki pembatas metode HTTP yang eksplisit.

Verifikasi sebelum mencoba lagi

1. Pastikan nomor milik Anda, kelayakan operator, data pencantuman yang telah diizinkan, dan biaya sebelum mengirim permintaan.
2. Ajukan sekali dan simpan hasil di sisi akun tanpa mengungkapkan alamat pelanggan dalam log publik atau analitik.
3. Periksa pencantuman yang tersimpan dan riwayat transaksi melalui alur akun yang didukung atau tim dukungan. Tunggu selama waktu pemrosesan yang telah dikonfirmasi operator; API ini tidak menetapkan tenggat penyebaran pembaruan yang dijamin.
4. Jika hasilnya belum pasti, minta tim dukungan merekonsiliasi pesanan operator dan penagihan lokal sebelum mencoba lagi. Permintaan berulang bukanlah pemeriksaan status yang idempoten.