Ҳисоб API

Ҳисоб ва теги маълумотни олиш

Талабда фойдаланилган API токен учун ҳисоб профили метамаълумотларини ва токен доирасини/рухсатларини қайтаради. Бу кўплаб API токенларни бошқараётганда ва токен қайси ҳисобга тегишли ва унинг қандай рухсатлари борлигини аниқлаш керак бўлганда фойдали.

Autentifikatsiya

Юқоридагилар учун тегишли API токен талаб этилади. Бу ниҳоя нуқтасига рухсат доирасидан қатъи назар, ҳар қандай фаол токен кириши мумкин.

Namunaviy so'rov

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

import requests

url = "https://admin.vps.org/api/v1/account/me/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json()

print(f"Account: {data['account']['email']}")
print(f"Token: {data['token']['name']}")
print(f"Permissions: {data['token']['permissions']}")

const response = await fetch('https://admin.vps.org/api/v1/account/me/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(`Account: ${data.account.email}`);
console.log(`Token: ${data.token.name}`);
console.log(`Permissions:`, data.token.permissions);

$ch = curl_init('https://admin.vps.org/api/v1/account/me/');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

echo "Account: " . $data['account']['email'] . "\n";
echo "Token: " . $data['token']['name'] . "\n";
echo "Permissions: " . implode(', ', $data['token']['permissions']) . "\n";

Javob namunasi

{
  "account": {
    "email": "john@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "company_name": "Acme Inc.",
    "created_at": "2024-06-15"
  },
  "token": {
    "name": "Production Deploy Key",
    "permissions": [
      "servers:list",
      "servers:create",
      "servers:power",
      "dns:*"
    ],
    "created_at": "2025-01-10T14:30:00Z",
    "last_used_at": "2025-02-11T08:45:12Z",
    "expires_at": null,
    "is_expired": false
  }
}

Javob maydonlari

account object

token object

Жавоб ҳолати кодлари

Кўп қўлланиладиган ҳолатлар

Токен эгасини аниқлаш

Бир неча API токенларини турли дастурлар орасида бошқарганда, токен қайси ҳисобга тегишлилигини текшириш учун ушбу охирги нуқтадан фойдаланинг:

# Check which account this token is associated with
response = requests.get(
    "https://admin.vps.org/api/v1/account/me/",
    headers={"Authorization": f"Bearer {api_token}"}
)
account = response.json()["account"]
print(f"This token belongs to: {account['email']}")

Токен рухсатларини текшириш

API қўнғироқларини амалга оширишдан олдин, ҳозирги токеннинг рухсатлари қандайлигини текширинг:

# Check token permissions before performing an action
response = requests.get(
    "https://admin.vps.org/api/v1/account/me/",
    headers={"Authorization": f"Bearer {api_token}"}
)
permissions = response.json()["token"]["permissions"]

if "servers:create" in permissions or "servers:*" in permissions:
    # Token has permission to create servers
    create_server()
else:
    print("Token does not have servers:create permission")

Токен муддати тугаши мониторинги

Токенингиз муддати тугаши яқинлашаётганини текширинг:

from datetime import datetime

response = requests.get(
    "https://admin.vps.org/api/v1/account/me/",
    headers={"Authorization": f"Bearer {api_token}"}
)
token_info = response.json()["token"]

if token_info["expires_at"]:
    expires = datetime.fromisoformat(token_info["expires_at"])
    days_left = (expires - datetime.now()).days
    if days_left < 7:
        print(f"Warning: Token expires in {days_left} days")
else:
    print("Token has no expiration date")

Ҳуқуқлар манбаси

Ҳуқуқлар форматга мос келади resource:action. _Қўлланиш resource:* ресурсга тўлиқ кириш учун ёки *:* тўлиқ API кириш учун.