API de domínios

PEGAR /api/v1/domains/

Listar todos os domínios

Obtenha uma lista de todos os domínios registrados em sua conta.

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Descrição
`status`	string	Não	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Não	Pesquisar domínios por nome

Exemplo de solicitação

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 status de resposta

200	Lista de domínios recuperada com sucesso
401	Não autorizado - Token de autenticação inválido ou ausente

POST /api/v1/domains/

Registre um novo domínio

Registrar um novo nome de domínio. A disponibilidade do domínio deve ser verificada antes do registro.

Parâmetros do corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`domain_name`	string	Sim	Domain name to register (e.g., "example.com")
`years`	integer	Não	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Não	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Não	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Não	Custom nameservers (default: VPS.org nameservers)

Exemplo de solicitação

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 status de resposta

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Não autorizado - Token de autenticação inválido ou ausente
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.

PEGAR /api/v1/domains/{domain_id}/

Obter Detalhes do Domínio

Obtenha informações detalhadas sobre um domínio específico.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`domain_id`	integer	Sim	Unique domain ID

Exemplo de solicitação

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 status de resposta

200	Successfully retrieved domain details
401	Não autorizado - Token de autenticação inválido ou ausente
404	Não encontrado - O domínio não existe.

COLOCAR /api/v1/domains/{domain_id}/

Actualizar as Configurações do Domínio

Atualizar configuração de domínios como renovação automática, servidores de nomes e configurações de privacidade.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`domain_id`	integer	Sim	Unique domain ID

Parâmetros do corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`auto_renew`	boolean	Não	Enable or disable automatic renewal
`privacy_protection`	boolean	Não	Enable or disable WHOIS privacy
`nameservers`	array	Não	Update nameservers (2-4 nameservers required)
`locked`	boolean	Não	Lock or unlock domain to prevent transfers

Exemplo de solicitação

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 status de resposta

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Não autorizado - Token de autenticação inválido ou ausente
404	Não encontrado - O domínio não existe.

EXCLUIR /api/v1/domains/{domain_id}/

Apagar Domínio

Elimine um domínio da sua conta. Isto não cancela o registro de domínio - ele só o remove da sua gestão de contas VPS.org.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`domain_id`	integer	Sim	Unique domain ID

Exemplo de solicitação

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 status de resposta

204	Domain removed from account successfully
401	Não autorizado - Token de autenticação inválido ou ausente
404	Não encontrado - O domínio não 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/

Domínio de Transferência

Inicie uma transferência de domínio para VPS.org de outro registrador.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`domain_id`	integer	Sim	Unique domain ID

Parâmetros do corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`auth_code`	string	Sim	EPP/Authorization code from current registrar
`auto_renew`	boolean	Não	Enable auto-renewal after transfer (default: true)

Exemplo de solicitação

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 status de resposta

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Não autorizado - Token de autenticação inválido ou ausente
404	Não encontrado - O domínio não existe.
402	Payment Required - Insufficient account balance for transfer fee

Requisitos de transferência:

O domínio deve ser desbloqueado no registrador actual
O domínio deve ter pelo menos 60 dias de idade
Código EPP/Auth válido exigido
O email WHOIS deve ser acessível para aprovação
A transferência inclui a renovação de 1 ano (aplicável)

Preços de domínio

TLD populares

TLD	Registo (1 ano)	Renovação	Transferência
.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

Recursos incluídos

✓ Proteção de Privacidade WHOIS gratuita
✓ Gestão de DNS Livre
✓ Reencaminhamento gratuito de e-mail
✓ Reencaminhamento de Domínio Livre

✓ Bloqueio de Domínio Livre
✓ Suporte 24/7
✓ Gestão de Domínio Fácil
✓ Opção de Renovação Automática

Gestão de Domínio Melhores Práticas

Segurança

Activar o bloqueio de domínios: Impede transferências não autorizadas
Activar a Proteção da Privacidade: Esconde suas informações pessoais do WHOIS
Usar senhas fortes: Proteja a sua conta VPS.org
Activar 2FA: Adicione segurança adicional à sua conta
Datas de caducidade do monitor: Configuração de lembranças de renovação automática ou de calendário

Configuração

Configuração do DNS: Servidores de nomes de ponto para VPS.org para fácil gerenciamento
Renovação automática: Activar para evitar a expiração acidental do domínio
Informações de contacto: Mantenha actualizado a informação de contato WHOIS
DNS de backup: Considere provedor de DNS secundário para redundância

Transferências

Bloqueio de 60 dias: Os domínios não podem ser transferidos no prazo de 60 dias após o registo ou transferência anterior
Desbloquear o domínio: Deve ser desbloqueado no registrador atual antes da transferência
Obter o Código de Auth: Solicitar código EPP/autorização do registrador atual
Verificar o e-mail: Você receberá e-mails de aprovação durante o processo de transferência
Plano antecipado: As transferências podem demorar 5-7 dias para completar

VPS.org API

API de domínios

Listar todos os domínios

Parâmetros de consulta

Exemplo de solicitação

Exemplo de resposta

Códigos de status de resposta

Registre um novo domínio

Parâmetros do corpo da requisição

Exemplo de solicitação

Exemplo de resposta

Códigos de status de resposta

Obter Detalhes do Domínio

Parâmetros de caminho

Exemplo de solicitação

Exemplo de resposta

Códigos de status de resposta

Actualizar as Configurações do Domínio

Parâmetros de caminho

Parâmetros do corpo da requisição

Exemplo de solicitação

Exemplo de resposta

Códigos de status de resposta

Apagar Domínio

Parâmetros de caminho

Exemplo de solicitação

Códigos de status de resposta

Domínio de Transferência

Parâmetros de caminho

Parâmetros do corpo da requisição

Exemplo de solicitação

Exemplo de resposta

Códigos de status de resposta

Preços de domínio

TLD populares

Recursos incluídos

Gestão de Domínio Melhores Práticas

Segurança

Configuração

Transferências