ڊومين API

حاصل ڪريو /api/v1/domains/

سڀني ڊومينز جي فهرست ڏيو

پنھنجي اڪائونٽ ھيٺ رجسٽر ٿيل سڀني ڊومينز جي قائمة حاصل ڪريو.

سوال جا پيرا ميٽر

پيراميڊ	قسم	گهربل	بيان
`status`	string	نه	Filter by status: `active`, `pending`, `expired`, `locked`
`search`	string	نه	نالي سان ڊومينز ڳوليو

مثال جي درخواست

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

مثال جواب

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

جوابي اسٽيٽس ڪوڊس

200	ڊومينز جي فهرست ڪاميابي سان حاصل ڪئي وئي
401	غير مجاز - غلط يا گم ٿيل تصديق ٽوڪن

پوسٽ /api/v1/domains/

نئون ڊومين رجسٽر ڪريو

نئون ڊومين جو نالو رجسٽر ڪريو. رجسٽريشن کان اڳ ڊومين جي موجودگي کي چيڪ ڪرڻ گھرجي.

درخواست باڊي پيرا ميٽرز

پيراميڊ	قسم	گهربل	بيان
`domain_name`	string	ها	Domain name to register (e.g., "example.com")
`years`	integer	نه	Registration period in years (1-10, default: 1)
`auto_renew`	boolean	نه	Enable automatic renewal (default: true)
`privacy_protection`	boolean	نه	Enable WHOIS privacy protection (default: true)
`nameservers`	array	نه	Custom nameservers (default: VPS.org nameservers)

مثال جي درخواست

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

مثال جواب

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

جوابي اسٽيٽس ڪوڊس

201	Domain registration initiated successfully
400	Bad Request - Invalid domain name or domain already registered
401	غير مجاز - غلط يا گم ٿيل تصديق ٽوڪن
402	Payment Required - Insufficient account balance

نوٽ: 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.

حاصل ڪريو /api/v1/domains/{domain_id}/

ڊومين جون تفصيلون حاصل ڪريو

خاص ڊومين بابت تفصيلي معلومات حاصل ڪريو.

رستي جا پيرا ميٽر

پيراميڊ	قسم	گهربل	بيان
`domain_id`	integer	ها	Unique domain ID

مثال جي درخواست

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

مثال جواب

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

جوابي اسٽيٽس ڪوڊس

200	Successfully retrieved domain details
401	غير مجاز - غلط يا گم ٿيل تصديق ٽوڪن
404	نه مليو - ڊومين موجود ناهي

رک /api/v1/domains/{domain_id}/

ڊومين جي ترتيب

ڊومين جي ڪنٽرول کي اپڊيٽ ڪريو جيئن خودڪار- نئين سر شروع ڪرڻ، نيم سرورز، ۽ پرائيويٽ سيٽنگ.

رستي جا پيرا ميٽر

پيراميڊ	قسم	گهربل	بيان
`domain_id`	integer	ها	Unique domain ID

درخواست باڊي پيرا ميٽرز

پيراميڊ	قسم	گهربل	بيان
`auto_renew`	boolean	نه	Enable or disable automatic renewal
`privacy_protection`	boolean	نه	Enable or disable WHOIS privacy
`nameservers`	array	نه	Update nameservers (2-4 nameservers required)
`locked`	boolean	نه	Lock or unlock domain to prevent transfers

مثال جي درخواست

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

مثال جواب

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

جوابي اسٽيٽس ڪوڊس

200	Domain updated successfully
400	Bad Request - Invalid parameters
401	غير مجاز - غلط يا گم ٿيل تصديق ٽوڪن
404	نه مليو - ڊومين موجود ناهي

ختم ڪريو /api/v1/domains/{domain_id}/

ڊومين حذف ڪريو

پنھنجي اڪائونٽ مان ھڪ ڊومين لڪايو. ھيء ڊومين جي رجسٽريشن کي ختم نه ڪندو آھي - اھو رڳو اھو توھان جي VPS.org اڪائونٽ جي انتظام مان لڪائيندو آھي.

رستي جا پيرا ميٽر

پيراميڊ	قسم	گهربل	بيان
`domain_id`	integer	ها	Unique domain ID

مثال جي درخواست

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

جوابي اسٽيٽس ڪوڊس

204	Domain removed from account successfully
401	غير مجاز - غلط يا گم ٿيل تصديق ٽوڪن
404	نه مليو - ڊومين موجود ناهي

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.

پوسٽ /api/v1/domains/{domain_id}/transfer/

ڊومين منتقل ڪريو

ٻيو رجسٽرار کان VPS.org کي ڊومين منتقلي شروع ڪريو.

رستي جا پيرا ميٽر

پيراميڊ	قسم	گهربل	بيان
`domain_id`	integer	ها	Unique domain ID

درخواست باڊي پيرا ميٽرز

