Ikhtisar API
Dokumentasi API Domain NiceNIC v2 & Panduan Memulai Cepat
API Domain NiceNIC v2 tersedia untuk Akun Market dan Akun Reseller. Gunakan ikhtisar ini untuk mengonfigurasi akses, memastikan permintaan pertama Anda berhasil, memahami model respons API, dan langsung menuju ke bagian yang tepat di navigasi kiri.
Akses API dan harga reseller adalah dua hal yang terpisah.
Akun Market: Akses API dengan harga Akun Market.
Akun Reseller: Akses API dengan harga yang ditetapkan untuk tingkat reseller saat ini.
Bandingkan level dan harga reseller →
Akun Market: Akses API dengan harga Akun Market.
Akun Reseller: Akses API dengan harga yang ditetapkan untuk tingkat reseller saat ini.
Bandingkan level dan harga reseller →
Endpoint Dasar
https://api.nicenic.net/v2/
Header yang Diperlukan
Host: api.nicenic.net Authorization: username:api_secret Content-Type: application/json
Respons Sukses Standar
{ "code": 0, "msg": "success", "data": {} }
Sandbox API
Uji Integrasi Anda Sebelum Diluncurkan
Gunakan Sandbox API NiceNIC untuk menguji integrasi Domain API Anda sebelum beralih ke produksi. Validasi autentikasi, permintaan API, penanganan respons, dan alur kerja aplikasi Anda di lingkungan pengujian khusus.
Ideal untuk reseller, penyedia hosting, pengembang, dan platform yang sedang menyiapkan integrasi API.
Mulai Cepat
Lakukan Panggilan API Pertama Anda dalam 4 Langkah
Mulailah dengan permintaan hanya-baca sebelum mengaktifkan pendaftaran, perpanjangan, atau transfer langsung. Ini memungkinkan Anda memvalidasi autentikasi, format permintaan, dan penanganan respons tanpa melakukan pesanan berbayar.
1
Aktifkan Akses API
Buka Pengaturan API, buat atau ambil Rahasia API Anda, dan konfigurasikan IP server yang diotorisasi jika diperlukan.
2
Konfirmasi Autentikasi
Gunakan HTTPS dengan header Authorization dalam format username:api_secret.
3
Lakukan Uji Coba yang Aman
Mulai dengan ketersediaan domain, harga, saldo akun, atau daftar domain.
4
Menangani Respons
Baca dan simpan code serta msg yang dikembalikan sebelum mengaktifkan tindakan produksi berbayar.
Permintaan Pertama yang Disarankan: Ketersediaan Domain
Endpoint ketersediaan mendukung beberapa domain dalam satu permintaan dengan memisahkan nama domain menggunakan koma.
curl "https://api.nicenic.net/v2/?category=domain&action=check&domains=example.com,example.net" \ -H "Authorization: username:api_secret" \ -H "Content-Type: application/json"
Peta API
Pilih Alur Kerja yang Anda Butuhkan
Ringkasan di bawah mencerminkan navigasi kiri. Gunakan untuk mengidentifikasi alur kerja yang tepat, lalu buka halaman endpoint khusus untuk parameter, contoh permintaan, dan contoh respons.
| Bagian | Gunakan Untuk | Fungsi Terdokumentasi |
|---|---|---|
| Memulai | Hubungkan dengan aman dan pahami penanganan respons. | Ikhtisar API, Sandbox API, Autentikasi, Kode Respons. |
| Manajemen Domain | Otomatiskan siklus hidup domain inti. | Ketersediaan, Daftar Domain, Detail Domain, Pendaftaran, Perpanjangan, Transfer Masuk, Nameserver, Kontak, Harga. |
| Penyalahgunaan & Kepatuhan | Pantau domain yang memerlukan perhatian kepatuhan. | Buat daftar domain dengan laporan penyalahgunaan dan ambil status penyalahgunaan yang dapat dibaca mesin, siklus penahanan, informasi keluhan, dan tindakan yang direkomendasikan. |
| Catatan DNS | Kelola catatan DNS yang di-hosting secara terprogram. | Daftar, Buat, Perbarui, dan Hapus catatan DNS. |
| Nameserver Anak | Kelola catatan host / glue untuk nameserver di bawah domain Anda sendiri. | Buat, Daftar, Perbarui, dan Hapus nameserver anak. |
| Akun & Penagihan | Hubungkan otomatisasi ke pemeriksaan tingkat akun. | Saldo Akun dan informasi akun terkait transaksi. |
| API WHMCS | Integrasikan NiceNIC ke dalam alur kerja penagihan WHMCS yang sudah ada. | Ketersediaan, Pendaftaran, Perpanjangan, Transfer, Detail Domain, Nameserver, Kontak, dan fungsi modul registrar tambahan. |
| FAQ API | Jawab pertanyaan umum seputar akses, keamanan, pengujian, dan alur kerja. | Kelayakan, kredensial, penanganan permintaan, operasi yang didukung, dan panduan integrasi. |
Alur Kerja yang Disarankan
Urutan Integrasi Pertama yang Disarankan
Integrasi produksi yang andal harus memvalidasi kondisi akses dan pembelian sebelum mulai mengirim pesanan pelanggan secara langsung.
1. Autentikasi
API Secret + IP yang diotorisasi
API Secret + IP yang diotorisasi
→
2. Ketersediaan
Uji konektivitas hanya-baca
Uji konektivitas hanya-baca
→
3. Harga
Kueri biaya tingkat akun saat ini
Kueri biaya tingkat akun saat ini
→
4. Saldo
Konfirmasi dana untuk tindakan berbayar
Konfirmasi dana untuk tindakan berbayar
→
5. Penanganan Respons
Proses kode + pesan
Proses kode + pesan
→
6. Operasi Langsung
Daftar / Perpanjang / Transfer
Daftar / Perpanjang / Transfer
Jangan berasumsi bahwa permintaan API selesai hanya karena telah diterima. Beberapa operasi dapat mengembalikan status tertunda dan masih memerlukan pemrosesan registry sebelum status domain akhir dikonfirmasi.
Perilaku Produksi
Memahami Respons Sukses, Tertunda, dan Error
code: 0 — Respons Sukses Contoh endpoint saat ini menggunakan code 0 untuk respons yang berhasil diselesaikan.
code: 201 — Pesanan Tertunda Dokumentasi pendaftaran dan transfer dapat mengembalikan code 201 ketika pesanan telah diajukan tetapi pemrosesan akhir masih tertunda.
code: 400 — Error Permintaan Contoh endpoint menggunakan code 400 untuk error parameter permintaan.
Perilaku Pendaftaran yang Tertunda
Untuk pendaftaran domain, dokumentasi saat ini menyatakan bahwa respons 201 berarti pesanan berhasil dikirim dan biaya telah dipotong, tetapi aktivasi akhir masih menunggu konfirmasi dari registry. Jika domain tidak dapat diaktifkan, biaya pendaftaran akan dikembalikan ke saldo akun NiceNIC dalam waktu 24 jam.
Perilaku Transfer Tertunda
Endpoint transfer juga mendokumentasikan 201 sebagai pesanan yang tertunda. Oleh karena itu, aplikasi Anda harus memperlakukan transfer yang tertunda sebagai diterima untuk diproses, bukan sebagai bukti bahwa transfer telah selesai.
Harga
Periksa Harga Sebelum Operasi Berbayar
Endpoint harga NiceNIC dapat mengambil harga pendaftaran, perpanjangan, dan transfer untuk sebuah domain. Nilai type yang didokumentasikan adalah register, renew, transfer, dan all. Periode yang didokumentasikan adalah 1 hingga 10 tahun, dengan pengecualian khusus TLD yang mungkin berlaku.
Respons harga pendaftaran juga dapat mengembalikan tanda is_premium. Gunakan endpoint harga sebelum mengirimkan permintaan berbayar ketika aplikasi Anda perlu mengetahui biaya tingkat akun saat ini.
Akses API gratis tidak mengubah tingkat harga Anda. Akun Pasar menggunakan harga Akun Pasar; akun reseller menggunakan harga yang ditetapkan untuk tingkat reseller mereka saat ini.
Operasi Domain & DNS
Ketahui Perbedaan Antara Nameserver, Catatan DNS, dan Nameserver Turunan
| Operasi | Gunakan Saat | Kapabilitas Terdokumentasi |
|---|---|---|
| Perbarui Nameserver | Anda ingin mendelegasikan domain ke nameserver otoritatif yang berbeda. | Endpoint nameserver domain mendukung nameserver primer, sekunder, dan tambahan, dengan halaman ini mendokumentasikan batas hingga enam nameserver. |
| Catatan DNS | Anda menggunakan hosting DNS NiceNIC dan perlu mengelola catatan zona. | API terpisah didokumentasikan untuk membuat daftar, membuat, memperbarui, dan menghapus catatan DNS. |
| Nameserver Anak | Anda memerlukan host / glue records seperti ns1.example.com. |
Buat, daftarkan, perbarui, dan hapus nameserver anak. Endpoint pembuatan memerlukan hostname nameserver yang cocok dengan domain dan menerima alamat IP. |
Portofolio & Kepatuhan
Otomatiskan Pemantauan Portofolio, Bukan Hanya Pesanan Domain
Domain API v2 juga mencakup operasi baca yang berguna setelah pendaftaran. Endpoint List Domains mendukung paginasi, pengurutan, pemfilteran status, dan pemfilteran hold, sedangkan Get Domain Details mengembalikan tanggal pendaftaran, tanggal kedaluwarsa, nameserver, dan informasi kontak pendaftar.
Pemantauan Penyalahgunaan & Kepatuhan
API Penyalahgunaan & Kepatuhan NiceNIC dapat mendaftarkan domain dengan laporan penyalahgunaan serta mengembalikan ringkasan terperinci yang dapat dibaca mesin untuk domain tertentu. Endpoint penyalahgunaan terperinci mendokumentasikan enam frasa status tingkat domain: Normal, Dalam Peninjauan, ClientHold Tertunda, ClientHold, Ditutup, dan ServerHold.
Respons dapat mencakup dampak saat ini, tindakan berikutnya yang disarankan, status penahanan dan linimasa, jumlah keluhan, tanggal keluhan, kategori, klasifikasi penyalahgunaan DNS, status bukti, dan URL yang dilaporkan jika berlaku. Hal ini memungkinkan platform dan reseller menampilkan status kepatuhan di dalam sistem operasional mereka sendiri, bukan hanya mengandalkan peninjauan manual.
API Langsung atau WHMCS
Pilih Model Integrasi yang Sesuai dengan Sistem Anda
| Opsi | Cocok Untuk | Apa yang Disediakan Dokumentasi Saat Ini |
|---|---|---|
| API Domain v2 | Situs web kustom, platform SaaS, sistem internal, penagihan kustom, atau alur kerja penyediaan. | Integrasi HTTPS + JSON langsung di seluruh operasi domain, DNS, nameserver anak, akun, dan kepatuhan. |
| Modul WHMCS | Perusahaan hosting dan reseller yang sudah menggunakan WHMCS. | Ketersediaan, pendaftaran, perpanjangan, transfer, detail domain, nameserver, kontak, kunci/buka kunci, pengambilan EPP, pencatatan kesalahan, dan Mode Uji opsional. |
Dokumentasi WHMCS saat ini mencantumkan WHMCS 7.0 atau lebih tinggi, PHP 7.0 atau lebih tinggi dengan cURL, kredensial API NiceNIC yang valid, dan dukungan SSL/TLS sebagai persyaratan.
Pemecahan Masalah
Saat Permintaan API Gagal
Mulailah dengan respons yang dikembalikan dan status konfigurasi, daripada mengulangi tindakan berbayar yang sama secara berulang.
Kesalahan Autentikasi atau Akses
- Konfirmasikan nama pengguna NiceNIC dan API Secret.
- Pastikan header Authorization ada dan formatnya benar.
- Pastikan API Secret belum direset atau dirotasi.
- Jika pembatasan IP diaktifkan, pastikan permintaan berasal dari IP server keluar yang berwenang.
Kesalahan Parameter Permintaan
- Bandingkan permintaan dengan parameter yang terdokumentasi untuk endpoint spesifik.
- Pastikan nilai, format, dan nama tindakan yang diperlukan.
- Periksa periode pendaftaran khusus TLD atau persyaratan kontak jika berlaku.
Operasi Berbayar Tidak Selesai Secara Langsung
- Baca
codedanmsgyang dikembalikan. - Jangan menganggap respons tertunda
201sebagai penyelesaian akhir. - Konfirmasi saldo akun dan harga saat ini sebelum mengulangi tindakan berbayar.
Perlu Dukungan NiceNIC
- Catat stempel waktu permintaan dan tindakan API.
- Sertakan nama domain atau objek yang terlibat, jika berlaku.
- Sertakan kode dan pesan yang dikembalikan.
- Bagikan hanya parameter yang tidak sensitif; jangan pernah mengirimkan API Secret lengkap dalam tiket.
Langkah Berikutnya
Mulai dengan Permintaan Uji yang Aman
Aktifkan akses API, konfirmasi autentikasi, jalankan permintaan ketersediaan atau harga, dan verifikasi penanganan respons Anda sebelum mengaktifkan operasi berbayar yang menghadap pelanggan.
Terakhir diverifikasi: 26 Agustus 2026
