Domenji API

IKSEB /api/v1/domains/

Elenka d-Dominji Kollha

Iġbor lista tad-dominji kollha rreġistrati taħt il-kont tiegħek.

Parametri tal-Mistoqsija

Parametru	Tip	Meħtieġ	Deskrizzjoni
`status`	string	Nru	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	Nru	Fittex dominji bl-isem

Eżempju ta' Talba

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

Eżempju ta' Rispons

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

Kodiċijiet tal-Istatus tar-Rispons

200	Lista ta' dominji rkuprata b'suċċess
401	Mhux Awtorizzat - Token ta' awtentikazzjoni mhux validu jew nieqes

POST /api/v1/domains/

Irreġistra Dominju Ġdid

Irreġistra isem ta' dominju ġdid. Id-disponibbiltà tad-dominju għandha tiġi ċċekkjata qabel ir-reġistrazzjoni.

Parametri tal-Korp tat-Talba

Parametru	Tip	Meħtieġ	Deskrizzjoni
`domain_name`	string	Iva	Domain name to register (e.g., "example.com")
`years`	integer	Nru	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	Nru	Enable automatic renewal (default: true)
`privacy_protection`	boolean	Nru	Enable WHOIS privacy protection (default: true)
`nameservers`	array	Nru	Custom nameservers (default: VPS.org nameservers)

Eżempju ta' Talba

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

Eżempju ta' Rispons

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

Kodiċijiet tal-Istatus tar-Rispons

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	Mhux Awtorizzat - Token ta' awtentikazzjoni mhux validu jew nieqes
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.

IKSEB /api/v1/domains/{domain_id}/

Ikseb Dettalji tad-Dominju

Iġbor informazzjoni dettaljata dwar dominju speċifiku.

Parametri tal-Mogħdija

Parametru	Tip	Meħtieġ	Deskrizzjoni
`domain_id`	integer	Iva	Unique domain ID

Eżempju ta' Talba

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

Eżempju ta' Rispons

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

Kodiċijiet tal-Istatus tar-Rispons

200	Successfully retrieved domain details
401	Mhux Awtorizzat - Token ta' awtentikazzjoni mhux validu jew nieqes
404	Ma nstabx - Id-Dominju ma jeżistix

POĠĠI /api/v1/domains/{domain_id}/

Aġġornament Domain Settings

Aġġorna l-konfigurazzjoni tad-dominju bħal tiġdid awtomatiku, nameservers, u settings tal-privatezza.

Parametri tal-Mogħdija

Parametru	Tip	Meħtieġ	Deskrizzjoni
`domain_id`	integer	Iva	Unique domain ID

Parametri tal-Korp tat-Talba

Parametru	Tip	Meħtieġ	Deskrizzjoni
`auto_renew`	boolean	Nru	Enable or disable automatic renewal
`privacy_protection`	boolean	Nru	Enable or disable WHOIS privacy
`nameservers`	array	Nru	Update nameservers (2-4 nameservers required)
`locked`	boolean	Nru	Lock or unlock domain to prevent transfers

Eżempju ta' Talba

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

Eżempju ta' Rispons

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

Kodiċijiet tal-Istatus tar-Rispons

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	Mhux Awtorizzat - Token ta' awtentikazzjoni mhux validu jew nieqes
404	Ma nstabx - Id-Dominju ma jeżistix

ĦASSAR /api/v1/domains/{domain_id}/

Ħassar Domain

Ħassar dominju mill-kont tiegħek Dan ma jħassarx ir-reġistrazzjoni tad-dominju - dan ineħħih biss mill-amministrazzjoni tal-kont VPS.org tiegħek.

Parametri tal-Mogħdija

Parametru	Tip	Meħtieġ	Deskrizzjoni
`domain_id`	integer	Iva	Unique domain ID

Eżempju ta' Talba

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

Kodiċijiet tal-Istatus tar-Rispons

204	Domain removed from account successfully
401	Mhux Awtorizzat - Token ta' awtentikazzjoni mhux validu jew nieqes
404	Ma nstabx - Id-Dominju ma jeżistix

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/

Trasferiment ta' Domeniu

Ibda trasferiment ta' dominju għal VPS.org minn reġistrant ieħor.

Parametri tal-Mogħdija

Parametru	Tip	Meħtieġ	Deskrizzjoni
`domain_id`	integer	Iva	Unique domain ID

Parametri tal-Korp tat-Talba

Parametru	Tip	Meħtieġ	Deskrizzjoni
`auth_code`	string	Iva	EPP/Authorization code from current registrar
`auto_renew`	boolean	Nru	Enable auto-renewal after transfer (default: true)

