API de dominios

CONSEGUIR /api/v1/domains/

Listar todos los dominios

Recupera una lista de todos los dominios registrados en tu cuenta.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
`status`	string	No	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	No	Buscar dominios por nombre

Ejemplo de solicitud

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

Ejemplo de respuesta

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

200	Lista de dominios recuperada con éxito
401	No autorizado: token de autenticación no válido o faltante

POST /api/v1/domains/

Registrar nuevo dominio

Registrar un nuevo nombre de dominio. La disponibilidad de dominio se debe comprobar antes de registrarse.

Parámetros del cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
`domain_name`	string	Sí	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)

Ejemplo de solicitud

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

Ejemplo de respuesta

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

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

CONSEGUIR /api/v1/domains/{domain_id}/

Obtener detalles de dominio

Recuperar información detallada sobre un dominio específico.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`domain_id`	integer	Sí	Unique domain ID

Ejemplo de solicitud

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

Ejemplo de respuesta

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

200	Successfully retrieved domain details
401	No autorizado: token de autenticación no válido o faltante
404	No encontrado - El dominio no existe

PONER /api/v1/domains/{domain_id}/

Actualizar las preferencias de dominio

Actualizar la configuración del dominio, como la renovación automática, los servidores de nombres y la configuración de privacidad.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`domain_id`	integer	Sí	Unique domain ID

Parámetros del cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
`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

Ejemplo de solicitud

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

Ejemplo de respuesta

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

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	No autorizado: token de autenticación no válido o faltante
404	No encontrado - El dominio no existe

BORRAR /api/v1/domains/{domain_id}/

Eliminar dominio

Eliminar un dominio de su cuenta. Esto no cancela el registro de dominio - sólo lo elimina de su gestión de cuenta VPS.org.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`domain_id`	integer	Sí	Unique domain ID

Ejemplo de solicitud

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 respuesta

204	Domain removed from account successfully
401	No autorizado: token de autenticación no válido o faltante
404	No encontrado - El dominio no 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/

Dominio de transferencia

Iniciar una transferencia de dominio a VPS.org desde otro registrador.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`domain_id`	integer	Sí	Unique domain ID

Parámetros del cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
`auth_code`	string	Sí	EPP/Authorization code from current registrar
`auto_renew`	boolean	No	Enable auto-renewal after transfer (default: true)

Ejemplo de solicitud

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

Ejemplo de respuesta

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

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	No autorizado: token de autenticación no válido o faltante
404	No encontrado - El dominio no existe
402	Payment Required - Insufficient account balance for transfer fee

Requisitos de transferencia:

El dominio debe ser desbloqueado en el registrador actual
El dominio debe tener al menos 60 días de antigüedad
Se requiere un código EPP/Auth válido
WHOIS correo electrónico debe ser accesible para su aprobación
La transferencia incluye la renovación de un año (se aplica una tasa)

Precios de dominio

TLD populares

TLD	Inscripción (1 año)	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 incluidas

✓ Protección gratuita de la privacidad WHOIS
✓ Gestión gratuita de DNS
✓ Reenvío gratuito de correo electrónico
✓ Reenvío gratuito de dominio

✓ Bloqueo gratuito de dominio
✓ Apoyo 24/7
✓ Administración de dominios sencilla
✓ Opción de renovación automática

Mejores prácticas de gestión de dominios

Seguridad

Habilitar bloqueo de dominio: Evita las transferencias no autorizadas
Habilitar protección de privacidad: Oculta su información personal de WHOIS
Usar contraseñas fuertes: Proteja su cuenta VPS.org
Activar 2FA: Agregue seguridad adicional a su cuenta
Fechas de caducidad del monitor: Configurar recordatorios de renovación automática o calendario

Configuración

Configuración DNS: Denominadores de puntos a VPS.org para una gestión fácil
Renovación automática: Habilitar para prevenir la expiración accidental del dominio
Información de contacto: Mantenga actualizada la información de contacto de WHOIS
Respaldo DNS: Considere el proveedor secundario de DNS para la redundancia

Transferencias

Cerradura de 60 días: Los dominios no se pueden transferir dentro de los 60 días de registro o transferencia previa
Desbloquear dominio: Debe desbloquearse en el registrador actual antes de la transferencia
Obtenga el código Auth: Solicitar el código de EPP/autorización del registrador actual
Comprobar correo electrónico: Recibirás emails de aprobación durante el proceso de transferencia
Plan Ahead: Las transferencias pueden tardar 5-7 días en completarse

VPS.org API

API de dominios

Listar todos los dominios

Parámetros de consulta

Ejemplo de solicitud

Ejemplo de respuesta

Códigos de estado de respuesta

Registrar nuevo dominio

Parámetros del cuerpo de la solicitud

Ejemplo de solicitud

Ejemplo de respuesta

Códigos de estado de respuesta

Obtener detalles de dominio

Parámetros de ruta

Ejemplo de solicitud

Ejemplo de respuesta

Códigos de estado de respuesta

Actualizar las preferencias de dominio

Parámetros de ruta

Parámetros del cuerpo de la solicitud

Ejemplo de solicitud

Ejemplo de respuesta

Códigos de estado de respuesta

Eliminar dominio

Parámetros de ruta

Ejemplo de solicitud

Códigos de estado de respuesta

Dominio de transferencia

Parámetros de ruta

Parámetros del cuerpo de la solicitud

Ejemplo de solicitud

Ejemplo de respuesta

Códigos de estado de respuesta

Precios de dominio

TLD populares

Características incluidas

Mejores prácticas de gestión de dominios

Seguridad

Configuración

Transferencias