Ambil API key
Dokumentasi API

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.domains

Buat 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 TLD
GET/domains/search?q=namaKetersediaan + harga per nama
GET/domains?limit=50&offset=0Daftar domain kamu (ada total)
GET/domains?berkas=kurangHanya yang berkas registry-nya belum lengkap
POST/domains/registerDaftarkan domain
GET/domains/:namaDetail satu domain
POST/domains/:nama/renewPerpanjang
POST/domains/transferTransfer masuk (butuh EPP)
POST/domains/:nama/eppMinta kode EPP (memicu notifikasi keamanan)
GET/domains/:nama/documentStatus berkas registry + tautan unggah

Contoh 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 record
POST/domains/:nama/dnsTambah record
DELETE/domains/:nama/dns/:idHapus record
PUT/domains/:nama/nameserversGanti nameserver

DNS 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 masuk
DELETE/auth/sessions/:idKeluarkan satu perangkat
POST/auth/sessions/revoke-allKeluarkan semua perangkat

revoke-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 sekarang
GET/billing/transactionsRiwayat transaksi
GET/contactsKontak WHOIS
GET/auth/meProfil + mata uang tampilan

Massal

POST/bulk/checkCek sampai 1000 nama
POST/bulk/registerDaftarkan sampai 25 per batch

Harga & 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 }
401unauthorizedAPI key salah, dicabut, atau tidak dikirim
402insufficient_balanceSaldo kurang, topup dulu
403tld_not_availableTLD belum dibuka pada fase ini
403identitas_belum_diverifikasiDaftar domain butuh email ATAU verifikasi grup WA
403email_wajib_berbayarRegistrasi berbayar butuh email terverifikasi
403wa_belum_verifKlaim gratis butuh verifikasi grup WA (kecuali yang pernah topup)
403free_limit_reachedSlot domain gratis akun habis
400harga_premium_tidak_tersediaNama premium tanpa harga publik
409domain_existsDomain sudah terdaftar
429terlalu_banyak_percobaanKena pembatas laju
400tipe_tidak_didukungTipe DNS di luar A/AAAA/CNAME/TXT/MX/NS
400nilai_tidak_validNilai record tidak cocok tipenya (mis. MX ke alamat IP)
400cname_akarCNAME dipasang di akar domain
400cname_bentrokCNAME berdampingan dengan record lain di nama yang sama
400record_kembarRecord yang persis sama sudah ada
404record_tidak_adaRecord DNS yang dihapus tidak ditemukan
502registrar_errorRegistrar 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.signup

domain.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.

Butuh endpoint yang belum ada di sini?

Kirim email ke [email protected], dashboard ini dibangun di atas API yang sama, jadi kemungkinan besar sudah ada.