VPS.org API

REST API دستاویزی

ڈومینز API

ڈومین رجسٹریشن، تجدید، اور ترتیب کو پروگرام کے لحاظ سے منظم کریں۔

اینڈ پوائنٹس 6 endpoints
بنیاد کا راستہ /api/v1/domains
حاصل کریں۔ /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 سہولت
  • ✓ آسان ڈومین انتظام
  • ✓ خودکار تجدید اختیار

ڈومین انتظامی کے بہترین طریقے

محفوظ

کوکیز

منتقل