Kugwiritsa ntchito Akaunti

Kupeza Account & Token Info

Kubwerera ku akaunti ya profile metadata ndi token scope / permissions kwa API token yomwe imagwiritsidwa ntchito mu funso. Izi ndi zothandiza pamene mumayendetsa ma tokens ambiri a API ndipo muyenera kudziwa kuti akaunti yomwe token ili nayo ndi zomwe zilolezo ili nazo.

Kutsimikizira

Amafuna chilolezo cha API chovomerezeka. Chilolezo chilichonse chogwira ntchito chimaweza chilolezo ichi chomaliza ngakhale kuti chili ndi zilolezo zosiyanasiyana.

Chitsanzo cha Pempho

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

Chitsanzo cha Yankho

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

Mayankho a Minda

account object

token object

Kuyankha Status Codes

Zogwiritsa ntchito Zogwiritsa ntchito

Kuzindikira Woyang'anira Token

Poyang'anira ma tokens ambiri a API m'mapulogalamu osiyanasiyana, kugwiritsa ntchito izi endpoint kuti atsimikizire kuti ndi akaunti iti yomwe imakhala ndi token:

# 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']}")

Kuyesa Kulandira

Pambuyo popanga API zopempha, onetsetsani zimene zilolezo watsopano token ali:

# 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")

Kuyang'ana Kutha Kwa Token

Sankhani ngati token yanu ikuyembekezeka kuchoka:

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

Kulemba kwa Malamulo

Permissions follow the format resource:action. Kugwiritsa ntchito resource:* kwa kulowa kwathunthu kwa chitetezo, kapena *:* kwa kulowa kwathunthu API.