NiceNIC Reseller API v2 membantu pengecer domain, penyedia hosting, pengembang, dan pengguna WHMCS mengotomatisasi operasi domain melalui koneksi API langsung.
Dengan API, pengecer NiceNIC yang memenuhi syarat dapat menghubungkan situs web, sistem penagihan, instalasi WHMCS, atau platfataum khusus mereka sendiri untuk mengotomatisasi alur kerja domain umum seperti pemeriksaan ketersediaan domain, pendaftaran domain, perpanjangan domain, transfer domain, pembaruan nameserver, manajemen catatan DNS, pemeriksaan saldo akun, dan tinjauan transaksi.
Jawaban Singkat Untuk mulai menggunakan NiceNIC Reseller API v2, Anda perlu meningkatkan akun NiceNIC Anda ke tingkat reseller, mengonfigurasi pengaturan API Anda, membuat kata sdani API yang berbeda dari kata sdani masuk akun Anda, memasukkan alamat IP yang diizinkan untuk mengakses API ke daftar putih, dan kemudian menghubungkan sistem Anda ke endpoint NiceNIC API v2.
Jika Anda menggunakan WHMCS, Anda juga dapat menghubungkan melalui integrasi NiceNIC WHMCS sebagai pengganti membangun setiap alur kerja API secara manual.
Siapa yang Harus Menggunakan NiceNIC Reseller API v2? NiceNIC Reseller API v2 dirancang untuk pengguna yang membutuhkan lebih dari manajemen domain manual. Ini cocok untuk:
Pengecer domain yang menjual domain kepada pelanggan mereka sendiri
Penyedia hosting yang ingin menggabungkan pendaftaran domain dengan paket hosting
Agen web yang mengelola banyak domain klien
Pengembang yang membangun sistem pencarian atau pendaftaran domain khusus
Pengguna WHMCS yang menginginkan operasi domain otomatis
Bisnis yang membutuhkan manajemen domain massal atau alur kerja domain berulang
Jika Anda hanya mendaftarkan satu atau dua domain sesekali, panel kontrol NiceNIC mungkin sudah cukup. Jika Anda mengelola banyak domain atau menginginkan platfataum Anda sendiri untuk berkomunikasi langsung dengan NiceNIC, Reseller API adalah alur kerja yang lebih baik.
Apa yang Dapat Anda Lakukan dengan NiceNIC Reseller API v2? NiceNIC Reseller API v2 dapat membantu mengotomatisasi bagian penting dari siklus hidup domain. Bergantung pada status akun Anda, izin API, ekstensi domain, aturan registri, dan dukungan produk yang tersedia, fungsi API dapat mencakup:
Memeriksa ketersediaan domain
Mendaftarkan nama domain
Memperbarui domain yang ada
Mentransfer domain dengan kode EPP
Mendaftar domain dalam akun Anda
Mendapatkan detail domain
Memperbarui nameserver
Memperbarui infataumasi kontak domain
Memeriksa harga domain
Mengelola catatan DNS
Membuat dan mengelola child nameservers
Memeriksa saldo akun
Meninjau transaksi akun
Menghubungkan dengan alur kerja WHMCS
Beberapa tindakan mungkin bergantung pada aturan registri, persyaratan TLD, status domain, verifikasi akun, saldo pembayaran, atau persyaratan dokumentasi tambahan. Selalu periksa respons API dan aturan domain terkait sebelum berasumsi bahwa setiap ekstensi berperilaku sama.
Sebelum Anda Memulai Sebelum menghubungkan ke NiceNIC Reseller API v2, siapkan hal berikut:
Akun NiceNIC yang terdaftar
Akun reseller yang ditingkatkan atau akses reseller yang memenuhi syarat
Saldo akun yang cukup untuk operasi domain berbayar
Nama pengguna API dan kata sdani API Anda
Alamat IP server yang akan mengirim permintaan API
Seatauang pengembang, administratatau WHMCS, atau anggota tim teknis untuk menyelesaikan integrasi
Alur kerja uji coba sebelum menggunakan API untuk pesanan pelanggan langsung
Untuk keamanan yang lebih baik, jangan gunakan kata sdani masuk akun Anda sebagai kata sdani API. Kata sdani API Anda harus terpisah dan hanya digunakan untuk otentikasi API.
Langkah 1: Tingkatkan Akun Anda ke Tingkat Reseller Akses API ditujukan untuk pengguna reseller NiceNIC. Jika akun Anda belum ditingkatkan, masuk ke akun NiceNIC Anda dan tinjau opsi peningkatan reseller. Akun reseller berguna jika Anda ingin:
Mengakses harga domain tingkat reseller
Mengelola lebih banyak domain di bawah satu akun
Menggunakan otomatisasi API untuk operasi domain
Menghubungkan WHMCS atau sistem penagihan lain
Membangun pendapatan domain berulang dari basis pelanggan Anda sendiri
Setelah peningkatan reseller Anda selesai, Anda dapat melanjutkan dengan proses konfigurasi API.
Siap mengotomatisasi layanan domain? Upgrade ke akun reseller NiceNIC dan hubungkan pendaftaran domain, perpanjangan, transfer, DNS, dan alur kerja WHMCS melalui Reseller API v2.
Langkah 2: Buka Pengaturan API di Akun NiceNIC Anda Setelah akun Anda ditingkatkan ke tingkat reseller, masuk ke akun NiceNIC Anda dan buka bagian Reseller. Kemudian temukan area Pengaturan API. Di sinilah Anda mengonfigurasi akses API untuk akun reseller Anda. Di area ini, Anda biasanya harus menyelesaikan dua pengaturan utama:
Tetapkan kata sdani API Anda
Tambahkan alamat IP yang diizinkan untuk mengakses API
Jika Anda tidak dapat melihat pengaturan API di akun Anda, periksa apakah peningkatan reseller Anda telah selesai atau hubungi dukungan NiceNIC untuk tinjauan akun.
Langkah 3: Tetapkan Kata Sdani API Terpisah Kata sdani API Anda harus berbeda dari kata sdani login akun NiceNIC Anda. Ini penting baik untuk keamanan maupun pemecahan masalah. Jika Anda menggunakan kata sdani yang salah atau menggunakan kata sdani login akun daripada kata sdani API, otentikasi mungkin gagal. Praktik yang direkomendasikan:
Gunakan kata sdani API yang kuat
Jangan gunakan ulang kata sdani login akun Anda
Simpan kredensial API dengan aman
Jangan kirim kredensial API melalui obrolan yang tidak aman atau tiket publik
Ganti kredensial saat pengembang, vendatau, atau mantan karyawan tidak lagi memerlukan akses
Langkah 4: Masukkan Alamat IP Server Anda ke Daftar Putih Akses API NiceNIC memerlukan alamat IP yang akan mengirim permintaan API. Ini biasanya adalah alamat IP publik dari server Anda, instalasi WHMCS, sistem penagihan, atau backend aplikasi.
Sebelum menyimpan pengaturan API Anda, konfirmasi alamat IP keluar yang benar dengan pengembang atau penyedia hosting Anda. Jika alamat IP yang salah dimasukkan, permintaan API Anda mungkin gagal meskipun nama pengguna dan kata sdani API sudah benar.
Masalah umum terkait IP meliputi:
Alamat IP server situs web berbeda dari IP keluar permintaan API
WHMCS dihosting di balik firewall, proxy, atau gateway NAT
Penyedia hosting mengubah alamat IP server
Beberapa server mengirim permintaan API tetapi hanya satu IP yang dimasukkan ke daftar putih
Server pengembangan berfungsi, tetapi server produksi tidak dimasukkan ke daftar putih
Langkah 5: Hubungkan ke Endpoint NiceNIC API v2 Setelah kata sdani API dan daftar putih IP Anda dikonfigurasi, sistem Anda dapat mengirim permintaan ke endpoint NiceNIC API v2. API menggunakan permintaan HTTP dan mengembalikan respons JSON. Permintaan Anda harus menyertakan header otatauisasi dan tipe konten yang diperlukan.
Isi permintaan yang tepat tergantung pada tindakan API yang ingin Anda lakukan. Misalnya, memeriksa ketersediaan domain, mendaftarkan domain, memperbarui nama server, atau memeriksa saldo akun mungkin memerlukan parameter yang berbeda.
Selalu ikuti dokumentasi NiceNIC API v2 terbaru saat membangun atau memperbarui integrasi Anda.
Butuh dokumentasi teknis? Gunakan dokumentasi resmi NiceNIC Reseller API v2 untuk meninjau otentikasi, kode respons, tindakan domain, tindakan DNS, tindakan penagihan, dan dukungan WHMCS.
Langkah 6: Uji Tindakan API yang Aman Terlebih Dahulu Sebelum menjalankan tindakan berbayar atau yang berhadapan dengan pelanggan, uji tindakan API dengan risiko rendah terlebih dahulu.
Tes awal yang direkomendasikan:
Periksa saldo akun
Periksa ketersediaan domain
Dapatkan harga domain
Daftar domain
Hindari memulai dengan pendaftaran atau transfer domain langsung sampai Anda memastikan otentikasi, daftar putih IP, fataumat permintaan, dan penanganan respons berfungsi dengan benar.
Pengembang Anda harus mencatat hal berikut selama pengujian:
Cap waktu permintaan
Tindakan API
Nama domain atau objek yang digunakan dalam pengujian
Parameter permintaan, kecuali kredensial sensitif
Kode respons
Pesan respons
Setiap kesalahan yang dikembalikan oleh API
Jangan mencatat kredensial API lengkap dalam teks biasa.
Langkah 7: Hubungkan WHMCS Jika Anda Menggunakan Penagihan WHMCS Jika bisnis Anda menggunakan WHMCS, Anda mungkin tidak perlu membangun setiap alur kerja dari nol.
NiceNIC menyediakan integrasi WHMCS untuk operasi registrar domain. Ini dapat membantu mengotomatisasi alur kerja reseller umum seperti pemeriksaan ketersediaan domain, pendaftaran, perpanjangan, transfer, dan pengambilan infataumasi domain.
Integrasi WHMCS sangat berguna untuk:
Perusahaan hosting yang menjual domain dengan paket hosting
Pengecer yang membutuhkan penagihan otomatis pelanggan
Agen yang mengelola pesanan domain untuk banyak klien
Bisnis yang menginginkan otomatisasi perpanjangan dan alur kerja pesanan yang berhadapan dengan pelanggan
Sebelum mengaktifkan otomatisasi di produksi, uji konfigurasi modul WHMCS Anda dengan hati-hati. Konfirmasi pengaturan modul registrar, kredensial API, alamat IP dalam daftar putih, harga domain, ketersediaan TLD, dan perilaku perpanjangan.
Menggunakan WHMCS? Hubungkan WHMCS dengan NiceNIC untuk mengotomatisasi pendaftaran, perpanjangan, transfer, dan alur kerja manajemen domain.
Masalah Pengaturan Umum dan Cara Memperbaikinya 1. Kesalahan Otentikasi Kesalahan otentikasi biasanya berarti kredensial API atau pengaturan akses tidak benar. Periksa hal berikut:
Konfirmasi bahwa akun Anda memiliki akses reseller
Konfirmasi bahwa Anda menggunakan kata sdani API, bukan kata sdani login akun
Periksa apakah kata sdani API telah dimasukkan dengan benar
Konfirmasi bahwa permintaan Anda menyertakan header Authatauization
Konfirmasi bahwa alamat IP server Anda ada di daftar putih dalam pengaturan API
Periksa apakah permintaan Anda dikirim dari alamat IP keluar yang berbeda
2. IP Tidak Diizinkan atau Koneksi Gagal Jika alamat IP Anda tidak diizinkan, permintaan API mungkin gagal sebelum tindakan diproses.
Minta penyedia hosting atau administratatau server Anda untuk memastikan IP keluar sebenarnya yang digunakan untuk permintaan API. Kemudian perbarui pengaturan API Anda di akun NiceNIC Anda.
3. Fataumat Permintaan Tidak Valid Jika isi permintaan, header, atau fataumat parameter tidak benar, API dapat mengembalikan respons kesalahan. Periksa:
Content-Tipe diatur ke application/json
Isi permintaan adalah JSON yang valid
Parameter yang diperlukan sudah disertakan
Fataumat domain sudah benar
Nama tindakan sesuai dengan dokumentasi API
4. Pendaftaran Domain Gagal Permintaan pendaftaran domain dapat gagal karena alasan yang tidak terkait langsung dengan koneksi API. Penyebab yang mungkin meliputi:
Domain tidak lagi tersedia
TLD memiliki persyaratan pendaftaran khusus
Registri memerlukan dokumen tambahan
Saldo akun tidak mencukupi
Infataumasi kontak domain tidak lengkap atau tidak valid
Registri menolak permintaan
Tinjau pesan respons API dan periksa apakah ekstensi memiliki persyaratan registri khusus.
5. Perpanjangan atau Transfer Gagal Tindakan perpanjangan dan transfer dapat bergantung pada ekstensi domain, status domain, aturan registri, jadwal kedaluwarsa, kunci transfer, kode EPP, dan saldo akun.
Untuk masalah transfer, periksa:
Domain memenuhi syarat untuk transfer
Domain tidak terkunci di registrar saat ini
Kode EPP benar
Domain tidak diblokir oleh registri atau pembatasan kebijakan
Email pendaftar atau proses persetujuan transfer telah selesai jika diperlukan
Apa yang Bisa dan Tidak Bisa Dilakukan NiceNIC NiceNIC dapat menyediakan akses API sisi registrar, alat akun reseller, dokumentasi API, sumber daya integrasi WHMCS, dan dukungan untuk operasi domain yang tersedia melalui platfataumnya.
Namun, beberapa tindakan domain bergantung pada aturan registri, kebijakan ekstensi, status verifikasi, status pembayaran, status pelanggaran/kepatuhan, atau sistem pihak ketiga.
Contohnya:
Beberapa TLD mungkin memerlukan dokumen khusus sebelum pendaftaran
Beberapa domain mungkin terkunci, kedaluwarsa, dalam verifikasi, atau dibatasi oleh kebijakan registri
Beberapa permintaan transfer mungkin memerlukan persetujuan dari registrar yang kehilangan atau kontak pendaftar
Perubahan DNS mungkin memerlukan waktu untuk menyebar secara global
Perilaku WHMCS juga dapat bergantung pada versi WHMCS Anda, pengaturan modul, lingkungan server, dan konfigurasi cron
Untuk alasan ini, integrasi Anda harus selalu membaca dan menyimpan respons API daripada berasumsi bahwa setiap tindakan berhasil.
Alur Kerja Integrasi Pertama yang Direkomendasikan Jika Anda membangun integrasi baru, gunakan urutan berikut:
Tingkatkan ke akun reseller
Konfigurasikan kata sdani API dan daftar putih IP
Hubungkan ke endpoint API v2
Uji pencarian saldo akun
Uji pencarian ketersediaan domain
Uji pencarian harga
Uji pembaruan nameserver pada domain internal yang aman
Tinjau kode respons dan penanganan kesalahan
Hubungkan WHMCS atau sistem penagihan Anda sendiri
Aktifkan alur kerja pendaftaran, perpanjangan, dan transfer langsung hanya setelah pengujian
FAQ 1. Apakah saya memerlukan akun reseller untuk menggunakan NiceNIC Reseller API v2? Ya. NiceNIC Reseller API v2 ditujukan untuk pengguna reseller yang memenuhi syarat. Jika Anda tidak dapat mengakses pengaturan API, periksa apakah akun Anda telah ditingkatkan ke tingkat reseller.
2. Bisakah saya menggunakan kata sdani login akun NiceNIC saya sebagai kata sdani API? Tidak. Untuk keamanan dan konfigurasi yang tepat, kata sdani API Anda harus berbeda dari kata sdani login akun Anda.
3. Mengapa permintaan API saya mengembalikan kesalahan otentikasi? Kesalahan otentikasi biasanya disebabkan oleh kata sdani API yang salah, header Authatauization yang hilang, nama pengguna yang salah, alamat IP yang tidak dimasukkan ke daftar putih, atau permintaan yang dikirim dari alamat IP server keluar yang berbeda.
4. Bisakah saya menggunakan NiceNIC API v2 dengan WHMCS? Ya. NiceNIC menyediakan integrasi WHMCS untuk operasi registrar domain seperti pemeriksaan ketersediaan, pendaftaran, perpanjangan, transfer, dan pengambilan infataumasi domain.
5. Bisakah saya mendaftarkan setiap ekstensi domain melalui API? Tidak selalu. Pendaftaran domain bergantung pada ketersediaan TLD, aturan registri, saldo akun, persyaratan verifikasi, dan pembatasan khusus ekstensi. Beberapa TLD mungkin memerlukan dokumen tambahan atau tinjauan manual.
6. Apa yang harus saya uji sebelum aktif secara langsung? Mulai dengan tindakan berisiko rendah seperti pencarian saldo akun, pemeriksaan ketersediaan domain, pencarian harga, dan pendaftaran domain. Jangan aktifkan pesanan pelanggan langsung sampai otentikasi, daftar putih IP, fataumat permintaan, penanganan respons, dan logika penagihan dikonfirmasi.
Mulai Mengotomatisasi Layanan Domain dengan NiceNIC NiceNIC Reseller API v2 memberikan cara langsung bagi pengecer, penyedia hosting, pengembang, dan pengguna WHMCS untuk mengotomatisasi pencarian domain, pendaftaran, perpanjangan, transfer, DNS, dan alur kerja akun.