Domain dari kode.
REST API yang sama yang menjalankan dashboard indo.domains. Cari, daftarkan, perpanjang, dan atur DNS langsung dari aplikasi atau pipeline kamu.
Mulai cepat
Semua permintaan memakai satu alamat dasar:
https://api.indo.domainsBuat API key di dashboard (Akun → API keys), lalu kirim sebagai bearer token. Key berawalan indo_sk_ dan hanya ditampilkan sekali saat dibuat.
curl https://api.indo.domains/domains/pricing \
-H "Authorization: Bearer indo_sk_xxxxxxxxxxxxxxxx"Katalog harga dan pencarian bisa diakses tanpa key. Selebihnya butuh key.
Endpoint
Domain
GET/domains/pricingKatalog harga per TLDGET/domains/search?q=namaKetersediaan + harga per namaGET/domains?limit=50&offset=0Daftar domain kamu (ada total)GET/domains?berkas=kurangHanya yang berkas registry-nya belum lengkapPOST/domains/registerDaftarkan domainGET/domains/:namaDetail satu domainPOST/domains/:nama/renewPerpanjangPOST/domains/transferTransfer masuk (butuh EPP)POST/domains/:nama/eppMinta kode EPP (memicu notifikasi keamanan)GET/domains/:nama/documentStatus berkas registry + tautan unggahContoh mendaftarkan domain:
curl -X POST https://api.indo.domains/domains/register \
-H "Authorization: Bearer indo_sk_xxxx" \
-H "Content-Type: application/json" \
-d '{
"domain_name": "tokobungaku.biz.id",
"duration_years": 1
}'Nameserver memakai ns1/ns2.indo.domains kalau tidak dikirim. Kontak WHOIS default akun dipakai otomatis, isi dulu di dashboard sebelum registrasi pertama.
DNS
GET/domains/:nama/dnsDaftar recordPOST/domains/:nama/dnsTambah recordDELETE/domains/:nama/dns/:idHapus recordPUT/domains/:nama/nameserversGanti nameserverDNS dilayani nameserver kami sendiri. Record baru berlaku hampir seketika, tidak perlu menunggu propagasi seperti saat mengganti nameserver.
Record hanya tersaji kalau domainnya memang didelegasikan ke ns1/ns2.indo.domains. Jawaban daftar menyertakan delegasi_ke_kita, kalau false, apa pun yang kamu simpan tidak akan pernah dijawab ke publik.
curl -X POST https://api.indo.domains/domains/tokobungaku.biz.id/dns \
-H "Authorization: Bearer indo_sk_..." \
-H "Content-Type: application/json" \
-d '{ "type": "A", "name": "www", "value": "103.10.20.30", "ttl": 3600 }'
# jawaban daftar
{
"records": [
{ "id": 3, "type": "A", "name": "www", "value": "103.10.20.30", "ttl": 3600, "priority": null }
],
"tipe_didukung": ["A","AAAA","CNAME","TXT","MX","NS"],
"nameservers_wajib": ["ns1.indo.domains","ns2.indo.domains"],
"delegasi_ke_kita": true
}name memakai label relatif: "@" untuk akar, "www" untuk subdomain. MX memakai priority. Aturan yang ditegakkan: CNAME tidak boleh di akar, CNAME tidak boleh berdampingan dengan record lain pada nama yang sama, MX/NS/CNAME harus nama host bukan alamat IP, dan TTL dijepit 60–604800.
Keamanan akun
GET/auth/sessionsPerangkat yang sedang masukDELETE/auth/sessions/:idKeluarkan satu perangkatPOST/auth/sessions/revoke-allKeluarkan semua perangkatrevoke-all juga menggugurkan token yang terbit sebelum pencatatan sesi ada, jadi ini yang dipakai kalau kamu curiga ada kredensial bocor. API key TIDAK ikut tercabut, cabut terpisah di halaman API key.
Akun & saldo
GET/billing/balanceSaldo sekarangGET/billing/transactionsRiwayat transaksiGET/contactsKontak WHOISGET/auth/meProfil + mata uang tampilanMassal
POST/bulk/checkCek sampai 1000 namaPOST/bulk/registerDaftarkan sampai 25 per batchHarga & nama pendek
Harga mengikuti PANJANG NAMA, bukan cuma TLD. Registry .id memasang tingkat premium untuk nama pendek, nama 2 karakter di .biz.id bukan gratis, melainkan puluhan juta Rupiah. Selalu baca harga dari /domains/search sebelum mendaftar, jangan mengasumsikan harga TLD.
Kolom yang perlu diperhatikan di jawaban pencarian: price_idr, premium, premium_maks_char, dan harga_tersedia. Kalau harga_tersedia bernilai false, nama itu belum bisa didaftarkan sendiri.
Error
Kegagalan selalu berbentuk JSON dengan kode yang stabil di field error:
{ "error": "insufficient_balance", "message": "…", "required_idr": 155300 }| 401 | unauthorized | API key salah, dicabut, atau tidak dikirim |
| 402 | insufficient_balance | Saldo kurang, topup dulu |
| 403 | tld_not_available | TLD belum dibuka pada fase ini |
| 403 | identitas_belum_diverifikasi | Daftar domain butuh email ATAU verifikasi grup WA |
| 403 | email_wajib_berbayar | Registrasi berbayar butuh email terverifikasi |
| 403 | wa_belum_verif | Klaim gratis butuh verifikasi grup WA (kecuali yang pernah topup) |
| 403 | free_limit_reached | Slot domain gratis akun habis |
| 400 | harga_premium_tidak_tersedia | Nama premium tanpa harga publik |
| 409 | domain_exists | Domain sudah terdaftar |
| 429 | terlalu_banyak_percobaan | Kena pembatas laju |
| 400 | tipe_tidak_didukung | Tipe DNS di luar A/AAAA/CNAME/TXT/MX/NS |
| 400 | nilai_tidak_valid | Nilai record tidak cocok tipenya (mis. MX ke alamat IP) |
| 400 | cname_akar | CNAME dipasang di akar domain |
| 400 | cname_bentrok | CNAME berdampingan dengan record lain di nama yang sama |
| 400 | record_kembar | Record yang persis sama sudah ada |
| 404 | record_tidak_ada | Record DNS yang dihapus tidak ditemukan |
| 502 | registrar_error | Registrar menolak, pesan aslinya diteruskan. Sejak DNS dilayani sendiri, kode ini TIDAK lagi muncul di endpoint DNS. |
Batas laju
Sekitar 10 permintaan per detik per alamat IP, dengan lonjakan sesaat sampai 25. Melebihi itu dijawab 429, beri jeda lalu ulangi, jangan langsung mencoba berkali-kali.
Webhook
Daftarkan URL di dashboard (Lanjutan → Integrasi). Kejadian dikirim sebagai POST JSON. Daftar lengkap event yang bisa dipilih, semuanya benar-benar dikirim, tidak ada yang sekadar tercantum:
domain.registered domain.renewed domain.expiring
domain.transfer domain.pushed
topup.submitted topup.approved topup.rejected
balance.low user.signupdomain.expiring mengikuti jadwal pengingat 30/14/7/3/1 hari dan dikirim sekali per ambang. balance.low dikirim saat saldo BARU MELEWATI ambang ke bawah, bukan setiap transaksi di bawah ambang, jadi satu akun bersaldo tipis tidak membanjiri endpoint kamu.
Format keluaran bisa dipilih: json, slack, discord, atau telegram.
Kirim email ke [email protected], dashboard ini dibangun di atas API yang sama, jadi kemungkinan besar sudah ada.