API

Registrasi kawat, pemeriksaan ketersediaan, DNS dan manajemen ke dalam sistem Anda sendiri: pemesanan massal, penyisiran pembaruan, panel kontrol untuk pelanggan Anda.

API adalah titik masuk mesin ke operasi yang sama yang ditawarkan area klien. Apa yang dapat Anda lakukan di halaman, Anda dapat membuat skrip.

Istirahat HTTPS dengan tanggapan JSON

Kunci API Dibuat dan dicabut di area klien

Cakupan penuh Operasi yang sama dengan area klien

Dapat diaudit Panggilan dicatat di akun

Apa itu

Titik akhir dikelompokkan berdasarkan sumber daya - ketersediaan, domain, server nama, kontak, pesanan, dan faktur - dan mengembalikan JSON.
Otentikasi menggunakan kunci API yang dihasilkan di area klien, yang dapat dicabut dan diganti kapan saja.
Penggunaan umum: pendaftaran massal, pemeriksaan masa berlaku, sinkronisasi status domain ke sistem Anda sendiri, panel layanan mandiri untuk klien, dan alur kerja sertifikat otomatis.
Aturan bisnis yang sama berlaku seperti di web: domain tidak dapat didaftarkan begitu saja, dan transfer masih memerlukan domain yang tidak terkunci dan 60 hari.

Bagaimana cara kerjanya

01

Buat kunci

Hasilkan kunci API di area klien, sesuai dengan apa yang perlu dilakukannya.

02

Baca dokumentasinya

Titik akhir, parameter, dan bentuk respons.

03

Tes kecil

Coba titik akhir hanya-baca, atau beberapa domain, sebelum melakukan otomatisasi.

04

Tayangkan dengan logging

Tambahkan percobaan ulang dan pencatatan sebelum menyentuh produksi.

Ketersediaan dan pencarian

Periksa banyak nama sekaligus untuk pemantauan dan seleksi.

Pendaftaran dan perpanjangan

Pesan, perbarui, dan baca status pesanan.

DNS dan server nama

Dorong catatan dan perubahan server nama secara massal.

Manajemen kontak

Baca dan perbarui pendaftar, admin, teknisi, dan penagihan.

Pesanan dan faktur

Baca pesanan, faktur, dan status pembayaran.

Rotasi kunci

Cabut dan ganti kunci; menjaga setiap sistem pada kuncinya sendiri.

Apa yang dicakup oleh API

Berdasarkan sumber daya

Sumber daya	Apa yang bisa Anda lakukan
Domain	Periksa ketersediaan, daftar, perbarui, baca status dan kedaluwarsa
DNS	Membaca dan mengatur server nama, memelihara catatan DNS
Privasi dan kontak	Tetapkan tingkat privasi, perbarui keempat peran kontak
Pesanan dan penagihan	Baca pesanan, faktur, dan status pembayaran
Akun	Baca saldo dan detail akun dasar

Apa yang harus disiapkan sebelum Anda terhubung

Empat hal kecil yang menghemat sebagian besar proses debug

Saldo atau metode pembayaran yang berfungsi: pendaftaran dan perpanjangan adalah pesanan nyata, dan panggilan akan gagal pada langkah pemesanan tanpa dana.
Percobaan ulang dan penanganan kesalahan: terjadi gangguan jaringan, batas kecepatan, dan penundaan upstream. Coba lagi pembacaan idempoten; untuk pesanan, kirimkan referensi unik dan periksa sebelum menulis lagi.
Logging: mencatat referensi, domain, dan kode respons. Ketika ada sesuatu yang disengketakan di kemudian hari, log tersebut adalah satu-satunya bukti bahwa tindakan tersebut telah terjadi.
Hak istimewa paling rendah: jangan gunakan kunci yang dapat ditulis untuk pekerjaan yang hanya dapat dibaca, dan berikan kuncinya sendiri pada setiap sistem sehingga kunci yang satu dapat dicabut tanpa merusak yang lain.

Kunci API setara dengan kata sandi akun. Simpan di variabel lingkungan sisi server atau manajer rahasia, jangan pernah di kode front-end, dan jangan pernah di repositori.

Bagaimana orang menggunakannya

Pola umum

Pendaftar massal: kirimkan pilihan untuk pendaftaran dan tuliskan hasilnya kembali ke backend Anda sendiri.
Pemeriksaan perpanjangan: tarik domain yang mendekati masa berlakunya setiap malam dan ajukan pengingat atau tugas perpanjangan Anda sendiri.
Panel label putih: memungkinkan pelanggan mengelola domain di dalam produk Anda, tanpa masuk ke sini.
Rekonsiliasi: menarik domain dan memesan data sesuai jadwal dan mencocokkannya dengan buku besar Anda sendiri.

Apa yang termasuk dalam setiap pesanan

Manajemen kunci API

Membuat, mencabut, dan memisahkan kunci berdasarkan tujuan.

Dokumentasi

Titik akhir, parameter dan respons.

Titik akhir domain dan DNS

Cari, daftar, perbarui, DNS dan server nama.

Titik akhir pemesanan dan penagihan

Pesanan, faktur, dan status pembayaran.

Riwayat panggilan

Direkam terhadap akun untuk pemecahan masalah.

Dukungan

Buka tiket jika integrasi tidak berfungsi.

Pertanyaan umum

Apakah ada biaya tambahan untuk API?

API sendiri tidak dikenakan biaya secara terpisah; Anda membayar untuk operasi bisnis yang dilakukannya. Ada batasan tarif yang masuk akal untuk mencegah penggunaan yang tidak disengaja atau penyalahgunaan.

Apakah ada SDKnya?

API adalah HTTPS dan JSON standar, sehingga klien HTTP dapat digunakan. Dokumentasi mencakup contoh permintaan yang dapat diadaptasi secara langsung.

Bagaimana jika kuncinya bocor?

Cabut di area klien dan buat yang baru. Pencabutan akan segera berlaku dan permintaan yang menggunakan kunci lama ditolak.

Apakah pengujian memerlukan biaya?

Panggilan hanya baca tidak dikenakan biaya apa pun. Pendaftaran dan perpanjangan adalah perintah nyata dan memerlukan biaya, jadi validasi logika pada sejumlah kecil domain terlebih dahulu.

Bisakah API mengelola domain yang terdaftar di tempat lain?

Tidak. Ini beroperasi pada domain di akun ini, persis seperti area klien.

Harap dicatat

Simpan kunci API di server. Kunci yang dikirimkan dalam kode browser atau paket seluler adalah kunci yang dipublikasikan.
Untuk memesan titik akhir, kirimkan referensi permintaan unik dan periksa sebelum menulis, sehingga percobaan ulang jaringan tidak mendaftar atau mengenakan biaya dua kali.