API'ny kaonty

Maka ny lazan'ny kaonty sy ny token

Mamaly ny metadata momba ny profil'ny kaonty sy ny faritry ny token/fahazoan-dàlana ho an'ny token API nampiasaina tamin'ny fangatahana. Mety ampiasaina io raha toa ka mila mifehy token API maro ianao ary mila mahafantatra izay kaonty misy ny token iray sy ny fahazoan-dàlana omena azy.

fanamarinana

Mila token API mitombina. Ny token miasa rehetra dia afaka mampiasa io endpoint io na inona na inona ny faritry ny fahazoan-dàlana omena azy.

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Saha Valiny

account object

token object

Famaha momba ny fivoaran'ny valinteny

Fomba fampiasana mahazatra

Mamaritra ny tompon'ilay token

Raha mifehy token API marobe amin'ny rindranasa samihafa ianao, dia mampiasa ity endpoint ity hanamafisana ny kaonty iray izay an'ny token iray:

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

Manaporofo ny fahazoan-dàlana amin'ny token

Alohan'ny hanaovana antso API, jereo izay fahazoan-dàlana ananan'ity token ity:

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

Manara-maso ny fe-potoanan'ny token

Jereo raha efa ho tapitra ny fotoanan'ny token-nao:

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

Fandraisana alalana

Manaraka ny lamin'ny alalana resource:action. Ampiasao resource:* ho an'ny fahazoana miditra tanteraka amin'ny loharano, na *:* ho an'ny fahazoana tanteraka ny API.