API de dominios

OBTER /api/v1/domains/

Listar todos os dominios

Obtén unha lista de todos os dominios rexistrados na súa conta.

Parámetros de consulta

Parámetros	Tipo	Obrigatorio	Descrición
`status`	string	Non	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Non	Buscar dominios por nome

Exemplo de solicitude

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

Exemplo de resposta

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

Códigos de estado de resposta

200	Lista de dominios recuperada correctamente
401	Non autorizado: token de autenticación non válido ou falta

POST /api/v1/domains/

Rexistra un novo dominio

Rexistrar un novo nome de dominio. Debería comprobarse a dispoñíbel do dominio antes de rexistralo.

Parámetros do corpo da solicitude

Parámetros	Tipo	Obrigatorio	Descrición
`domain_name`	string	Si	Domain name to register (e.g., "example.com")
`years`	integer	Non	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Non	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Non	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Non	Custom nameservers (default: VPS.org nameservers)

Exemplo de solicitude

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

Exemplo de resposta

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

Códigos de estado de resposta

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Non autorizado: token de autenticación non válido ou falta
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.

OBTER /api/v1/domains/{domain_id}/

Obter os detalles do dominio

Obtén información detallada acerca dun dominio específico.

Parámetros da ruta

Parámetros	Tipo	Obrigatorio	Descrición
`domain_id`	integer	Si	Unique domain ID

Exemplo de solicitude

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

Exemplo de resposta

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

Códigos de estado de resposta

200	Successfully retrieved domain details
401	Non autorizado: token de autenticación non válido ou falta
404	Non atopado - O dominio non existe

POÑER /api/v1/domains/{domain_id}/

Actualizar a configuración do dominio

Actualizar a configuración do dominio como a renovación automática, os servidores de nomes e a configuración de privacidade.

Parámetros da ruta

Parámetros	Tipo	Obrigatorio	Descrición
`domain_id`	integer	Si	Unique domain ID

Parámetros do corpo da solicitude

Parámetros	Tipo	Obrigatorio	Descrición
`auto_renew`	boolean	Non	Enable or disable automatic renewal
`privacy_protection`	boolean	Non	Enable or disable WHOIS privacy
`nameservers`	array	Non	Update nameservers (2-4 nameservers required)
`locked`	boolean	Non	Lock or unlock domain to prevent transfers

Exemplo de solicitude

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

Exemplo de resposta

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

Códigos de estado de resposta

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Non autorizado: token de autenticación non válido ou falta
404	Non atopado - O dominio non existe

ELIMINAR /api/v1/domains/{domain_id}/

Eliminar o dominio

Elimina un dominio da súa conta. Isto non cancela o rexistro do dominio, só o elimina da xestión da conta VPS.org.

Parámetros da ruta

Parámetros	Tipo	Obrigatorio	Descrición
`domain_id`	integer	Si	Unique domain ID

Exemplo de solicitude

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

Códigos de estado de resposta

204	Domain removed from account successfully
401	Non autorizado: token de autenticación non válido ou falta
404	Non atopado - O dominio non existe

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/

Transferir o dominio

Iniciar unha transferencia de dominio a VPS.org desde outro rexistrador.

Parámetros da ruta

Parámetros	Tipo	Obrigatorio	Descrición
`domain_id`	integer	Si	Unique domain ID

Parámetros do corpo da solicitude

Parámetros	Tipo	Obrigatorio	Descrición
`auth_code`	string	Si	EPP/Authorization code from current registrar
`auto_renew`	boolean	Non	Enable auto-renewal after transfer (default: true)

Exemplo de solicitude

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

Exemplo de resposta

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

Códigos de estado de resposta

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Non autorizado: token de autenticación non válido ou falta
404	Non atopado - O dominio non existe
402	Payment Required - Insufficient account balance for transfer fee

Requisitos de transferencia:

O dominio debe estar desbloqueado no rexistrador actual
O dominio debe ter polo menos 60 días
Requírese un código EPP/Auth válido
O correo electrónico WHOIS debe ser accesible para a aprobación
A transferencia inclúe unha renovación de 1 ano (aplica unha comisión)

Prezos dos dominios

TLD populares

TLD	Rexistro (1 ano)	Renovación	Transferencia
.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

Características incluídas

✓ Protección de privacidade WHOIS libre
✓ Xestión de DNS libre
✓ Reenvío de correo libre
✓ Reenvío de dominios libres

✓ Bloqueo de dominio libre
✓ Soporte 24/ 7
✓ Xestión do dominio sinxela
✓ Opción de renovación automática

Mellores prácticas de xestión de dominios

Seguridade

Activar o bloqueo de dominios: Impede transferencias non autorizadas
Activar a protección da privacidade: Agocha a súa información persoal de WHOIS
Empregar contrasinais fortes: Protexa a súa conta VPS.org
Activar a 2FA: Engadir seguridade adicional á súa conta
Vixiar as datas de caducidade: Configurar a renovación automática ou lembranzas do calendario

Configuración

Configuración do DNS: Apunte os servidores de nomes a VPS.org para unha xestión sinxela
Renovación automática: Activar para evitar a caducidade accidental do dominio
Información do contacto: Manter actualizada a información de contacto WHOIS
Copia de seguridade do DNS: Considerar o provedor DNS secundario para redundancia

Transferencias

Bloqueo de 60 días: Os dominios non se poden transferir dentro dos 60 días do rexistro ou da transferencia anterior
Desbloquear o dominio: Debe desbloquearse no rexistrador actual antes da transferencia
Obter o código de autenticación: Pedir o código de autorización/EPP do rexistrador actual
Comprobar o correo electrónico: Recibirá correos electrónicos de aprobación durante o proceso de transferencia
Planificar con antelación: As transferencias poden tardar entre 5 e 7 días en completarse

VPS.org API

API de dominios

Listar todos os dominios

Parámetros de consulta

Exemplo de solicitude

Exemplo de resposta

Códigos de estado de resposta

Rexistra un novo dominio

Parámetros do corpo da solicitude

Exemplo de solicitude

Exemplo de resposta

Códigos de estado de resposta

Obter os detalles do dominio

Parámetros da ruta

Exemplo de solicitude

Exemplo de resposta

Códigos de estado de resposta

Actualizar a configuración do dominio

Parámetros da ruta

Parámetros do corpo da solicitude

Exemplo de solicitude

Exemplo de resposta

Códigos de estado de resposta

Eliminar o dominio

Parámetros da ruta

Exemplo de solicitude

Códigos de estado de resposta

Transferir o dominio

Parámetros da ruta

Parámetros do corpo da solicitude

Exemplo de solicitude

Exemplo de resposta

Códigos de estado de resposta

Prezos dos dominios

TLD populares

Características incluídas

Mellores prácticas de xestión de dominios

Seguridade

Configuración

Transferencias