Domains API

AKIRU /api/v1/domains/

Listigi Ĉiujn Domajnojn

Elpreni liston de ĉiuj retregionoj registritaj sub via konto.

Demandparametroj

Parametroj	Tipo	Bezonata	Priskribo
`status`	string	No	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	No	Serĉu domajnojn laŭ nomo

Ekzempla Peto

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);

Ekzempla Respondo

{
  "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"
    }
  ]
}

Respondaj Statusaj Kodoj

200	Sukcese prenita domajna listo
401	Neaŭtorizita - Malvalida aŭ mankanta aŭtentiga ĵetono

POST /api/v1/domains/

Registru Novan Domajnon

Registri novan retregionan nomon. Kontrolu la disponeblon de retregiono antaŭ ol registri.

Parametroj de la petokorpo

Parametroj	Tipo	Bezonata	Priskribo
`domain_name`	string	Jes	Domain name to register (e.g., "example.com")
`years`	integer	No	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	No	Enable automatic renewal (default: true)
`privacy_protection`	boolean	No	Enable WHOIS privacy protection (default: true)
`nameservers`	array	No	Custom nameservers (default: VPS.org nameservers)

Ekzempla Peto

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);

Ekzempla Respondo

{
  "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."
}

Respondaj Statusaj Kodoj

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Neaŭtorizita - Malvalida aŭ mankanta aŭtentiga ĵetono
402	Payment Required - Insufficient account balance

Note: 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.

AKIRU /api/v1/domains/{domain_id}/

Elpreni retregionajn detalojn

Preni detalan informon pri specifa retregiono.

Padaj Parametroj

Parametroj	Tipo	Bezonata	Priskribo
`domain_id`	integer	Jes	Unique domain ID

Ekzempla Peto

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);

Ekzempla Respondo

{
  "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
}

Respondaj Statusaj Kodoj

200	Successfully retrieved domain details
401	Neaŭtorizita - Malvalida aŭ mankanta aŭtentiga ĵetono
404	Ne trovita - Domajno ne ekzistas

METU /api/v1/domains/{domain_id}/

Ĝisdatigi la retregionan agordon

Ĝisdatigi la agordon de la retregiono, ekzemple aŭtomatan renovigon, nomservilojn kaj privatecajn agordojn.

Padaj Parametroj

Parametroj	Tipo	Bezonata	Priskribo
`domain_id`	integer	Jes	Unique domain ID

Parametroj de la petokorpo

Parametroj	Tipo	Bezonata	Priskribo
`auto_renew`	boolean	No	Enable or disable automatic renewal
`privacy_protection`	boolean	No	Enable or disable WHOIS privacy
`nameservers`	array	No	Update nameservers (2-4 nameservers required)
`locked`	boolean	No	Lock or unlock domain to prevent transfers

Ekzempla Peto

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);

Ekzempla Respondo

{
  "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."
}

Respondaj Statusaj Kodoj

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Neaŭtorizita - Malvalida aŭ mankanta aŭtentiga ĵetono
404	Ne trovita - Domajno ne ekzistas

FORIGI /api/v1/domains/{domain_id}/

Forigi retregionon

Forigi retregionon el via konto. Tio ne nuligas la retregionan registriĝon - ĝi nur forigas ĝin el via VPS.org- kontoadministrado.

Padaj Parametroj

Parametroj	Tipo	Bezonata	Priskribo
`domain_id`	integer	Jes	Unique domain ID

Ekzempla Peto

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);

Respondaj Statusaj Kodoj

204	Domain removed from account successfully
401	Neaŭtorizita - Malvalida aŭ mankanta aŭtentiga ĵetono
404	Ne trovita - Domajno ne ekzistas

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/

Transigi retregionon

Initiate a domain transfer to VPS.org from another registrar.

Padaj Parametroj

Parametroj	Tipo	Bezonata	Priskribo
`domain_id`	integer	Jes	Unique domain ID

