Домендер API

Барлық домендерді тізімдеу

Тіркелгіңізге тіркелген домендер тізімі, бір бетке 25- те. Тізімінде сүзгілер жоқ.

Рұқсат керек: domains:list

Мысал сұрау

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

Жауап өрістері

Доменнің егжей- тегжейін алу

Returns one domain object with the fields above.

Рұқсат керек: domains:list

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

Жауап күйінің кодтары

Доменнің қолжетімділігін іздеу

Атау 20- дан астам танымал жұрнақтардың (com, net, org, io, dev, co, app, ai және т. б.) ішінде бар ма, жоқ па, соны тексереді. Нәтижелер сәйкесті атаулармен басталып, бар атаулармен аяқталады, сосын қолданыстағы атаулармен басталады.

Рұқсат керек: domains:search

Сұрау мәтінінің параметрлері

Мысал сұрау

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
}

Бағалар бір жылға АҚШ долларында көрсетілген, ал қол жеткізбейтін атаулар үшін нөл. Көрсетілген бағалар тек түсіндіру үшін.

Жауап күйінің кодтары

Жаңа доменді тіркеу

Доменді тіркеу және сақталған төлем әдісіңізді есептеу. Қолжетімділігі мен бағасы төлемді есептеу алдында қайтадан регистратормен тексеріледі. Регистратордың қатынасу мәліметі тіркелгі профиліңізден алынады. Егер регистратор төлемді есептеген соң тіркеуді қабылдамаса, төлем қайтарылады.

Рұқсат керек: domains:register (домендер берген: *)

Сұрау мәтінінің параметрлері

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

Жауап күйінің кодтары

Доменді жаңарту

Доменді жаңарту және әрбір жыл үшін оның жаңарту_ бағасын сіздің сақталған төлем әдісіңізге есептеу.

Рұқсат керек: domains:renew

Сұрау мәтінінің параметрлері

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)!"
}

Жауап күйінің кодтары

Атау серверлерін жаңарту

Доменнің атау серверлерін регистрде орнатып, жаңартылған домен нысанын қайтарады. DNS- ті DNS API арқылы басқару үшін, ns1. vps.org, ns2. vps.org және ns3. vps.org дегендерді қолданып, домен үшін аймақ құрыңыз.

Рұқсат керек: domains:update

Сұрау мәтінінің параметрлері

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

Жауап күйінің кодтары

Автожаңартуды қосу не өшіру

auto_ renew дегенді орнатып, жаңартылған домен нысанын қайтарады. JSON логикалық мәні ретінде жіберу рұқсат етілген: кез келген бос емес жол, 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}'

Жауап күйінің кодтары

Жазбалар

• API доменді өшіре алмайды, доменді ауыстыра алмайды, WHOIS құпиялылығын немесе ауыстырудың бұғатын өзгерте алмайды. Ауыстырулар мен өшірулер admin. vps.org деген басқару панелінде қол жетімді.
• DNS- дің негізгі функциясы - DNS серверінің жұмысын қамтамасыз ету. DNS басқару API