Eżempju ta' Talba

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

Eżempju ta' Rispons

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

Kodiċijiet tal-Istatus tar-Rispons

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	Mhux Awtorizzat - Token ta' awtentikazzjoni mhux validu jew nieqes
404	Ma nstabx - Id-Dominju ma jeżistix
402	Payment Required - Insufficient account balance for transfer fee

Rekwiżiti tat-trasferiment:

Id-dominju għandu jiġi aċċessat mir-reġistratur kurrenti
Id-dominju għandu jkun ta' mill-inqas 60 jum
Kodiċi validu EPP/Auth meħtieġ
L-email WHOIS trid tkun aċċessibbli għall-approvazzjoni
It-trasferiment jinkludi tiġdid ta' sena (tapplika tariffa)

Prezzijiet tad-Dominju

TLDs popolari

TLD	Reġistrazzjoni (sena)	Tiġdid	Trasferiment
.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

Karatteristiċi Inklużi

✓ Protezzjoni tal-Privatezza WHOIS Ħieles
✓ Ġestjoni tad-DNS Ħieles
✓ Free Email Tgħaddi
✓ Free Domain Tbegħid

✓ Free Domain imblokk
✓ Appoġġ 24/7
✓ Ġestjoni tad-Dominju Faċli
✓ Għażla tat-Tiġdid Awtomatiku

L-Aħjar Prattiki tal-Ġestjoni tad-Dominju

Sigurtà

Attiva l-Illokkjar tad-Dominju: Tipprevjeni trasferimenti mhux awtorizzati
Jippermettu l-Protezzjoni tal-Privatezza: Jaħbi l-informazzjoni personali tiegħek minn WHOIS
Uża passwords b'saħħithom: Ipproteġi l-kont tiegħek VPS.org
Attiva l-2FA: Żid sigurtà żejda mal-kont tiegħek
Data ta ’ skadenza tal- monitor: Issettja t-tiġdid awtomatiku jew tfakkiriet tal-kalendarju

Konfigurazzjoni

Issettjar tad-DNS: Nameservers tal-punt għal VPS.org għal ġestjoni faċli
Awto- tiġdid: Attiva biex tipprevjeni l-iskadenza aċċidentali tad-dominju
Informazzjoni ta’ kuntatt: Żomm l-informazzjoni ta' kuntatt WHOIS aġġornata
Backup DNS: Ikkunsidra fornitur tad-DNS sekondarju għar-ridondanza

Trasferimenti

60- Jum Lock: Id-dominji ma jistgħux jiġu trasferiti fi żmien 60 jum mir-reġistrazzjoni jew trasferiment preċedenti
Ħolqien ta' Domain: Għandu jiġi aċċessat mir-reġistrant kurrenti qabel it-trasferiment
Ikseb Auth Kodiċi: Talba EPP/kodiċi ta' awtorizzazzjoni mir-reġistratur kurrenti
Iċċekkja l-Email: Inti ser tirċievi emails approvazzjoni matul il-proċess tat-trasferiment
Ippjana bil-quddiem: It-trasferimenti jistgħu jieħdu 5-7 ijiem biex jitlestew

VPS.org API

Elenka d-Dominji Kollha

Parametri tal-Mistoqsija

Eżempju ta' Talba

Eżempju ta' Rispons

Kodiċijiet tal-Istatus tar-Rispons

Irreġistra Dominju Ġdid

Parametri tal-Korp tat-Talba

Eżempju ta' Talba

Eżempju ta' Rispons

Kodiċijiet tal-Istatus tar-Rispons

Ikseb Dettalji tad-Dominju

Parametri tal-Mogħdija

Eżempju ta' Talba

Eżempju ta' Rispons

Kodiċijiet tal-Istatus tar-Rispons

Aġġornament Domain Settings

Parametri tal-Mogħdija

Parametri tal-Korp tat-Talba

Eżempju ta' Talba

Eżempju ta' Rispons

Kodiċijiet tal-Istatus tar-Rispons

Ħassar Domain

Parametri tal-Mogħdija

Eżempju ta' Talba

Kodiċijiet tal-Istatus tar-Rispons

Trasferiment ta' Domeniu

Parametri tal-Mogħdija

Parametri tal-Korp tat-Talba

Eżempju ta' Talba

Eżempju ta' Rispons

Kodiċijiet tal-Istatus tar-Rispons

Prezzijiet tad-Dominju

TLDs popolari

Karatteristiċi Inklużi

L-Aħjar Prattiki tal-Ġestjoni tad-Dominju

Sigurtà

Konfigurazzjoni

Trasferimenti