Parametroj de la petokorpo

Parametroj	Tipo	Bezonata	Priskribo
`auth_code`	string	Jes	EPP/Authorization code from current registrar
`auto_renew`	boolean	No	Enable auto-renewal after transfer (default: true)

Ekzempla Peto

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);

Ekzempla Respondo

{
  "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"
  ]
}

Respondaj Statusaj Kodoj

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Neaŭtorizita - Malvalida aŭ mankanta aŭtentiga ĵetono
404	Ne trovita - Domajno ne ekzistas
402	Payment Required - Insufficient account balance for transfer fee

Transsendaj postuloj:

Retregiono devas esti malŝlosita ĉe la nuna registristo
Retregiono devas esti almenaŭ 60 tagoj malnova
Valida EPP/Aŭtentigo-kodo necesas
WHOIS-retpoŝto devas esti alirebla por aprobo
La transdono inkluzivas 1-jaran renovigon (pago validas)

Domena prezo

Popularaj TLDoj

TLD	Registro (1 jaro)	Renovigo	Translokigo
.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

Inkluditaj Trajtoj

✓ Libera WHOIS-privatecprotekto
✓ Libera DNS-administrilo
✓ Libera retpoŝto- transsendaĵo
✓ Libera retregiona transsendaĵo

✓ Libera ŝloso de retregiono
✓ 24/7 subteno
✓ Simpla administrado de retregionoj
✓ Aŭtomata renoviga opcio

Retregiona administrado

Sekureco

Ebligi ŝlosilon de retregiono: Malhelpas neaŭtorizitajn translokigojn
Ebligi privatecan protekton: Kaŝas viajn personajn informojn el WHOIS
Uzi fortajn pasvortojn: Protektu vian VPS.org-konton
Ebligi 2FA: Aldoni ekstran sekurecon al via konto
Monitori ekvalidojn: Agordi aŭtomatan renovigon aŭ kalendarajn rememorojn

Agordo

DNS- agordo: Montru nomservilojn al VPS.org por facila administrado
Aŭtomata renovigo: Ebligi por eviti akcidentan malvalidiĝon de retregiono
Kontaktinformoj: @ info: status
Sekuriga DNS: Konsideri duarangan DNS- provizanton por redundo

Translokigoj

60-taga ŝloso: Retregionoj ne povas esti translokigitaj ene de 60 tagoj de registrado aŭ antaŭa translokigo
Malŝlosi retregionon: Devas esti malŝlosita ĉe la nuna registrilo antaŭ transdono
Ricevi aŭtentigan kodon: Petas EPP/aŭtentigan kodon de la nuna registrilo
Kontroli retpoŝton: Vi ricevos aprobajn retpoŝtojn dum la transsendprocezo
Plani antaŭen: Translokigoj povas daŭri 5-7 tagojn por kompletigi

VPS.org API

Listigi Ĉiujn Domajnojn

Demandparametroj

Ekzempla Peto

Ekzempla Respondo

Respondaj Statusaj Kodoj

Registru Novan Domajnon

Parametroj de la petokorpo

Ekzempla Peto

Ekzempla Respondo

Respondaj Statusaj Kodoj

Elpreni retregionajn detalojn

Padaj Parametroj

Ekzempla Peto

Ekzempla Respondo

Respondaj Statusaj Kodoj

Ĝisdatigi la retregionan agordon

Padaj Parametroj

Parametroj de la petokorpo

Ekzempla Peto

Ekzempla Respondo

Respondaj Statusaj Kodoj

Forigi retregionon

Padaj Parametroj

Ekzempla Peto

Respondaj Statusaj Kodoj

Transigi retregionon

Padaj Parametroj

Parametroj de la petokorpo

Ekzempla Peto

Ekzempla Respondo

Respondaj Statusaj Kodoj

Domena prezo

Popularaj TLDoj

Inkluditaj Trajtoj

Retregiona administrado

Sekureco

Agordo

Translokigoj