VPS.org API

Tahirin-kevitra REST API

Domains API

Tantano ny fisoratana anarana, fanavaozana ary fandrindrana sehatra amin'ny alàlan'ny fandaharana.

Teboka farany 6 endpoints
Lalana fototra /api/v1/domains
ALAO /api/v1/domains/

Tanisao ny sehatra rehetra

Maka ny lisitr'ireo domena voasoratra amin'ny kaontinao.

Paramètres de requête

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
status string Tsy misy Filter by status: active, pending, expired, locked
search string Tsy misy Fikarohana sehatra araka ny anarany

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Kaody momba ny satan'ny valiny

200 Voaray soa aman-tsara ny lisitry ny sehatra
401 Tsy nahazoana alalana - Tsy manan-kery na tsy ampy ny mari-pamantarana fanamarinana
POST /api/v1/domains/

Misoratra anarana sehatra vaovao

Manorata anarana domena vaovao. Tokony hojerena aloha ny fisian'ny domena alohan'ny hanoratana.

Fangatahana masontsivana momba ny vatana

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
domain_name string ENY Domain name to register (e.g., "example.com")
years integer Tsy misy Registration period in years (1-10, default: 1)
auto_renew boolean Tsy misy Enable automatic renewal (default: true)
privacy_protection boolean Tsy misy Enable WHOIS privacy protection (default: true)
nameservers array Tsy misy Custom nameservers (default: VPS.org nameservers)

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Kaody momba ny satan'ny valiny

201 Domain registration initiated successfully
400 Bad Request - Invalid domain name or domain already registered
401 Tsy nahazoana alalana - Tsy manan-kery na tsy ampy ny mari-pamantarana fanamarinana
402 Payment Required - Insufficient account balance
Fanamarihana: 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.
ALAO /api/v1/domains/{domain_id}/

Maka ny antsipirian'ny domena

Maka ny lazan'ny domena voafaritra.

Masontsivana momba ny lalana

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
domain_id integer ENY Unique domain ID

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Kaody momba ny satan'ny valiny

200 Successfully retrieved domain details
401 Tsy nahazoana alalana - Tsy manan-kery na tsy ampy ny mari-pamantarana fanamarinana
404 Tsy hita - Tsy misy ny sehatra
ataovy /api/v1/domains/{domain_id}/

Hanova ny fandrindrana ny domena

Hanova ny kirakiran'ny domena toy ny fanavaozana hoazy, mpizara anarana, ary ny fandrindrana ny fiainana manokana.

Masontsivana momba ny lalana

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
domain_id integer ENY Unique domain ID

Fangatahana masontsivana momba ny vatana

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
auto_renew boolean Tsy misy Enable or disable automatic renewal
privacy_protection boolean Tsy misy Enable or disable WHOIS privacy
nameservers array Tsy misy Update nameservers (2-4 nameservers required)
locked boolean Tsy misy Lock or unlock domain to prevent transfers

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Kaody momba ny satan'ny valiny

200 Domain updated successfully
400 Bad Request - Invalid parameters
401 Tsy nahazoana alalana - Tsy manan-kery na tsy ampy ny mari-pamantarana fanamarinana
404 Tsy hita - Tsy misy ny sehatra
Fafao /api/v1/domains/{domain_id}/

Fafao ilay domena

Manafoana domena iray ao amin'ny kaontinao. Tsy manafoana ny fisoratana anarana domena izany - fa manaisotra azy fotsiny amin'ny fitantanana ny kaontinao VPS.org.

Masontsivana momba ny lalana

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
domain_id integer ENY Unique domain ID

Ohatra amin'ny fangatahana

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

Kaody momba ny satan'ny valiny

204 Domain removed from account successfully
401 Tsy nahazoana alalana - Tsy manan-kery na tsy ampy ny mari-pamantarana fanamarinana
404 Tsy hita - Tsy misy ny sehatra
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/

Hanova ny _Domain

Initiate a domain transfer to VPS.org from another registrar.

Masontsivana momba ny lalana

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
domain_id integer ENY Unique domain ID

Fangatahana masontsivana momba ny vatana

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
auth_code string ENY EPP/Authorization code from current registrar
auto_renew boolean Tsy misy Enable auto-renewal after transfer (default: true)

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Kaody momba ny satan'ny valiny

200 Transfer initiated successfully
400 Bad Request - Invalid auth code or domain not eligible for transfer
401 Tsy nahazoana alalana - Tsy manan-kery na tsy ampy ny mari-pamantarana fanamarinana
404 Tsy hita - Tsy misy ny sehatra
402 Payment Required - Insufficient account balance for transfer fee
Fandraisana an-tànana:
  • Tsy maintsy alefa any amin'ny mpitantana izao ilay domena
  • Tsy maintsy 60 andro farafahakeliny ny faharetan'ilay domain
  • Mila famaha EPP/Auth mitombina
  • Tsy maintsy azo ampiasaina ny mailaka WHOIS mba hahazoana fankatoavana
  • Ahitana fanavaozana 1 taona ny fanovàna (mihatra ny sarany)

Famaritana ny domena

TLD malaza

TLD Fisoratana anarana (1 taona) Fanavaozana Fandefasana
.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

Endri-javatra tafiditra

  • ✓ Fiarovana ny fiainana manokana WHOIS maimaimpoana
  • ✓ Fandrindrana DNS maimaimpoana
  • ✓ Fandefasana mailaka maimaimpoana
  • ✓ Fandefasana ny _Domain
  • ✓ Free Domain Locking
  • ✓ Fanohanana 24/7
  • ✓ Fandrindrana Domain
  • ✓ Safidin'ny fanavaozana hoazy

Fomba tsara indrindra ahafahana mitantana ny domena

Fiarovana

Fandrindrana

Fandefasana