ਅਕਾਊਂਟ API

ਅਕਾਊਂਟ ਅਤੇ ਟੋਕਨ ਜਾਣਕਾਰੀ ਲਵੋ

ਬੇਨਤੀ ਵਿੱਚ ਵਰਤੇ API ਟੋਕਨ ਲਈ ਅਕਾਊਂਟ ਪਰੋਫਾਇਲ ਮੇਟਾਡਾਟਾ ਅਤੇ ਟੋਕਨ scope/permissions ਦਿੰਦਾ ਹੈ। ਇਹ ਉਦੋਂ ਲਾਭਦਾਇਕ ਹੈ, ਜਦੋਂ ਤੁਸੀਂ ਕਈ 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 ਪਹੁੰਚ ਲਈ ।