NiceNIC Domain API v2 Pertanyaan yang Sering Diajukan

NiceNIC Domain API v2 adalah API berbasis HTTPS dan JSON untuk mengotomatiskan pengelolaan domain melalui akun NiceNIC Anda.

Ini mendukung alur kerja inti termasuk pemeriksaan ketersediaan domain, pendaftaran, perpanjangan, transfer, kueri portofolio, pembaruan nameserver dan kontak, harga, catatan DNS, nameserver anak, informasi akun, dan operasi terkait kepatuhan.

Gunakan API ini ketika Anda ingin menghubungkan layanan domain NiceNIC secara langsung ke situs web, platform hosting, sistem penagihan, alat internal, atau aplikasi lainnya.

Setiap akun NiceNIC aktif dapat menggunakan Domain API v2. Akses API tersedia untuk Akun Market dan Akun Reseller.

Anda tidak perlu menjadi reseller hanya untuk mendapatkan akses API. Jenis akun tetap menentukan harga: operasi API berbayar menggunakan harga yang ditetapkan untuk akun NiceNIC yang mengirim permintaan.

Buka Pengaturan API →

Ya. Akses API itu sendiri gratis. Tidak ada biaya terpisah untuk mengaktifkan akses API atau mengirim permintaan API yang didukung.

Operasi berbayar seperti pendaftaran domain, perpanjangan, dan transfer dikenakan biaya sesuai dengan harga akun Anda dan aturan domain yang berlaku.

Tidak. Akses API dan harga reseller adalah dua hal yang terpisah.

Anda dapat menggunakan Domain API v2 dengan Akun Market NiceNIC biasa. Tingkatkan ke Akun Reseller hanya jika harga reseller atau keuntungan reseller lainnya berguna untuk volume bisnis Anda.

Bandingkan Paket Reseller →

Domain API v2 menggunakan struktur API NiceNIC saat ini dengan permintaan HTTPS, respons JSON, autentikasi berbasis header, dan dokumentasi yang disusun berdasarkan alur kerja domain dan akun individual.

Jika Anda memelihara integrasi yang dibangun di atas NiceNIC API yang lebih lama, tinjau parameter API v2 dan penanganan respons sebelum memigrasikan lalu lintas produksi, daripada berasumsi bahwa kedua versi dapat dipertukarkan.

Masuk ke akun NiceNIC Anda dan buka Pengaturan API. Permintaan API v2 menggunakan nama pengguna NiceNIC dan Rahasia API Anda untuk autentikasi.

Buka Pengaturan API →

Ya. NiceNIC menyediakan API Sandbox bagi pengembang untuk menguji integrasi sebelum menghubungkannya ke API produksi.

Gunakan Sandbox untuk memvalidasi otentikasi, format permintaan, penguraian respons, penanganan kesalahan, dan alur kerja aplikasi Anda sebelum mengaktifkan operasi domain pelanggan secara langsung.

Buka API Sandbox →

API Sandbox ditujukan untuk pengembangan dan pengujian integrasi. Production API digunakan untuk operasi domain langsung dan permintaan berbayar pada akun NiceNIC Anda.

Kami menyarankan untuk memvalidasi otentikasi, penanganan permintaan, pemrosesan respons, dan logika kesalahan di Sandbox sebelum mengaktifkan operasi produksi yang menghadap pelanggan.

Kirim permintaan API melalui HTTPS dan sertakan nama pengguna NiceNIC serta API Secret Anda di header Authorization.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

Jika pembatasan IP diaktifkan untuk akun Anda, permintaan juga harus berasal dari IP server yang sah.

Baca Autentikasi API →

Endpoint dasar Production API adalah:

https://api.nicenic.net/v2/

Tindakan API dipilih menggunakan parameter yang didokumentasikan untuk setiap endpoint, seperti category dan action. Selalu ikuti dokumentasi endpoint khusus untuk parameter wajib dan opsional dari operasi tertentu.

Respons API v2 menggunakan JSON, dan parameter permintaan menggunakan UTF-8.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

Aplikasi Anda harus memeriksa code dan msg yang dikembalikan daripada menganggap bahwa setiap respons HTTP mewakili operasi domain yang selesai.

Melalui API yang terdokumentasi saat ini, Anda dapat mengotomatiskan alur kerja termasuk pemeriksaan ketersediaan domain, pendaftaran, perpanjangan, dan transfer, daftar portofolio dan detail domain, pembaruan nameserver dan kontak domain, harga domain, catatan DNS, nameserver anak, informasi akun, serta pemantauan Penyalahgunaan & Kepatuhan.

Alur kerja tambahan didokumentasikan secara terpisah di navigasi API.

Mulailah dengan operasi baca berisiko rendah seperti pemeriksaan ketersediaan domain, harga domain, saldo akun, dan daftar domain.

Berikutnya, pastikan autentikasi, penguraian respons, penanganan kesalahan, dan penanganan pesanan tertunda berfungsi sebelum mengaktifkan pendaftaran, perpanjangan, atau transfer langsung.

Ya. Titik akhir Periksa Ketersediaan Domain mendukung beberapa nama domain yang dipisahkan dengan koma.

example.com,example.net,example.org

