VPS.org API

РЕСТЕПНА АПИ документација

АПИ домена

Тражи доступна имена домена, региструј и обнови домене, управљај њиховим серверима имена и аутоматско обновљавање. Домени су идентификовани по њиховом ууиду.

Крајње тачке 7
Основна путања /api/v1/domains
ДОБИЈ /api/v1/domains/

Наведите све домене

Враћа домене регистроване на вашем налогу, 25 по страници. Листа нема филтере.

Неопходна дозвола: 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 Када је домен регистрован и када истеке, датум истека може бити нуљан.
days_until_expiration integer | null Цели дани до истека, негативно једном истекло
is_expired, needs_renewal_soon boolean Да ли је домен истекао и истекао у наредних 30 дана
auto_renew, renewal_period_years boolean, integer Да ли домен аутоматски обновљује, и колико година
registration_price, renewal_price string Цене у USD као децималне ниске
whois_privacy, transfer_lock boolean ВХОИСове приватности и поставке регистарског закључавања преноса
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/

Доступност домена за претрагу

Пров› јера да ли је име доступно преко око 20 популарних проширења (com, net, org, io, dev, co, app, ai и више), плус наставак који сте уписали ако није међу њима. Резултати почињу са тачном поклапањем, онда са расположивим имена, а затим узетим.

Неопходна дозвола: domains:search

Захтевајте параметре тела

Параметар Тип Обавезно Опис
domain string Да Име са или без продужења, на пример mysite или mysite.com (2 до 63 знака)

Пример захтева

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
}

Цене су бројеви у USD за годину дана и нулти за имена која нису доступна. Приказане цене су илустративне.

Кодови статуса одговора

200 Успех
400 Недостаје домен, или садржи знакове осим слова, цифара и цртања
500 Регистарска претражба није успела. Понови касније.
ПОСТ /api/v1/domains/register/

Региструјте нови домен

Региструје домен и наплаћује ваш сачувани начин плаћања. Доступност и цена се поново пров› јере регистаром одмах пре наплате. Подаци о контакту регистарту се узимају из профила налога. Ако регистар одбије регистрацију после наплате, исплата се враћа.

Неопходна дозвола: domains:register (по доменама:*)

Захтевајте параметре тела

Параметар Тип Обавезно Опис
domain string Да Пуно име домена, укључујући његов проширење, на пример. com
years integer Не. Период пријаве, 1 до 10 (подразумевано 1). Цена је годишња цена пута године..ai захтева најмање 2 године; мања вредност враћа 400.
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 Не. Година за додавање, 1 према 10 (подразум› ијевано 1)
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/

Ажурирај сервере имена

Поставља сервере имена домена на регистару и враћа ажурирани објект домена. За управљање ДНС‐ ом са ДНС АПИ‐ ом, користите 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 сервер имена1 недостаје
404 Није нађена, или припада другом налогу
500 Ажурирање није усп› јело; тело има поља грешака и поруке
PUT /api/v1/domains/{uuid}/auto-renew/

Укључи или искључи аутоматски обнови

Поставља аутоматски_ обнови и враћа ажурирани објект домена. Пошаљи укључен као ЈСОН: свака непразна ниска, укључујући и фалсификат, укључује аутоматски обновивање.

Неопходна дозвола: 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 Није нађена, или припада другом налогу

белешке