Domain API

DAPATKAN /api/v1/domains/

Senaraikan Semua Domain

Dapatkan senarai semua domain yang didaftarkan di bawah akaun anda.

Parameter Pertanyaan

Parameter	Jenis	Diperlukan	Huraian
`status`	string	Tidak	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Tidak	Cari domain mengikut nama

Contoh Permintaan

cURL

Python

JavaScript

curl -X GET "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const domains = await response.json();
console.log(domains);

Contoh Respons

{
  "count": 3,
  "results": [
    {
      "id": 101,
      "domain_name": "example.com",
      "status": "active",
      "registration_date": "2023-01-15T10:30:00Z",
      "expiration_date": "2026-01-15T10:30:00Z",
      "auto_renew": true,
      "locked": true,
      "nameservers": [
        "ns1.vps.org",
        "ns2.vps.org"
      ],
      "privacy_protection": true,
      "dns_managed_by": "vps.org"
    },
    {
      "id": 102,
      "domain_name": "myapp.io",
      "status": "active",
      "registration_date": "2024-06-20T14:15:00Z",
      "expiration_date": "2025-06-20T14:15:00Z",
      "auto_renew": false,
      "locked": false,
      "nameservers": [
        "ns1.cloudflare.com",
        "ns2.cloudflare.com"
      ],
      "privacy_protection": false,
      "dns_managed_by": "external"
    }
  ]
}

Kod Status Respons

200	Senarai domain berjaya diambil
401	Tidak Dibenarkan - Token pengesahan tidak sah atau tiada

POST /api/v1/domains/

Daftar Domain Baharu

Daftar nama domain baru. Keberadaan domain harus disemak sebelum pendaftaran.

Minta Parameter Badan

Parameter	Jenis	Diperlukan	Huraian
`domain_name`	string	Ya	Domain name to register (e.g., "example.com")
`years`	integer	Tidak	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Tidak	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Tidak	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Tidak	Custom nameservers (default: VPS.org nameservers)

Contoh Permintaan

cURL

Python

JavaScript

PHP

curl -X POST "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_name": "mynewdomain.com",
    "years": 2,
    "auto_renew": true,
    "privacy_protection": true
  }'

import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "domain_name": "mynewdomain.com",
    "years": 2,
    "auto_renew": True,
    "privacy_protection": True
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain_name: 'mynewdomain.com',
    years: 2,
    auto_renew: true,
    privacy_protection: true
  })
});

const domain = await response.json();
console.log(domain);

$data = [
    'domain_name' => 'mynewdomain.com',
    'years' => 2,
    'auto_renew' => true,
    'privacy_protection' => true
];

$ch = curl_init('https://admin.vps.org/api/v1/domains/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$domain = json_decode($response, true);
curl_close($ch);

Contoh Respons

{
  "id": 103,
  "domain_name": "mynewdomain.com",
  "status": "pending",
  "registration_date": "2026-01-16T16:00:00Z",
  "expiration_date": "2028-01-16T16:00:00Z",
  "auto_renew": true,
  "locked": true,
  "nameservers": [
    "ns1.vps.org",
    "ns2.vps.org"
  ],
  "privacy_protection": true,
  "dns_managed_by": "vps.org",
  "total_cost": 24.98,
  "message": "Domain registration initiated. Processing may take 5-10 minutes."
}

Kod Status Respons

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Tidak Dibenarkan - Token pengesahan tidak sah atau tiada
402	Payment Required - Insufficient account balance

Nota: Domain registration is not instant. Status will change from pending to active within 5-10 minutes. You'll receive an email confirmation when registration completes.

DAPATKAN /api/v1/domains/{domain_id}/

Dapatkan Perincian Domain

Dapatkan maklumat terperinci mengenai domain tertentu.

Parameter Laluan

Parameter	Jenis	Diperlukan	Huraian
`domain_id`	integer	Ya	Unique domain ID

Contoh Permintaan

cURL

Python

JavaScript

curl -X GET "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const domain = await response.json();
console.log(domain);

Contoh Respons

{
  "id": 101,
  "domain_name": "example.com",
  "status": "active",
  "registration_date": "2023-01-15T10:30:00Z",
  "expiration_date": "2026-01-15T10:30:00Z",
  "auto_renew": true,
  "locked": true,
  "nameservers": [
    "ns1.vps.org",
    "ns2.vps.org"
  ],
  "privacy_protection": true,
  "dns_managed_by": "vps.org",
  "registrar": "VPS.org",
  "days_until_expiration": 730,
  "whois_info": {
    "registrant": "Privacy Protected",
    "admin_contact": "Privacy Protected",
    "tech_contact": "Privacy Protected",
    "created_date": "2023-01-15",
    "updated_date": "2025-12-20"
  },
  "dns_records_count": 12
}

Kod Status Respons

200	Successfully retrieved domain details
401	Tidak Dibenarkan - Token pengesahan tidak sah atau tiada
404	Tidak Ditemui - Domain tidak wujud

PUT /api/v1/domains/{domain_id}/

Kemas kini Tetapan Domain

Kemas kini konfigurasi domain seperti auto-perbaharui, pelayan nama, dan tetapan privasi.

Parameter Laluan

Parameter	Jenis	Diperlukan	Huraian
`domain_id`	integer	Ya	Unique domain ID

Minta Parameter Badan

Parameter	Jenis	Diperlukan	Huraian
`auto_renew`	boolean	Tidak	Enable or disable automatic renewal
`privacy_protection`	boolean	Tidak	Enable or disable WHOIS privacy
`nameservers`	array	Tidak	Update nameservers (2-4 nameservers required)
`locked`	boolean	Tidak	Lock or unlock domain to prevent transfers

Contoh Permintaan

cURL

Python

JavaScript

curl -X PUT "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "auto_renew": false,
    "nameservers": [
      "ns1.cloudflare.com",
      "ns2.cloudflare.com"
    ]
  }'

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "auto_renew": False,
    "nameservers": [
        "ns1.cloudflare.com",
        "ns2.cloudflare.com"
    ]
}