Jangan berasumsi bahwa setiap operasi API mendukung format input multi-domain yang sama. Pendaftaran, perpanjangan, dan transfer harus mengikuti dokumentasi titik akhir masing-masing.

Gunakan endpoint Get Domain Pricing. Jenis harga yang didokumentasikan mencakup register, renew, transfer, dan all.

Respons pendaftaran juga dapat menyertakan nilai is_premium yang menunjukkan apakah pendaftaran yang ditanyakan bersifat premium.

Karena pesanan API menggunakan harga tingkat akun, periksa harga saat ini sebelum mengirimkan pesanan pelanggan berbayar daripada mengandalkan harga cache tanpa batas.

Tidak. Meskipun dokumentasi API mendukung periode hingga 1–10 tahun untuk ekstensi yang berlaku, masing-masing TLD mungkin memiliki aturan registry yang berbeda.

Periode pendaftaran, periode perpanjangan, kelayakan transfer, persyaratan kontak, dan persyaratan verifikasi dapat berbeda untuk setiap ekstensi. Aplikasi Anda harus mengikuti aturan yang berlaku untuk TLD yang relevan.

Ini adalah operasi yang terpisah dan tidak boleh diperlakukan sebagai operasi yang dapat dipertukarkan.

Saat menentukan status permintaan API, selalu gunakan kode dan pesan yang dikembalikan.

Lihat Kode Respons API →

Respons 201 berarti operasi telah diterima untuk diproses, tetapi belum tentu mencapai status akhirnya.

Untuk pendaftaran domain, respons 201 menunjukkan bahwa pesanan telah dikirim dan menunggu pemrosesan akhir dari registry.

Jangan memberi tahu pelanggan akhir bahwa domain aktif sampai sistem Anda mengonfirmasi hasil akhir. Ikuti dokumentasi endpoint pendaftaran untuk aturan terbaru mengenai pesanan tertunda dan penanganan pengembalian dana.

Transfer tertunda berarti permintaan transfer telah diterima untuk diproses, bukan berarti domain telah selesai ditransfer ke NiceNIC.

Penyelesaian transfer dapat bergantung pada pemrosesan registry dan registrar serta status transfer domain saat ini. Pertahankan transfer dalam status tertunda hingga penyelesaiannya dikonfirmasi.

Ya. API List Domains mendukung pengambilan portofolio dengan opsi paginasi, pengurutan, dan pemfilteran.

Gunakan Get Domain Details saat Anda memerlukan informasi terperinci untuk domain tertentu, seperti informasi pendaftaran, informasi kedaluwarsa, nameserver, dan data kontak domain.

NiceNIC Domain API v2 mencakup operasi Abuse & Compliance yang dirancang untuk platform dan reseller yang mengelola portofolio domain pelanggan.

Anda dapat mengidentifikasi domain yang terkait dengan laporan penyalahgunaan dan mengambil informasi kepatuhan yang dapat dibaca mesin untuk domain individual. Tergantung pada kasusnya, respons dapat mencakup status domain, dampak saat ini, tindakan yang disarankan, informasi penahanan, informasi keluhan, dan URL yang dilaporkan.

Hal ini memungkinkan Anda untuk menampilkan status kepatuhan secara langsung di dalam portal pelanggan atau sistem operasional Anda sendiri.

Ya. NiceNIC menyediakan integrasi registrar WHMCS untuk bisnis yang sudah menggunakan WHMCS untuk penagihan dan penyediaan layanan.

Gunakan Domain API v2 langsung saat Anda membangun aplikasi atau alur kerja sendiri. Gunakan integrasi WHMCS ketika Anda ingin operasi domain terintegrasi ke dalam lingkungan WHMCS yang sudah ada.

Lihat Integrasi WHMCS →

Bahasa pemrograman sisi server atau runtime apa pun yang mampu mengirim permintaan HTTPS dan mengurai JSON dapat berintegrasi dengan Domain API v2.

Pilihan umum meliputi PHP, Python, Node.js, dan Java. Simpan kredensial API di sisi server dan jangan pernah mengekspos API Secret Anda dalam JavaScript sisi peramban atau kode klien yang dapat diunduh.

Batas kecepatan dapat diterapkan untuk melindungi stabilitas API dan keamanan platform.

Jika integrasi produksi Anda diperkirakan akan menghasilkan volume permintaan tinggi secara berkelanjutan, hubungi NiceNIC sebelum peluncuran agar pola penggunaan yang Anda perkirakan dapat ditinjau.

Sertakan stempel waktu permintaan, kategori dan tindakan API, nama domain bila berlaku, parameter permintaan yang tidak sensitif, kode dan pesan respons yang dikembalikan, serta apakah permintaan berasal dari Sandbox atau Production.

Kirim Tiket →

Gunakan navigasi API di dalam dokumentasi. Setiap operasi memiliki halaman tersendiri untuk parameter yang didukung, contoh permintaan, contoh respons, dan perilaku khusus operasi tersebut.

FAQ menjelaskan perilaku umum API; dokumentasi untuk setiap endpoint harus dianggap sebagai sumber acuan utama untuk format permintaan yang tepat.

Buka Dokumentasi API →