الإدارة

عرض مفاتيح API

يعرض مفاتيح API المُدارة من المستخدم لرمز إدارة المؤسسة الحالي.

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

نظرة عامة

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

ملاحظات

  • تدعم حقول المبالغ المالية الدولار الأمريكي فقط.

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

مثال

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 وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من الطرفية أو برنامج العميل باستخدام 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-3-7-sonnet"
      ],
      "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 المستخدم في استدعاءات واجهة 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 وراثة سياسة التسليم لمساحة العمل.
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