VPS.org API

REST API ডকুমেন্টেশন

ডোমেইন API

বিদ্যমান ডোমেইন নাম অনুসন্ধান করুন, ডোমেইন নিবন্ধন এবং পুনঃনির্ধারণ করুন, এবং তাদের নাম সার্ভার এবং স্বয়ংক্রিয় পুনঃনির্ধারণ পরিচালনা করুন। ডোমেইন তাদের uuid দ্বারা চিহ্নিত করা হয়।

শেষবিন্দু 7
বেস পাথ /api/v1/domains
পান /api/v1/domains/

সকল ডোমেন তালিকাভুক্ত করুন

আপনার অ্যাকাউন্টে নিবন্ধিত ডোমেইনগুলি ফিরিয়ে দেয়, প্রতি পৃষ্ঠাতে ২৫ টি । তালিকায় কোন ফিল্টার নেই ।

অনুমতি প্রয়োজন: domains:list

উদাহরণ অনুরোধ

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/domains/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/domains/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for domain in response.json()["results"]:
    print(domain["domain_name"], domain["status"], domain["expiration_date"])
const response = await fetch('https://admin.vps.org/api/v1/domains/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

উদাহরণ প্রতিক্রিয়া

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
      "domain_name": "example.com",
      "status": "active",
      "registrar": "dynadot",
      "registration_date": "2026-01-15T10:30:00Z",
      "expiration_date": "2027-01-15T10:30:00Z",
      "days_until_expiration": 122,
      "is_expired": false,
      "needs_renewal_soon": false,
      "auto_renew": true,
      "renewal_period_years": 1,
      "registration_price": "12.64",
      "renewal_price": "12.64",
      "whois_privacy": true,
      "nameserver1": "ns1.vps.org",
      "nameserver2": "ns2.vps.org",
      "nameserver3": "ns3.vps.org",
      "nameserver4": null,
      "transfer_lock": true,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-09-01T08:12:40Z"
    }
  ]
}

প্রতিক্রিয়া ক্ষেত্র

ক্ষেত্র আদর্শ বর্ণনা
uuid string অন্যান্য ডোমেইন এনডোমেন্টে ব্যবহৃত ডোমেইন পরিচায়ক
status string active, pending, expired, cancelled, transferred
registrar string ডোমেইনটি যেখানে রয়েছে তার রেজিস্ট্রার
registration_date, expiration_date datetime ডোমেইনটি কখন নিবন্ধিত হয়েছিল এবং কখন তা মেয়াদ শেষ হয়। মেয়াদ শেষের তারিখ null হতে পারে।
days_until_expiration integer | null মেয়াদ শেষ হওয়ার তারিখ পর্যন্ত পূর্ণ দিন, মেয়াদ শেষ হলে ঋণাত্মক
is_expired, needs_renewal_soon boolean ডোমেইনটি মেয়াদ শেষ হয়েছে কিনা এবং পরবর্তী ৩০ দিনের মধ্যে মেয়াদ শেষ হবে কিনা
auto_renew, renewal_period_years boolean, integer ডোমেইন স্বয়ংক্রিয়ভাবে নতুন করে তৈরি করা হবে কি না এবং কত বছর ধরে
registration_price, renewal_price string দশমিক পংক্তি হিসাবে USD- এ মূল্য
whois_privacy, transfer_lock boolean WHOIS গোপনীয়তা এবং রেজিস্ট্রার ট্রান্সফার লক সেটিংস
nameserver1 to nameserver4 string | null ডোমেইনের নেম সার্ভার
created_at, updated_at datetime রেকর্ডটি কতক্ষণে তৈরি করা হয়েছে এবং শেষবার পরিবর্তন করা হয়েছে (ISO 8601, UTC)
পান /api/v1/domains/{uuid}/

ডোমেইন বিবরণ প্রাপ্ত করো

উপরের ক্ষেত্র সহ একটি ডোমেইন বস্তু ফিরিয়ে দেয় ।

অনুমতি প্রয়োজন: domains:list

curl -X GET "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

প্রতিক্রিয়া স্থিতি কোড

200 সফলতা
404 পাওয়া যায়নি, অথবা এটি অন্য অ্যাকাউন্টের অন্তর্ভুক্ত
পোস্ট /api/v1/domains/search/

ডোমেইন ব্যবহারযোগ্যতা অনুসন্ধান করো

একটি নাম ২০টি জনপ্রিয় এক্সটেনশন (com, net, org, io, dev, co, app, ai এবং আরও অনেক কিছু) এর মধ্যে পাওয়া যায় কিনা তা পরীক্ষা করে, এবং যদি তা পাওয়া না যায় তবে আপনি টাইপ করা এক্সটেনশনটিও পরীক্ষা করে । ফলাফল শুরু হয় সঠিক মিল, তারপর পাওয়া যায় এমন নাম, তারপর নেওয়া নাম ।

