الإدارة

سرد مفاتيح API

سرد مفاتيح API التي يديرها المستخدم للمؤسسة المرتبطة بـ Management Token الحالي.

GEThttps://api.tokenlab.sh/v1/management/api-keys

نظرة عامة

إرجاع مفاتيح API الخاصة بالمستخدم في المؤسسة المرتبطة بـ Management Token الحالي.

ملاحظات

  • الحقول المالية هي بالدولار الأمريكي (USD) فقط.

  • يتم استبعاد المفاتيح التي يديرها النظام.

مثال

pageintegerqueryالافتراضي: 1
رقم الصفحة يبدأ من 1.
limitintegerqueryالافتراضي: 50
حجم الصفحة من 1 إلى 100.

الطلب

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token"

الطلب / الاستجابة

توفر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من جهازك الطرفي (terminal) أو العميل باستخدام Management Token؛ الإرسال المباشر غير متاح في هذه الصفحة.

الاستجابة

200 OK
{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-live...",
      "status": "active",
      "limit_amount": 500,
      "limit_amount_decimal": "500",
      "used_amount": 148.25,
      "used_amount_decimal": "148.25",
      "models": [
        "gpt-5.6-luna",
        "claude-sonnet-4-6"
      ],
      "expires_at": "2026-12-31T23:59:59.000Z",
      "last_used_at": "2026-07-08T03:12:45.000Z",
      "created_at": "2026-07-01T10:00:00.000Z",
      "delivery_policy": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

حقول هامة

objectstring
دائماً list.
dataarray
مصفوفة من كائنات مفاتيح API.
paginationobject
بيانات وصفية للترقيم تحتوي على page و limit و total و totalPages.
data[].idstring
معرف مفتاح API المستخدم في استدعاءات Management API اللاحقة.
data[].namestring
اسم العرض الخاص بمفتاح API.
data[].key_prefixstring
بادئة المفتاح غير السرية للعرض والدعم.
data[].statusstring
إحدى القيم التالية: active أو inactive أو suspended أو revoked.
data[].limit_amountnumber | null
سقف الإنفاق بالدولار الأمريكي كرقم JSON للعرض. تعني null غير محدود.
data[].limit_amount_decimalstring | null
سقف الإنفاق الدقيق بالدولار الأمريكي كسلسلة نصية عشرية. تعني null غير محدود.
data[].used_amountnumber
الاستخدام المتراكم بالدولار الأمريكي كرقم JSON للعرض.
data[].used_amount_decimalstring
الاستخدام المتراكم الدقيق بالدولار الأمريكي كسلسلة نصية عشرية.
data[].modelsstring[]
قائمة النماذج المسموح بها لكل مفتاح. المصفوفة الفارغة تعني عدم وجود قيود إضافية على مستوى المفتاح.
data[].delivery_policystring | null
auto أو verified أو official أو null. تعني null وراثة سياسة التسليم الخاصة بـ Workspace.
data[].expires_atstring | null
طابع زمني بتنسيق ISO يحدد وقت انتهاء صلاحية المفتاح، أو null في حال عدم وجود تاريخ انتهاء.
data[].last_used_atstring | null
طابع زمني بتنسيق ISO لأحدث استخدام، أو null في حال عدم الاستخدام.
data[].created_atstring
طابع زمني بتنسيق ISO لإنشاء المفتاح.

التفويض

ManagementTokenAuth
AuthorizationBearer <token>

مصادقة رمز الإدارة (Management token). قم بإنشاء أو إدارة رموز الإدارة في Dashboard > API > Management Tokens.

الموضع: header

الاستجابة

application/json

application/json

application/json