اکاؤنٹس

اکاؤنٹس اور ٹوکن معلومات حاصل کریں

درخواست میں استعمال شدہ 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 رسائی کے لئے.