অনুমতি প্রয়োজন: domains:search

অনুরোধ বডি প্যারামিটার

পরামিতি আদর্শ প্রয়োজনীয় বর্ণনা
domain string হাঁ এক্সটেনশন সহ অথবা ছাড়া একটি নাম, উদাহরণস্বরূপ mysite অথবা mysite.com (২ থেকে ৬৩ অক্ষর)

উদাহরণ অনুরোধ

cURL
Python
curl -X POST "https://admin.vps.org/api/v1/domains/search/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.com"}'
import requests

url = "https://admin.vps.org/api/v1/domains/search/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.post(url, headers=headers, json={"domain": "mysite.com"})
for result in response.json()["results"]:
    if result["available"]:
        print(result["domain"], result["registration_price"], result["renewal_price"])

উদাহরণ প্রতিক্রিয়া

{
  "results": [
    {
      "domain": "mysite.com",
      "available": false,
      "price": null,
      "registration_price": null,
      "renewal_price": null,
      "tld": "com",
      "is_exact_match": true
    },
    {
      "domain": "mysite.dev",
      "available": true,
      "price": 17.24,
      "registration_price": 17.24,
      "renewal_price": 17.24,
      "tld": "dev",
      "is_exact_match": false
    }
  ],
  "base_domain": "mysite",
  "search_count": 20
}

এক বছরের জন্য মার্কিন ডলারে মূল্য নির্ধারণ করা হয়েছে এবং যেসব নাম পাওয়া যায় না, সেগুলোর জন্য মূল্য নির্ধারণ করা হয়েছে নূন্য। প্রদর্শিত মূল্যগুলো শুধুমাত্র উদাহরণ হিসেবে উল্লেখ করা হয়েছে।

প্রতিক্রিয়া স্থিতি কোড

200 সফলতা
400 ডোমেইন অনুপস্থিত, অথবা এটিতে অক্ষর, সংখ্যা এবং হাইফেন ব্যতীত অন্য অক্ষর রয়েছে
500 রেজিস্ট্রার অনুসন্ধান ব্যর্থ হয়েছে । পরে আবার চেষ্টা করুন ।
পোস্ট /api/v1/domains/register/

নতুন ডোমেইন নিবন্ধন করুন

একটি ডোমেইন নিবন্ধন করে এবং আপনার সংরক্ষিত পরিশোধের পদ্ধতির জন্য চার্জ প্রদান করে। চার্জ প্রদান করার পূর্বে রেজিস্ট্রারের সাথে পুনরায় উপলব্ধতা এবং মূল্য পরীক্ষা করা হয়। রেজিস্ট্রেশনকারীর যোগাযোগের তথ্য আপনার অ্যাকাউন্ট প্রোফাইল থেকে নেওয়া হয়। চার্জ প্রদান করার পর রেজিস্ট্রার যদি নিবন্ধন প্রত্যাখ্যান করে, তবে অর্থ ফেরত দেওয়া হয়।

অনুমতি প্রয়োজন: domains:register (ডোমেইন দ্বারা প্রদত্ত:*)

অনুরোধ বডি প্যারামিটার

পরামিতি আদর্শ প্রয়োজনীয় বর্ণনা
domain string হাঁ এর এক্সটেনশন সহ সম্পূর্ণ ডোমেইন নাম, উদাহরণস্বরূপ example.com
years integer না নিবন্ধনকাল, ১ থেকে ১০ (ডিফল্ট ১)। মূল্য হচ্ছে বার্ষিক মূল্যের গুণফল।.ai-র জন্য অন্তত ২ বছর প্রয়োজন; ছোট মান হলে ৪০০ ফিরিয়ে দেওয়া হবে। 
curl -X POST "https://admin.vps.org/api/v1/domains/register/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.dev", "years": 1}'

উদাহরণ প্রতিক্রিয়া

{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "domain_name": "mysite.dev",
  "message": "mysite.dev registered successfully!"
}

প্রতিক্রিয়া স্থিতি কোড

201 ডোমেইন নিবন্ধিত
400 অবৈধ ডোমেইন, ডোমেইন আর পাওয়া যায় না, মূল্য পরীক্ষা করা যায়নি, পুরনো পরিশোধ পদ্ধতি, অথবা পরিশোধ ব্যর্থ হয়েছে
402 ফাইলে কোনো পরিশোধের পদ্ধতি নেই, অথবা অপ্রাপ্ত বিল
500 অর্থ প্রদান প্রক্রিয়াজাত করা যায়নি, অথবা রেজিস্ট্রার অর্থ প্রদান করার পর নিবন্ধন প্রত্যাখ্যান করেছে। দ্বিতীয় ক্ষেত্রে ত্রুটি বার্তাটি বলে যে অর্থ ফেরত প্রদান করা হয়েছে কি না।
পোস্ট /api/v1/domains/{uuid}/renew/

