Тіркелгі API

Тіркелгі және токен мәліметін алу

Тіркелгі профилінің метадеректері мен сұраудағы API токенінің ауқымы/ рұқсаттары қайтарылады. Бұл бірнеше API токендерді басқарып, бір токеннің қай тіркелгіге тиесілі екенін және оның қандай рұқсаттары бар екенін анықтау керек болғанда пайдалы.

Аутентификация

Дұрыс API токен керек. Барлық белсенді токендер осы аяқтау нүктесіне рұқсат ауқымы қандай болса да қатынауға болады.

Мысал сұрау

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";

Мысал жауап

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

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

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 қатынау үшін.