پيراميڊ	قسم	گهربل	بيان
`auth_code`	string	ها	EPP/Authorization code from current registrar
`auto_renew`	boolean	نه	Enable auto-renewal after transfer (default: true)

مثال جي درخواست

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

مثال جواب

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

جوابي اسٽيٽس ڪوڊس

200	Transfer initiated successfully
400	Bad Request - Invalid auth code or domain not eligible for transfer
401	غير مجاز - غلط يا گم ٿيل تصديق ٽوڪن
404	نه مليو - ڊومين موجود ناهي
402	Payment Required - Insufficient account balance for transfer fee

منتقلي جي ضرورتون:

ڊومين کي ھن رجسٽرار تي کولڻ گھرجي
ڊومين کي گهٽ ۾ گهٽ 60 ڏينهن پراڻو هجڻ گھرجي
صحيح EPP/Auth ڪوڊ گھرجي
WHOIS اي ميل منظوريءَ لاءِ رسائي واري هجڻ گھرجي
منتقلي ۾ 1 سال جي نئين سر شامل آهي (فنڊ لاڳو ٿئي ٿو)

ڊومين جي قيمت

مشهور TLDs

ٽائل ڊومين	رجسٽريشن (1 سال)	ٻيهر شروع	منتقلي
.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

شامل خاصيتون

✓ WHOIS ذاتي حفاظت
✓ DNS انتظام
✓ اي ميل اڳتي موڪلڻ
✓ ڊومين اڳتي موڪلڻ

✓ مفت ڊومين
✓ 24/7 مدد
✓ ڊومين جو انتظام
✓ خودڪار اپڊيٽ جو اختيار

ڊومين جي انتظام جي بهترين طريقن

حفاظت

ڊومين لاڪ ڪرڻ کي فعال ڪريو: غير جائز منتقلين کي روڪي ٿو
ڳجھائي جي حفاظت کي فعال ڪريو: WHOIS کان پنھنجو ذاتي معلومات لڪائي ٿو
مضبوط پاسورڊ استعمال ڪريو: پنھنجي VPS.org اڪائونٽ کي بچايو
2FA فعال ڪريو: پنھنجي اڪائونٽ ۾ وڌيڪ حفاظت شامل ڪريو
آخري تاريخون ڏسو: پاڻمرادو اپڊيٽ يا ڪئلينڊر جي ياد ڏياريندڙن کي ترتيب ڏيو

ترتيب ڏيڻ

DNS ترتيب: آسان انتظام لاءِ VPS.org تي نيم سرورز اشارو ڪريو
پاڻمرادو نئين سر شروع: دومين جي عارضي ختم ٿيڻ کي روڪڻ لاءِ فعال ڪريو
رابطي جي معلومات: WHOIS رابطي جي معلومات کي تازو رک
DNS جي بچاءُ: ٻيو DNS فراهم ڪندڙ اضافي لاءِ غور ڪريو

منتقليون

60- ڏينھن لاڪ: ريگيوليشن يا اڳئين منتقلي جي 60 ڏينھن اندر ڊومين منتقل نه ٿي سگھن ٿا
ڊومين کوليو: منتقلي کان اڳ ھن رجسٽرار تي کولڻ گھرجي
تصديق جو ڪوڊ حاصل ڪريو: ھن رجسٽرر کان EPP/authorization ڪوڊ جي درخواست ڪريو
اي ميل جاچيو: منتقلي جي عمل دوران توھان کي منظوري جي اي ميلون ملنديون
اڳتي منصوبو: منتقلي مڪمل ڪرڻ ۾ 5-7 ڏينهن وٺي سگهي ٿي

VPS.org API

سڀني ڊومينز جي فهرست ڏيو

سوال جا پيرا ميٽر

مثال جي درخواست

مثال جواب

جوابي اسٽيٽس ڪوڊس

نئون ڊومين رجسٽر ڪريو

درخواست باڊي پيرا ميٽرز

مثال جي درخواست

مثال جواب

جوابي اسٽيٽس ڪوڊس

ڊومين جون تفصيلون حاصل ڪريو

رستي جا پيرا ميٽر

مثال جي درخواست

مثال جواب

جوابي اسٽيٽس ڪوڊس

ڊومين جي ترتيب

رستي جا پيرا ميٽر

درخواست باڊي پيرا ميٽرز

مثال جي درخواست

مثال جواب

جوابي اسٽيٽس ڪوڊس

ڊومين حذف ڪريو

رستي جا پيرا ميٽر

مثال جي درخواست

جوابي اسٽيٽس ڪوڊس

ڊومين منتقل ڪريو

رستي جا پيرا ميٽر

درخواست باڊي پيرا ميٽرز

مثال جي درخواست

مثال جواب

جوابي اسٽيٽس ڪوڊس

ڊومين جي قيمت

مشهور TLDs

شامل خاصيتون

ڊومين جي انتظام جي بهترين طريقن

حفاظت

ترتيب ڏيڻ

منتقليون