VPS.org API документација

Започнување

API-то на VPS.org ви овозможува програмски да управувате со сите аспекти на вашата VPS хостинг инфраструктура, вклучувајќи сервери, домени, DNS записи, резервни копии и снимки од екранот.

Автентикација

Сите API барања бараат автентикација со користење на токен за носител. Можете да го генерирате вашиот API токен од поставките на вашата сметка на admin.vps.org/account/developers/.

curl -X GET https://admin.vps.org/api/v1/servers/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

url = "https://admin.vps.org/api/v1/servers/"
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/servers/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

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

Секој жетон има свои дозволи, како сервери:list или dns:*. Барањето на кое му треба дозвола на жетонот не е одбиено со 403 и барано_ за почитување на полето кое го наведува недостасувачката дозвола. Референца за дозволи

Ограничување на стапката

Автентифицираните барања се ограничени на 1.000 на час на сметка. Неаутентификуваните барања се ограничени на 100 на час на IP адреса. Барањето над границата добива 429 со заглавие Повторување- Пошто со заглавје со број секунди за чекање. Не се испраќаат ограничувања на стапките на успешни одговори.

Пагирање

Исходните точки на листата враќаат објект со броење, следно, претходно и резултати, 25 елементи на страница. Додај страница за да се премести меѓу страниците или следете го следниот URL додека не биде нулти. Листата на серверите исто така прифаќа page_size, до 100.

{
  "count": 84,
  "next": "https://admin.vps.org/api/v1/backups/?page=2",
  "previous": null,
  "results": [ ... ]
}

Ракување со грешки

API-то користи стандардни HTTP статус кодови за да означи успех или неуспех:

Телата на грешки се JSON. Повеќето имаат поле за детали или поле за грешка, понекогаш со порака; овластувањето ги наведува проблемите по име на полето.

API категории

Прегледајте ја нашата API документација по категорија:

Повеќе крајни точки

API исто така има крајни точки за распоредување на апликации (/api/v1/deplop- configs/ и /api/v1/deplayments /). Тие сé уште не се опишани на овие страници; интерактивната референтна листа на секој крајен крај, генериран од живото API.

Ви треба помош?

Доколку имате прашања или ви е потребна помош со API-то, слободно контактирајте не:

• Билети за поддршка: Отворете тикет за поддршка
• Е-пошта: hello@vps.org
• Документација: Целосна документација