response = requests.put(url, headers=headers, json=data)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    auto_renew: false,
    nameservers: [
      'ns1.cloudflare.com',
      'ns2.cloudflare.com'
    ]
  })
});

const domain = await response.json();
console.log(domain);

Contoh Respons

{
  "id": 101,
  "domain_name": "example.com",
  "status": "active",
  "auto_renew": false,
  "nameservers": [
    "ns1.cloudflare.com",
    "ns2.cloudflare.com"
  ],
  "privacy_protection": true,
  "locked": true,
  "message": "Domain settings updated successfully. Nameserver changes may take up to 24 hours to propagate."
}

Kod Status Respons

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Tidak Dibenarkan - Token pengesahan tidak sah atau tiada
404	Tidak Ditemui - Domain tidak wujud

PADAM /api/v1/domains/{domain_id}/

Hapuskan Domain

Hapuskan domain dari akaun anda. Ini tidak membatalkan pendaftaran domain - ia hanya membuangnya dari pengurusan akaun VPS.org anda.

Parameter Laluan

Parameter	Jenis	Diperlukan	Huraian
`domain_id`	integer	Ya	Unique domain ID

Contoh Permintaan

cURL

Python

JavaScript

curl -X DELETE "https://admin.vps.org/api/v1/domains/101/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)
print(response.status_code)

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

console.log(response.status);

Kod Status Respons

204	Domain removed from account successfully
401	Tidak Dibenarkan - Token pengesahan tidak sah atau tiada
404	Tidak Ditemui - Domain tidak wujud

Important: Deleting a domain from your VPS.org account does NOT cancel the registration. The domain will continue to be registered and will auto-renew if enabled. To cancel a domain registration, disable auto-renewal and let it expire.

POST /api/v1/domains/{domain_id}/transfer/

Pindah Domain

Mulakan pemindahan domain ke VPS.org dari pengurus lain.

Parameter Laluan

Parameter	Jenis	Diperlukan	Huraian
`domain_id`	integer	Ya	Unique domain ID

Minta Parameter Badan

Parameter	Jenis	Diperlukan	Huraian
`auth_code`	string	Ya	EPP/Authorization code from current registrar
`auto_renew`	boolean	Tidak	Enable auto-renewal after transfer (default: true)

Contoh Permintaan

cURL

Python

JavaScript

curl -X POST "https://admin.vps.org/api/v1/domains/101/transfer/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_code": "Xy9Kl2Mn#4pQ",
    "auto_renew": true
  }'

import requests

domain_id = 101
url = f"https://admin.vps.org/api/v1/domains/{domain_id}/transfer/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "auth_code": "Xy9Kl2Mn#4pQ",
    "auto_renew": True
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const domainId = 101;
const response = await fetch(`https://admin.vps.org/api/v1/domains/${domainId}/transfer/`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    auth_code: 'Xy9Kl2Mn#4pQ',
    auto_renew: true
  })
});

