Domeinuen APIa

LORTU /api/v1/domains/

Domeinu guztiak zerrendatu

Zure kontuan erregistratuta dauden domeinu guztien zerrenda eskuratzen du.

Kontsulta-parametroak

Parametroak	Mota	Beharrezkoa	Azalpena
`status`	string	Ez	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Ez	Bilatu domeinuak izenaren arabera

Eskaera adibidea

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

Adibide Erantzuna

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

Erantzun Egoera Kodeak

200	Domeinuen zerrenda behar bezala berreskuratu da
401	Baimenik gabea - Autentifikazio-token baliogabea edo falta da

POST /api/v1/domains/

Domeinu Berria Erregistratu

Erregistratu domeinu-izen berria. Domeinua eskuragarri dagoela egiaztatu behar da erregistratu aurretik.

Eskaeraren Gorputzaren Parametroak

Parametroak	Mota	Beharrezkoa	Azalpena
`domain_name`	string	Bai	Domain name to register (e.g., "example.com")
`years`	integer	Ez	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Ez	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Ez	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Ez	Custom nameservers (default: VPS.org nameservers)

Eskaera adibidea

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

Adibide Erantzuna

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

Erantzun Egoera Kodeak

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Baimenik gabea - Autentifikazio-token baliogabea edo falta da
402	Payment Required - Insufficient account balance

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

LORTU /api/v1/domains/{domain_id}/

Eskuratu domeinuaren xehetasunak

Eskuratu domeinu jakin bati buruzko informazio xehea.

Bidearen parametroak

Parametroak	Mota	Beharrezkoa	Azalpena
`domain_id`	integer	Bai	Unique domain ID

Eskaera adibidea

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

Adibide Erantzuna

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

Erantzun Egoera Kodeak

200	Successfully retrieved domain details
401	Baimenik gabea - Autentifikazio-token baliogabea edo falta da
404	Ez da aurkitu - Domeinua ez da existitzen

JARRI /api/v1/domains/{domain_id}/

Eguneratu domeinuaren ezarpenak

Eguneratu domeinuaren konfigurazioa, hala nola, automatikoki berritzea, izen-zerbitzariak eta pribatutasun-ezarpenak.

Bidearen parametroak

Parametroak	Mota	Beharrezkoa	Azalpena
`domain_id`	integer	Bai	Unique domain ID

Eskaeraren Gorputzaren Parametroak

Parametroak	Mota	Beharrezkoa	Azalpena
`auto_renew`	boolean	Ez	Enable or disable automatic renewal
`privacy_protection`	boolean	Ez	Enable or disable WHOIS privacy
`nameservers`	array	Ez	Update nameservers (2-4 nameservers required)
`locked`	boolean	Ez	Lock or unlock domain to prevent transfers

Eskaera adibidea

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

Adibide Erantzuna

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

Erantzun Egoera Kodeak

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Baimenik gabea - Autentifikazio-token baliogabea edo falta da
404	Ez da aurkitu - Domeinua ez da existitzen

EZABATU /api/v1/domains/{domain_id}/

Ezabatu domeinua

Ezabatu domeinu bat zure kontutik. Honek ez du domeinuaren erregistroa bertan behera uzten - zure VPS.org kontu kudeaketatik kentzen du soilik.

Bidearen parametroak

Parametroak	Mota	Beharrezkoa	Azalpena
`domain_id`	integer	Bai	Unique domain ID

Eskaera adibidea

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

Erantzun Egoera Kodeak

204	Domain removed from account successfully
401	Baimenik gabea - Autentifikazio-token baliogabea edo falta da
404	Ez da aurkitu - Domeinua ez da existitzen

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/

Transferitu domeinua

VPS.org domeinu transferentzia bat beste erregistro batetik hastea.

Bidearen parametroak

Parametroak	Mota	Beharrezkoa	Azalpena
`domain_id`	integer	Bai	Unique domain ID

Eskaeraren Gorputzaren Parametroak

Parametroak	Mota	Beharrezkoa	Azalpena
`auth_code`	string	Bai	EPP/Authorization code from current registrar
`auto_renew`	boolean	Ez	Enable auto-renewal after transfer (default: true)

