Kesalahan Otentikasi NiceNIC API v2: Penyebab Umum dan Cara Memperbaikinya
Jika permintaan NiceNIC Reseller API v2 Anda mengembalikan kesalahan otentikasi, masalah biasanya berasal dari kredensial API, header Authatauization, pengaturan whitelist IP, akses reseller, atau lingkungan server yang mengirim permintaan.
Pdanuan ini menjelaskan penyebab yang paling umum dan memberikan daftar periksa praktis untuk reseller, penyedia hosting, pengembang, agensi, dan pengguna WHMCS untuk memperbaiki masalah otentikasi NiceNIC API v2 sebelum mengirim tiket dukungan.
Kesalahan otentikasi NiceNIC API v2 biasanya berarti permintaan API tidak dapat diverifikasi. Mulailah dengan memeriksa apakah akun Anda memiliki akses reseller, apakah Anda menggunakan kata sdani API bukan kata sdani login akun NiceNIC Anda, apakah header Authatauization difataumat dengan benar, dan apakah alamat IP keluar server Anda telah masuk whitelist di pengaturan API Anda.
Permintaan NiceNIC API v2 harus dikirimkan ke endpoint API dengan header HTTP yang diperlukan, termasuk header Authatauization dan Content-Tipe yang diatur ke application/json.
Apa Arti Kesalahan Otentikasi Ini Biasanya Kesalahan otentikasi API berarti NiceNIC tidak dapat memverifikasi permintaan API sebagai permintaan yang valid dari akun reseller yang berwenang. Ini tidak selalu berarti layanan API sedang down. Dalam kebanyakan kasus, berarti satu atau lebih kondisi akses tidak benar. Penyebab umum meliputi:
Anda menggunakan kata sdani login akun NiceNIC Anda alih-alih kata sdani API
Kata sdani API belum diatur dalam pengaturan API Anda
Header Authatauization hilang atau salah fataumat
Nama pengguna atau rahasia API salah
Permintaan dikirim dari alamat IP yang tidak masuk whitelist
IP server keluar asli Anda berbeda dari alamat IP yang Anda tambahkan
Akun Anda belum ditingkatkan ke tier reseller yang memenuhi syarat
Permintaan dikirim ke endpoint yang salah
Content-Tipe permintaan atau fataumat JSON salah
WHMCS menggunakan kredensial API yang usang, salah, atau tidak lengkap
Permintaan API Anda harus dikirim dari alamat IP server yang telah ditambahkan ke pengaturan API Anda. Kata sdani API Anda harus berbeda dari kata sdani login akun NiceNIC Anda.
Jika Anda menggunakan WHMCS, pastikan server WHMCS mengirim permintaan dari alamat IP keluar yang sama yang Anda tambahkan ke pengaturan API NiceNIC Anda.
Penyebab 1: Anda Menggunakan Kata Sdani Masuk Akun Alih-alih Kata Sdani API Ini adalah salah satu penyebab paling umum dari kesalahan otentikasi NiceNIC API. Kata sdani login akun NiceNIC Anda dan kata sdani API Anda tidak boleh sama. Kata sdani API harus dikonfigurasi secara terpisah di pengaturan API Anda.
Bagaimana cara memperbaikinya?
Masuk ke akun NiceNIC Anda.
Buka bagian Reseller.
Buka Pengaturan API.
Pukulur kata sdani API yang berbeda dari kata sdani login akun NiceNIC Anda.
Perbarui integrasi API atau konfigurasi WHMCS Anda dengan kata sdani API yang benar.
Penyebab 2: Header Authatauization Hilang atau Salah NiceNIC API v2 memerlukan header HTTP Authatauization. Fataumat yang didokumentasikan adalah: Authatauization: username:api_secret Jika header hilang, salah eja, dikodekan tidak benar, atau dikirim dalam fataumat yang salah, permintaan API mungkin gagal otentikasi.
Bagaimana cara memperbaikinya?
Pastikan permintaan Anda menyertakan header Authatauization.
Pastikan nama pengguna sudah benar.
Pastikan rahasia API adalah kata sdani API Anda, bukan kata sdani login akun Anda.
Periksa apakah ada spasi ekstra sebelum atau sesudah nama pengguna atau rahasia API.
Pastikan klien HTTP, framewatauk, atau modul WHMCS Anda tidak menghapus header Authatauization.
Pastikan server atau proxy Anda tidak memblokir header khusus.
Penyebab 3: Alamat IP Server Anda Tidak Masuk Whitelist Pengaturan API NiceNIC memerlukan alamat IP yang diizinkan mengakses API Anda. Jika permintaan Anda datang dari alamat IP yang belum ditambahkan, otentikasi mungkin gagal meskipun nama pengguna dan kata sdani API sudah benar.
Bagaimana cara memperbaikinya?
Minta pengembang atau penyedia hosting Anda untuk mengonfirmasi alamat IP keluar publik yang digunakan oleh server Anda.
Masuk ke akun NiceNIC Anda.
Pergi ke Reseller > Pengaturan API.
Tambahkan alamat IP yang benar yang diizinkan mengakses API Anda.
Simpan pengaturan.
Kirim permintaan uji lain dari server yang sama.
Penyebab 4: IP Keluar Nyata Anda Berbeda dari IP yang Anda Tambahkan Alamat IP yang Anda lihat di panel kontrol hosting Anda tidak selalu sama dengan alamat IP yang digunakan untuk permintaan API keluar. Ini terutama umum terjadi ketika sistem Anda berjalan di belakang:
Firewall
Load balancer
Proxy
Gateway NAT
Lingkungan containerized
Jaringan hosting cloud
Server WHMCS terpisah
Misalnya, situs web Anda mungkin menggunakan satu alamat IP, sementara server backend atau instalasi WHMCS Anda mengirim permintaan API melalui alamat IP keluar yang berbeda. Bagaimana cara memperbaikinya?
Minta penyedia hosting Anda mengonfirmasi alamat IP keluar nyata yang digunakan untuk permintaan API.
Periksa IP keluar dari server yang mengirim permintaan API, bukan hanya IP situs web.
Jika WHMCS terinstal di server terpisah, whitelist IP keluar server WHMCS.
Jika infrastruktur Anda memiliki beberapa alamat IP keluar, pastikan alamat IP mana yang sebenarnya digunakan oleh permintaan API.
Perbarui pengaturan NiceNIC API Anda dengan alamat IP yang benar.
Penyebab 5: Akun Anda Belum Memenuhi Syarat untuk Akses API Akses API NiceNIC dirancang untuk pengguna reseller yang memenuhi syarat. Jika akun Anda belum ditingkatkan ke tingkat reseller, atau jika akses reseller belum diaktifkan untuk akun Anda, pengaturan API mungkin tidak tersedia atau otentikasi API mungkin gagal.
Bagaimana cara memperbaikinya?
Pastikan akun NiceNIC Anda telah ditingkatkan ke tingkat reseller.
Periksa apakah Pengaturan API tersedia di bawah navigasi Reseller.
Tinjau program reseller dan infataumasi tingkat reseller.
Hubungi dukungan NiceNIC jika peningkatan reseller Anda sudah selesai tetapi akses API masih tidak tersedia.
Penyebab 6: Permintaan Anda Dikirim ke Endpoint yang Salah NiceNIC API v2 permintaan harus dikirim ke endpoint API v2 yang didokumentasikan.
Jika kode Anda menggunakan endpoint lama, URL yang salah, kurang tdana slash, atau versi API berbeda, otentikasi atau penanganan permintaan bisa gagal. Bagaimana cara memperbaikinya?
Pastikan integrasi Anda mengarah ke https://api.NiceNIC/v2/.
Periksa apakah ada endpoint staging, sdanbox, atau lama yang masih dikonfigurasikan dalam kode Anda.
Periksa apakah WHMCS atau modul kustom Anda menggunakan endpoint saat ini.
Tinjau log server Anda untuk memastikan URL yang tepat sedang diminta.
Penyebab 7: Content-Tipe atau Fataumat JSON Salah NiceNIC API v2 mengembalikan respons JSON dan mengharapkan permintaan API mengikuti fataumat permintaan yang didokumentasikan. Permintaan Anda harus menyertakan: Content-Tipe: application/json
Jika isi permintaan tidak berupa JSON valid, parameter yang diperlukan hilang, atau Content-Tipe tidak diatur dengan benar, permintaan API bisa gagal sebelum tindakan yang dimaksud diproses. Bagaimana cara memperbaikinya?
Pukulur Content-Tipe ke application/json.
Pastikan isi permintaan adalah JSON yang valid.
Pastikan parameter yang diperlukan disertakan.
Pastikan nama parameter sesuai dengan dokumentasi API.
Periksa apakah klien HTTP Anda mengubah fataumat isi permintaan.
Catat fataumat permintaan selama pengujian, tapi jangan pernah mencatat kredensial API lengkap dalam teks biasa.
Penyebab 8: Kredensial API WHMCS Tidak Dikonfigurasi dengan Benar Jika Anda menggunakan WHMCS, kesalahan otentikasi mungkin berasal dari konfigurasi modul registrar WHMCS daripada kode API kustom Anda.
Penyebab umum terkait WHMCS meliputi:
Modul WHMCS menggunakan kata sdani API yang salah
IP keluar server WHMCS tidak masuk whitelist
Nama pengguna atau nilai akun reseller dimasukkan dengan salah
Instalasi WHMCS menggunakan detail konfigurasi yang usang
Cron WHMCS atau lingkungan modul mengirim permintaan dari server berbeda
Pengaturan modul WHMCS diubah tapi tidak disimpan dengan benar
Bagaimana cara memperbaikinya
Buka pengaturan modul registrar WHMCS Anda.
Pastikan nama pengguna API NiceNIC dan kata sdani API sudah benar.
Pastikan IP keluar server WHMCS masuk whitelist di pengaturan API NiceNIC.
Periksa apakah WHMCS menggunakan detail integrasi API NiceNIC saat ini.
Uji tindakan berisiko rendah seperti pemeriksaan ketersediaan domain sebelum mengaktifkan pesanan langsung.
Pastikan isi permintaan Anda adalah JSON yang valid.
Pastikan alamat IP keluar server masuk whitelist.
Jika menggunakan WHMCS, pastikan IP keluar server WHMCS.
Uji tindakan API risiko rendah terlebih dahulu.
Catat cap waktu permintaan, aksi, domain, kode respons, dan pesan respons.
Apa yang Harus Dikirim ke Dukungan NiceNIC Jika Anda Masih Membutuhkan Bantuan Jika kesalahan otentikasi berlanjut setelah Anda menyelesaikan daftar periksa, kirim tiket dukungan dengan infataumasi teknis yang cukup agar NiceNIC dapat meninjau masalah secara efisien.
Harap sertakan: Nama pengguna akun NiceNIC Anda atau pengenal akun reseller Aksi API yang Anda coba lakukan Timestamp permintaan dan zona waktu Nama domain yang digunakan dalam pengujian, jika berlaku Alamat IP keluar server yang digunakan untuk permintaan Endpoint API lengkap yang diminta Kode respons dan pesan respons yang dikembalikan oleh API Apakah Anda menggunakan kode kustom atau WHMCS Versi WHMCS Anda, jika WHMCS terlibat Screenshot relevan, kecuali kredensial sensitif
FAQ Mengapa permintaan NiceNIC API v2 saya mengembalikan kesalahan otentikasi? Penyebab paling umum adalah kata sdani API salah, header Authatauization yang hilang atau salah, alamat IP server tidak masuk whitelist, IP keluar salah, akses reseller yang tidak memenuhi syarat, endpoint yang salah, atau konfigurasi WHMCS yang salah.
Apakah saya boleh menggunakan kata sdani login akun NiceNIC untuk otentikasi API? Tidak. Anda harus mengatur kata sdani API terpisah di pengaturan API Anda. Kata sdani API harus berbeda dari kata sdani login akun NiceNIC Anda.
Header Authatauization apa yang harus saya gunakan untuk NiceNIC API v2? Fataumat header Authatauization yang didokumentasikan adalah username:api_secret. Anda juga harus menyertakan Content-Tipe: application/json dalam header permintaan.
Mengapa API masih gagal setelah saya mengatur kata sdani yang benar? Permintaan mungkin datang dari alamat IP yang tidak masuk whitelist. Konfirmasikan alamat IP keluar nyata dari server Anda, instalasi WHMCS, atau aplikasi backend.
Apakah WHMCS menggunakan IP server yang sama dengan situs saya? Tidak selalu. WHMCS bisa jadi terpasang di server berbeda, di balik proxy, atau dalam lingkungan dengan IP keluar berbeda. Konfirmasikan IP keluar sebenarnya sebelum menambahkannya ke pengaturan API NiceNIC Anda.
Apakah NiceNIC dapat memperbaiki kesalahan otentikasi yang disebabkan oleh konfigurasi server saya? NiceNIC dapat membantu meninjau akses sisi registrar, pengaturan API, dan persyaratan koneksi yang didokumentasikan. Masalah sisi server seperti aturan firewall, routing IP keluar, perilaku proxy, konfigurasi modul WHMCS, dan kode kustom mungkin perlu diperiksa oleh pengembang atau penyedia hosting Anda.
Apa yang harus saya uji pertama kali setelah memperbaiki masalah otentikasi? Mulailah dengan tindakan API berisiko rendah seperti pemeriksaan saldo akun, pemeriksaan ketersediaan domain, pencarian harga, atau pengambilan daftar domain sebelum mengaktifkan alur kerja pendaftaran langsung, perpanjangan, atau transfer.
Butuh bantuan? Kami selalu siap membantu Anda.Kirim Tiket