VPS.org API

REST API dokumentasyon

Mga Domain API

Pamahalaan ang pagpaparehistro, pag-renew, at pag-configure ng domain gamit ang programa.

Mga Endpoint 6 endpoints
Landas ng Batayan /api/v1/domains
KUMUHA /api/v1/domains/

Ilista ang Lahat ng Domain

Bumuo ng isang listahan ng lahat ng mga domain na nakarehistro sa ilalim ng iyong account.

Mga Parameter ng Query

Parameter Uri Kinakailangan Paglalarawan
status string Hindi Filter by status: active, pending, expired, locked
search string Hindi Maghanap ng mga domain ayon sa pangalan

Halimbawang Kahilingan

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

Halimbawang Tugon

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

Mga Kodigo ng Katayuan ng Tugon

200 Matagumpay na nakuha ang listahan ng mga domain
401 Hindi Awtorisado - Hindi wasto o nawawalang token ng pagpapatotoo
Post /api/v1/domains/

Magrehistro ng Bagong Domain

Mag-register ng bagong domain name. Domain availability ay dapat na suriin bago ang pagpaparehistro.

Humiling ng mga Parameter ng Katawan

Parameter Uri Kinakailangan Paglalarawan
domain_name string Oo Domain name to register (e.g., "example.com")
years integer Hindi Registration period in years (1-10, default: 1)
auto_renew boolean Hindi Enable automatic renewal (default: true)
privacy_protection boolean Hindi Enable WHOIS privacy protection (default: true)
nameservers array Hindi Custom nameservers (default: VPS.org nameservers)

Halimbawang Kahilingan

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

Halimbawang Tugon

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

Mga Kodigo ng Katayuan ng Tugon

201 Domain registration initiated successfully
400 Bad Request - Invalid domain name or domain already registered
401 Hindi Awtorisado - Hindi wasto o nawawalang token ng pagpapatotoo
402 Payment Required - Insufficient account balance
Tandaan: 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.
KUMUHA /api/v1/domains/{domain_id}/

Kumuha ng mga detalye ng domain

Bumalik detalyadong impormasyon tungkol sa isang tiyak na domain.

Mga Parameter ng Landas

Parameter Uri Kinakailangan Paglalarawan
domain_id integer Oo Unique domain ID

Halimbawang Kahilingan

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

Halimbawang Tugon

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

Mga Kodigo ng Katayuan ng Tugon

200 Successfully retrieved domain details
401 Hindi Awtorisado - Hindi wasto o nawawalang token ng pagpapatotoo
404 Hindi Natagpuan - Walang domain
ILAGAY /api/v1/domains/{domain_id}/

I-update ang mga setting ng domain

I-update ang domain configuration tulad ng auto-renewal, nameservers, at mga setting ng privacy.

Mga Parameter ng Landas

Parameter Uri Kinakailangan Paglalarawan
domain_id integer Oo Unique domain ID

Humiling ng mga Parameter ng Katawan

Parameter Uri Kinakailangan Paglalarawan
auto_renew boolean Hindi Enable or disable automatic renewal
privacy_protection boolean Hindi Enable or disable WHOIS privacy
nameservers array Hindi Update nameservers (2-4 nameservers required)
locked boolean Hindi Lock or unlock domain to prevent transfers

Halimbawang Kahilingan

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

Halimbawang Tugon

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

Mga Kodigo ng Katayuan ng Tugon

200 Domain updated successfully
400 Bad Request - Invalid parameters
401 Hindi Awtorisado - Hindi wasto o nawawalang token ng pagpapatotoo
404 Hindi Natagpuan - Walang domain
TANGGALIN /api/v1/domains/{domain_id}/

Magtanggal ng Domain

I-Delete ang isang domain mula sa iyong account. Hindi ito i-cancel ang domain registration - ito lamang ang inaalis ito mula sa iyong VPS.org account management.

Mga Parameter ng Landas

Parameter Uri Kinakailangan Paglalarawan
domain_id integer Oo Unique domain ID

Halimbawang Kahilingan

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

Mga Kodigo ng Katayuan ng Tugon

204 Domain removed from account successfully
401 Hindi Awtorisado - Hindi wasto o nawawalang token ng pagpapatotoo
404 Hindi Natagpuan - Walang domain
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/

Maglipat ng Domain

Mag-inisyal ng isang domain transfer sa VPS.org mula sa ibang registrar.

Mga Parameter ng Landas

Parameter Uri Kinakailangan Paglalarawan
domain_id integer Oo Unique domain ID

Humiling ng mga Parameter ng Katawan

Parameter Uri Kinakailangan Paglalarawan
auth_code string Oo EPP/Authorization code from current registrar
auto_renew boolean Hindi Enable auto-renewal after transfer (default: true)

Halimbawang Kahilingan

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

Halimbawang Tugon

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

Mga Kodigo ng Katayuan ng Tugon

200 Transfer initiated successfully
400 Bad Request - Invalid auth code or domain not eligible for transfer
401 Hindi Awtorisado - Hindi wasto o nawawalang token ng pagpapatotoo
404 Hindi Natagpuan - Walang domain
402 Payment Required - Insufficient account balance for transfer fee
Transfer Kailangan:
  • Domain ay dapat na unlock sa kasalukuyang registrar
  • Domain ay dapat na hindi ba sa 60 araw gulang
  • Mahalagang magkaroon ng wastong EPP/Auth code
  • WHOIS email ay dapat na maa-access para sa pag-apruba
  • Kasama sa transfer ang 1-taong renewal (may bayad)

Pagpepresyo ng Domain

Mga Popular na TLD

Talaan ng mga TLD Registration (1 taon) Pagbabago Ilipat
.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

Mga Kasamang Tampok

  • ✓ Libreng WHOIS Proteksyon ng Privacy
  • ✓ Libreng DNS Pamamahala
  • ✓ Libreng Email Paghahatid
  • ✓ Libreng Domain Pag-redirect
  • ✓ Libreng Domain Locking
  • ✓ 24/7 Suporta
  • ✓ Madaling Pamamahala ng Domain
  • ✓ Auto-Renewal pagpipilian

Pamamahala ng Domain Pinakamahusay na Mga Paraan

Seguridad

Konfigurasyon

Mga Paglipat