Eskaera adibidea

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

Adibide Erantzuna

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

Erantzun Egoera Kodeak

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Baimenik gabea - Autentifikazio-token baliogabea edo falta da
404	Ez da aurkitu - Domeinua ez da existitzen
402	Payment Required - Insufficient account balance for transfer fee

Transferentziaren baldintzak:

Domeinua desblokeatu behar da uneko erregistroan
Domeinuak gutxienez 60 egun izan behar ditu
Baliozko EPP/Autentifikazio kodea behar da
WHOIS helbide elektronikoa eskuragarria izan behar da onartzeko
Transferentziak urtebeteko berritzea barne hartzen du (ordaina aplikatzen da)

Domeinuaren prezioa

TLD ezagunak

TLD	Erregistroa (urtebete)	Berritzea	Transferentzia
.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

Ezaugarri barne

✓ WHOIS pribatutasun babesa
✓ DNS kudeaketa librea
✓ Posta birbidaltze librea
✓ Domeinu librearen birbidaltzea

✓ Domeinu librearen blokeoa
✓ 24/7 laguntza
✓ Domeinuen kudeaketa erraza
✓ Auto-berritzeko aukera

Domeinu kudeaketaren jardunbide onenak

Segurtasuna

Gaitu domeinuaren blokeoa: Baimendu gabeko transferentziak ekiditen ditu
Gaitu pribatutasun-babesa: Zure informazio pertsonala WHOIS-etik ezkutatzen du
Erabili pasahitz sendoak: Babestu zure VPS.org kontua
Gaitu 2FA: Gehitu segurtasun gehigarria zure kontuari
Monitorearen iraungitze-datak: Konfiguratu auto-berritzea edo egutegiko oroigarriak

Konfigurazioa

DNS konfigurazioa: Izen-zerbitzariak VPS.org-ra apuntatu kudeaketa erraza lortzeko
Auto-berritzea: Gaitu domeinua ustekabean iraungitzea saihesteko
Kontaktuaren informazioa: Mantendu WHOIS kontaktuaren informazioa eguneratuta
DNS babeskopia: Kontsideratu bigarren mailako DNS hornitzailea erredundantziarako

Transferentziak

60 eguneko blokeoa: Domeinuak ezin dira transferitu erregistroa edo aurreko transferentzia egin eta 60 egunen barruan
Desblokeatu domeinua: Uneko erregistroan desblokeatu behar da transferentzia egin aurretik
Eskuratu autentifikazio-kodea: Eskatu EPP/baimen-kodea uneko erregistroari
Egiaztatu posta elektronikoa: Transferentzia prozesuan zehar onarpen-mezuak jasoko dituzu
Aurretik planifikatu: Transferentziak 5-7 egun behar ditu burutzeko

VPS.org API

Domeinu guztiak zerrendatu

Kontsulta-parametroak

Eskaera adibidea

Adibide Erantzuna

Erantzun Egoera Kodeak

Domeinu Berria Erregistratu

Eskaeraren Gorputzaren Parametroak

Eskaera adibidea

Adibide Erantzuna

Erantzun Egoera Kodeak

Eskuratu domeinuaren xehetasunak

Bidearen parametroak

Eskaera adibidea

Adibide Erantzuna

Erantzun Egoera Kodeak

Eguneratu domeinuaren ezarpenak

Bidearen parametroak

Eskaeraren Gorputzaren Parametroak

Eskaera adibidea

Adibide Erantzuna

Erantzun Egoera Kodeak

Ezabatu domeinua

Bidearen parametroak

Eskaera adibidea

Erantzun Egoera Kodeak

Transferitu domeinua

Bidearen parametroak

Eskaeraren Gorputzaren Parametroak

Eskaera adibidea

Adibide Erantzuna

Erantzun Egoera Kodeak

Domeinuaren prezioa

TLD ezagunak

Ezaugarri barne

Domeinu kudeaketaren jardunbide onenak

Segurtasuna

Konfigurazioa

Transferentziak