const transfer = await response.json();
console.log(transfer);

Contoh Respons

{
  "id": 101,
  "domain_name": "example.com",
  "transfer_status": "pending",
  "transfer_initiated_at": "2026-01-16T16:30:00Z",
  "estimated_completion": "2026-01-23T16:30:00Z",
  "message": "Domain transfer initiated. You should receive a confirmation email from your current registrar. Transfer typically completes within 5-7 days.",
  "next_steps": [
    "Check email for transfer authorization request",
    "Approve transfer with current registrar",
    "Wait for transfer to complete (5-7 days)",
    "Domain will be automatically renewed for 1 year upon completion"
  ]
}

Kod Status Respons

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Tidak Dibenarkan - Token pengesahan tidak sah atau tiada
404	Tidak Ditemui - Domain tidak wujud
402	Payment Required - Insufficient account balance for transfer fee

Keperluan Pemindahan:

Domain mesti dinyahkunci pada pengurus semasa
Domain mesti sekurang-kurangnya 60 hari
Kod EPP/Auth yang sah diperlukan
Emel WHOIS mesti boleh diakses untuk kelulusan
Pemindahan termasuk pembaharuan 1 tahun (caj dikenakan)

Domain

TLDs yang popular

TLD	Pendaftaran (1 tahun)	Perbaharui	Pemindahan
.com	$12.99	$12.99	$12.99
.net	$14.99	$14.99	$14.99
.org	$13.99	$13.99	$13.99
.io	$39.99	$39.99	$39.99
.dev	$14.99	$14.99	$14.99
.app	$14.99	$14.99	$14.99
.co	$24.99	$24.99	$24.99

Ciri-ciri yang disertakan

✓ Perlindungan Keprihatinan WHOIS
✓ Pengurusan DNS Bebas
✓ Penyampaian Emel Bebas
✓ Penyaluran Domain Bebas

✓ Domain Terbuka
✓ Sokongan 24/7
✓ Pengurusan Domain Mudah
✓ Opsyen Auto-Perbaharui

Pengurusan Domain

Keselamatan

Hidupkan Kunci Domain: Halang pemindahan tidak dibenarkan
Aktifkan Perlindungan Keprihatinan: Sembunyikan maklumat peribadi anda dari WHOIS
Guna Kata Laluan Kuat: Lindungi akaun VPS.org anda
Hidupkan 2FA: Tambahkan keselamatan tambahan ke akaun anda
Tarikh Luput Monitor: Tetapkan peringatan auto-baru atau kalendar

Konfigurasi

Tetapan DNS: Papar pelayan nama ke VPS.org untuk pengurusan mudah
Auto-barukan: Hidupkan untuk mencegah domain luput secara tidak sengaja
Maklumat Kenalan: Kekalkan maklumat kenalan WHOIS dikemaskini
Sambungan DNS: Pertimbangkan penyedia DNS sekunder untuk redundansi

Pemindahan

Kunci 60-Hari: Domain tidak boleh dipindahkan dalam masa 60 hari dari pendaftaran atau pemindahan sebelumnya
Nyahkunci Domain: Mesti dinyahkunci pada pengurus semasa sebelum pemindahan
Dapatkan Kod Pengesahan: Minta kod EPP/pengesahan dari pengurus semasa
Semak Emel: Anda akan menerima emel kelulusan semasa proses pemindahan
Rencanakan ke hadapan: Pemindahan boleh mengambil masa 5-7 hari untuk selesai

VPS.org API

Senaraikan Semua Domain

Parameter Pertanyaan

Contoh Permintaan

Contoh Respons

Kod Status Respons

Daftar Domain Baharu

Minta Parameter Badan

Contoh Permintaan

Contoh Respons

Kod Status Respons

Dapatkan Perincian Domain

Parameter Laluan

Contoh Permintaan

Contoh Respons

Kod Status Respons

Kemas kini Tetapan Domain

Parameter Laluan

Minta Parameter Badan

Contoh Permintaan

Contoh Respons

Kod Status Respons

Hapuskan Domain

Parameter Laluan

Contoh Permintaan

Kod Status Respons

Pindah Domain

Parameter Laluan

Minta Parameter Badan

Contoh Permintaan

Contoh Respons

Kod Status Respons

Domain

TLDs yang popular

Ciri-ciri yang disertakan

Pengurusan Domain

Keselamatan

Konfigurasi

Pemindahan