ডোমেইন নতুন করো

ডোমেইন পুনরায় চালু করে এবং প্রতি বছর আপনার সংরক্ষিত পরিশোধের পদ্ধতির মাধ্যমে এর পুনরায় চালু করার মূল্য প্রদান করে।

অনুমতি প্রয়োজন: domains:renew

অনুরোধ বডি প্যারামিটার

পরামিতি আদর্শ প্রয়োজনীয় বর্ণনা
years integer না যে বছরগুলো যোগ করা হবে, ১ থেকে ১০ (ডিফল্ট ১) 
curl -X POST "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"years": 1}'
{
  "success": true,
  "domain_uuid": "e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c",
  "new_expiration": "2028-01-15T10:30:00+00:00",
  "message": "example.com renewed successfully for 1 year(s)!"
}

প্রতিক্রিয়া স্থিতি কোড

200 ডোমেইন নতুন করে তৈরি করা হয়েছে
400 অকার্যকর বছর, ডোমেইনের জন্য কোন পুনঃনির্ধারণ মূল্য নেই, কোন ব্যবহারযোগ্য পরিশোধ পদ্ধতি নেই, অথবা পরিশোধ ব্যর্থ হয়েছে
404 পাওয়া যায়নি, অথবা এটি অন্য অ্যাকাউন্টের অন্তর্ভুক্ত
500 পরিশোধ প্রক্রিয়াজাত করা যায়নি, অথবা পরিশোধ করা হয়েছে কিন্তু রেজিস্ট্রার পুনরায় চালু করতে ব্যর্থ হয়েছে। এই ক্ষেত্রে সহায়তার সাথে যোগাযোগ করুন।
PUT /api/v1/domains/{uuid}/nameservers/

নেম সার্ভার আপডেট করো

রেজিস্ট্রার-এ ডোমেইনের নাম সার্ভার নির্ধারণ করে এবং আপডেট করা ডোমেইন অবজেক্ট ফিরিয়ে দেয়। DNS API-র মাধ্যমে DNS পরিচালনা করতে ns1.vps.org, ns2.vps.org এবং ns3.vps.org ব্যবহার করে ডোমেইনের জন্য একটি জোন তৈরি করুন।

অনুমতি প্রয়োজন: domains:update

অনুরোধ বডি প্যারামিটার

পরামিতি আদর্শ প্রয়োজনীয় বর্ণনা
nameserver1 string হাঁ প্রাথমিক নেম সার্ভার হোস্টনাম
nameserver2, nameserver3, nameserver4 string না অতিরিক্ত নেম সার্ভার হোস্টনাম 
curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/nameservers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"nameserver1": "ns1.vps.org", "nameserver2": "ns2.vps.org", "nameserver3": "ns3.vps.org"}'

প্রতিক্রিয়া স্থিতি কোড

200 নাম সার্ভার হালনাগাদ করা হয়েছে; বডি ডোমেইন অবজেক্ট
400 nameserver1 অনুপস্থিত
404 পাওয়া যায়নি, অথবা এটি অন্য অ্যাকাউন্টের অন্তর্ভুক্ত
500 আপডেট ব্যর্থ; মূল অংশে ত্রুটি এবং বার্তা ক্ষেত্র রয়েছে
PUT /api/v1/domains/{uuid}/auto-renew/

স্বয়ংক্রিয় নতুন করে প্রদর্শন সক্রিয় বা নিষ্ক্রিয় করুন

auto_renew নির্ধারণ করে এবং হালনাগাদ ডোমেইন অবজেক্ট ফিরিয়ে দেয়। JSON boolean হিসাবে পাঠানো সক্রিয় করা হয়েছে: যেকোন ফাঁকা নয় এমন স্ট্রিং, স্ট্রিং false সহ, স্বয়ংক্রিয়ভাবে পুনঃপ্রতিষ্ঠা সক্রিয় করে।

অনুমতি প্রয়োজন: domains:update

curl -X PUT "https://admin.vps.org/api/v1/domains/e4b7a2c9-1d3f-4e5a-8b6c-7d8e9f0a1b2c/auto-renew/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

প্রতিক্রিয়া স্থিতি কোড

200 সেটিংস সংরক্ষণ করা হয়েছে; বডি ডোমেইন অবজেক্ট
400 সক্রিয় ত্রুটি
404 পাওয়া যায়নি, অথবা এটি অন্য অ্যাকাউন্টের অন্তর্ভুক্ত

নোট