Ralat Pengesahan NiceNIC API v2: Punca Biasa dan Penyelesaian
Jika permintaan NiceNIC Reseller API v2 dana mengembalikan ralat pengesahan, masalah biasanya berpunca dari kelayakan API, header Authatauization, tetapan senarai putih IP, akses penjual semula, atau persekitaran pelayan yang menghantar permintaan.
Pdanuan ini menerangkan punca paling biasa dan memberi penjual semula, penyedia hosting, pembangun, agensi, dan pengguna WHMCS senarai semak praktikal untuk memperbaiki isu pengesahan NiceNIC API v2 sebelum menghantar tiket.
Ralat pengesahan NiceNIC API v2 biasanya bermakna permintaan API tidak dapat disahkan. Mula dengan memeriksa sama ada akaun dana mempunyai akses penjual semula, sama ada dana menggunakan kata laluan API dan bukan kata laluan log masuk akaun NiceNIC dana, sama ada header Authatauization difataumat dengan betul, dan sama ada alamat IP keluar pelayan dana disenaraikan dalam tetapan API dana.
Permintaan NiceNIC API v2 harus dihantar ke titik akhir API dengan header HTTP yang diperlukan, termasuk header Authatauization dan Content-Jenis ditetapkan kepada application/json.
Maksud Biasa Ralat Pengesahan Ini Ralat pengesahan API bermakna NiceNIC tidak dapat mengesahkan permintaan API sebagai permintaan yang sah dari akaun penjual semula yang dibenarkan. Ini tidak selalu bermakna perkhidmatan API sedang tidak berfungsi. Dalam kebanyakan kes, ia bermakna satu atau lebih syarat akses tidak betul. Punca biasa termasuk:
Anda menggunakan kata laluan log masuk akaun NiceNIC dana dan bukan kata laluan API dana
Kata laluan API belum ditetapkan dalam tetapan API dana
Header Authatauization hilang atau difataumat dengan salah
Nama pengguna atau rahsia API tidak betul
Permintaan dihantar dari alamat IP yang tidak disenaraikan dalam senarai putih
IP keluar sebenar pelayan dana berbeza daripada alamat IP yang dana tambah
Akaun dana belum dinaik taraf ke tahap penjual semula yang layak
Permintaan dihantar ke titik akhir yang salah
Content-Jenis permintaan atau fataumat JSON tidak betul
WHMCS menggunakan kelayakan API yang ketinggalan zaman, salah, atau tidak lengkap
Permintaan API dana seharusnya dihantar dari alamat IP pelayan yang telah ditambah ke tetapan API dana. Kata laluan API dana harus berbeza daripada kata laluan log masuk akaun NiceNIC dana.
Jika dana menggunakan WHMCS, sahkan bahawa pelayan WHMCS menghantar permintaan dari alamat IP keluar yang sama yang dana tambah ke tetapan API NiceNIC dana.
Punca 1: Anda Menggunakan Kata Laluan Log Masuk Akaun Bukan Kata Laluan API Ini adalah salah satu punca paling biasa ralat pengesahan NiceNIC API. Kata laluan log masuk akaun NiceNIC dana dan kata laluan API dana tidak sepatutnya sama. Kata laluan API mesti dikonfigurasi secara berasingan dalam tetapan API dana.
Cara memperbaikinya?
Log masuk ke akaun NiceNIC dana.
Pergi ke bahagian Penjual Semula.
Buka Tetapan API.
Tetapkan kata laluan API yang berbeza daripada kata laluan log masuk akaun NiceNIC dana.
Kemas kini integrasi API dana atau konfigurasi WHMCS dengan kata laluan API yang betul.
Punca 2: Header Authatauization Hilang atau Salah NiceNIC API v2 memerlukan header HTTP Authatauization. Fataumat yang didokumentasikan ialah: Authatauization: username:api_secret Jika header hilang, tersilap eja, terenkod dengan salah, atau dihantar dalam fataumat yang salah, permintaan API mungkin gagal pengesahan.
Cara memperbaikinya?
Sahkan bahawa permintaan dana termasuk header Authatauization.
Sahkan bahawa nama pengguna adalah betul.
Sahkan bahawa rahsia API adalah kata laluan API dana, bukan kata laluan log masuk akaun dana.
Periksa sama ada terdapat ruang tambahan sebelum atau selepas nama pengguna atau rahsia API.
Sahkan bahawa klien HTTP, rangka kerja, atau modul WHMCS dana tidak membuang header Authatauization.
Sahkan bahawa pelayan atau proksi dana tidak menyekat header khusus.
Punca 3: Alamat IP Pelayan Anda Tidak Disenaraikan Tetapan NiceNIC API memerlukan alamat IP yang dibenarkan mengakses API dana. Jika permintaan dana datang dari alamat IP yang tidak ditambah, pengesahan mungkin gagal walaupun nama pengguna dan kata laluan API betul.
Cara memperbaikinya?
Minta pembangun atau penyedia hosting dana mengesahkan alamat IP keluar awam yang digunakan oleh pelayan dana.
Log masuk ke akaun NiceNIC dana.
Pergi ke Penjual Semula > Tetapan API.
Tambah alamat IP yang betul yang dibenarkan mengakses API dana.
Simpan tetapan.
Hantar permintaan ujian lain dari pelayan yang sama.
Punca 4: IP Keluar Sebenar Anda Berbeza dari IP yang Anda Tambah Alamat IP yang dana lihat dalam panel kawalan hosting dana tidak sentiasa sama dengan alamat IP yang digunakan untuk permintaan API keluar. Ini terutama biasa apabila sistem dana berjalan di belakang:
Penapis firewall
Pengimbang beban
Proksi
Gerbang NAT
Persekitaran bercontainer
Rangkaian hosting awan
Pelayan WHMCS berasingan
Contohnya, laman web dana mungkin menggunakan satu alamat IP, manakala pelayan backend dana atau pemasangan WHMCS menghantar permintaan API melalui alamat IP keluar yang berbeza. Cara memperbaikinya?
Minta penyedia hosting dana mengesahkan IP keluar sebenar yang digunakan untuk permintaan API.
Semak IP keluar dari pelayan yang menghantar permintaan API, bukan hanya IP laman web.
Jika WHMCS dipasang pada pelayan berasingan, senaraikan putih IP keluar pelayan WHMCS.
Jika infrastruktur dana mempunyai pelbagai alamat IP keluar, sahkan IP mana yang benar-benar digunakan oleh permintaan API.
Kemas kini tetapan NiceNIC API dana dengan alamat IP yang betul.
Punca 5: Akaun Anda Belum Layak untuk Akses API Akses NiceNIC API direka untuk pengguna penjual semula yang layak. Jika akaun dana belum dinaik taraf ke tahap penjual semula, atau jika akses penjual semula belum diaktifkan untuk akaun dana, tetapan API mungkin tidak tersedia atau pengesahan API mungkin gagal.
Cara memperbaikinya?
Sahkan bahawa akaun NiceNIC dana telah dinaik taraf ke tahap penjual semula.
Periksa sama ada Tetapan API tersedia di bawah navigasi Penjual Semula.
Semak program penjual semula dan maklumat tahap penjual semula.
Hubungi sokongan NiceNIC jika peningkatan penjual semula dana selesai tetapi akses API masih tidak tersedia.
Punca 6: Permintaan Anda Dihantar ke Titik Akhir Salah NiceNIC API v2permintaan harus dihantar ke titik akhir API v2 yang didokumentasikan.
Jika kod dana menggunakan titik akhir lama, URL yang salah, tiada slash, atau versi API yang berbeza, pengesahan atau pengendalian permintaan mungkin gagal. Cara memperbaikinya?
Sahkan bahawa integrasi dana menuju ke https://api.NiceNIC/v2/.
Periksa sama ada mana-mana staging, sdanbox, atau titik akhir lama masih dikonfigurasi dalam kod dana.
Periksa sama ada WHMCS atau modul khusus dana menggunakan titik akhir semasa.
Semak log pelayan dana untuk mengesahkan URL tepat yang diminta.
Punca 7: Content-Jenis atau Fataumat JSON Tidak Betul NiceNIC API v2 memulangkan respons JSON dan menjangkakan permintaan API mengikuti fataumat permintaan yang didokumentasikan. Permintaan dana harus merangkumi: Content-Jenis: application/json
Jika badan permintaan bukan JSON yang sah, parameter wajib hilang, atau Content-Jenis tidak ditetapkan dengan betul, permintaan API mungkin gagal sebelum tindakan yang dimaksudkan diproses.
{{/G252}}Cara memperbaikinya?
Tetapkan Content-Jenis kepada application/json.
Pastikan badan permintaan adalah JSON yang sah.
Sahkan bahawa parameter wajib disertakan.
Sahkan bahawa nama parameter sepadan dengan dokumentasi API.
Periksa sama ada klien HTTP dana mengubah fataumat badan permintaan.
Log fataumat permintaan semasa ujian, tetapi jangan sekali-kali log kelayakan API penuh dalam teks biasa.
Punca 8: Kelayakan API WHMCS Tidak Dikemaskini dengan Betul Jika dana menggunakan WHMCS, ralat pengesahan mungkin berpunca daripada konfigurasi modul pendaftar WHMCS dan bukan kod API khusus dana.
Punca biasa berkaitan WHMCS termasuk:
Modul WHMCS menggunakan kata laluan API yang salah
IP keluar pelayan WHMCS tidak disenaraikan
Nama pengguna atau nilai akaun penjual semula dimasukkan dengan salah
Pemasangan WHMCS menggunakan butiran konfigurasi yang ketinggalan zaman
Persekitaran cron atau modul WHMCS menghantar permintaan dari pelayan lain
Tetapan modul WHMCS diubah tetapi tidak disimpan dengan betul
Cara memperbaikinya
Buka tetapan modul pendaftar WHMCS dana.
Sahkan nama pengguna API NiceNIC dan kata laluan API.
Sahkan IP keluar pelayan WHMCS disenaraikan dalam tetapan API NiceNIC.
Periksa sama ada WHMCS menggunakan butiran integrasi NiceNIC API terkini.
Uji tindakan risiko rendah seperti semakan ketersediaan domain sebelum membenarkan pesanan langsung.
Sahkan titik akhir permintaan: https://api.NiceNIC/v2/.
Sahkan bahawa Content-Jenis ditetapkan kepada application/json.
Sahkan bahawa badan permintaan dana adalah JSON yang sah.
Sahkan bahawa IP keluar pelayan disenaraikan putih.
Jika menggunakan WHMCS, sahkan IP keluar pelayan WHMCS.
Uji tindakan API risiko rendah terlebih dahulu.
Rekodkan cap masa permintaan, tindakan, domain, kod respons, dan mesej respons.
Apa yang Patut Dihantar ke Sokongan NiceNIC Jika Anda Masih Memerlukan Bantuan Jika ralat pengesahan terus berterusan selepas dana melengkapkan senarai semak, hantar tiket sokongan dengan maklumat teknikal yang mencukupi untuk NiceNIC mengkaji isu dengan berkesan.
Sila sertakan: Nama pengguna akaun NiceNIC dana atau pengecam akaun penjual semula Tindakan API yang dana cuba lakukan Cap masa permintaan dan zon waktu Nama domain yang digunakan dalam ujian, jika berkenaan Alamat IP keluar pelayan yang digunakan untuk permintaan Titik akhir API penuh yang diminta Kod respons dan mesej respons yang dikembalikan oleh API Sama ada dana menggunakan kod khusus atau WHMCS Versi WHMCS dana, jika WHMCS terlibat Tangkapan skrin berkaitan, kecuali kelayakan sensitif
Soalan Lazim Mengapa permintaan NiceNIC API v2 saya mengembalikan ralat pengesahan? Punca paling biasa ialah kata laluan API salah, header Authatauization hilang atau salah, alamat IP pelayan yang tidak disenaraikan putih, alamat IP keluar yang salah, akses penjual semula yang tidak layak, titik akhir yang salah, atau konfigurasi WHMCS yang salah.
Adakah saya patut menggunakan kata laluan log masuk akaun NiceNIC untuk pengesahan API? Tidak. Anda harus menetapkan kata laluan API berasingan dalam tetapan API dana. Kata laluan API harus berbeza daripada kata laluan log masuk akaun NiceNIC dana.
Header Authatauization apa yang patut saya gunakan untuk NiceNIC API v2? Fataumat header Authatauization yang didokumentasikan ialah username:api_secret. Anda juga harus termasuk Content-Jenis: application/json dalam header permintaan.{{/G399}}
Mengapa API masih gagal selepas saya menetapkan kata laluan yang betul? Permintaan mungkin datang dari alamat IP yang tidak disenaraikan putih. Sahkan alamat IP keluar sebenar pelayan dana, pemasangan WHMCS, atau aplikasi backend.
Adakah WHMCS menggunakan IP pelayan yang sama dengan laman web saya? Tidak selalu. WHMCS mungkin dipasang pada pelayan berbeza, di belakang proksi, atau dalam persekitaran dengan IP keluar yang berbeza. Sahkan IP keluar sebenar sebelum menambahnya ke tetapan API NiceNIC dana.
Bolehkah NiceNIC membetulkan ralat pengesahan akibat konfigurasi pelayan saya? NiceNIC boleh membantu menyemak akses sisi pendaftar, tetapan API, dan keperluan sambungan yang didokumentasikan. Isu sisi pelayan seperti peraturan firewall, laluan IP keluar, tingkah laku proksi, konfigurasi modul WHMCS, dan kod khusus mungkin perlu diperiksa oleh pembangun atau penyedia hosting dana.
Apa yang patut saya uji terlebih dahulu selepas memperbaiki isu pengesahan? Mula dengan tindakan API risiko rendah seperti semakan baki akaun, semakan ketersediaan domain, carian harga, atau pengambilan senarai domain sebelum mengaktifkan pendaftaran hidup, pembaharuan, atau aliran pemindahan.
Perlukan bantuan? Kami sentiasa sedia membantu anda.Hantar Tiket