الإدارة
تحديث API Key
تحديث API key في مساحة العمل (Workspace) الحالية.
نظرة عامة
استخدم نقطة النهاية (endpoint) هذه لتحديث الاسم، أو حد الاستخدام، أو النماذج المسموح بها، أو تاريخ انتهاء الصلاحية، أو حالة API key حالي خاص بالمستخدم.
نص الطلب (Request Body)
يجب توفير حقل واحد على الأقل.
| الحقل | النوع | الافتراضي / الحدود | ملاحظات |
|---|---|---|---|
status | enum | - | active، inactive، revoked |
name | string | الطول 1-50 | اسم العرض المحدّث |
limitAmount | number | string | null | 0–100000 USD | القيمة null تعني غير محدود؛ القيمة 0 تمنع الإنفاق. تدعم السلاسل العشرية (decimal strings) ما يصل إلى 6 منازل عشرية. |
limitCurrency | enum | الافتراضي USD | بالـ USD فقط. إرسال CNY يرجع الخطأ 400 currency_retired. عند تعيينه، يكون limitAmount مطلوباً. |
models | string[] | - | القائمة البيضاء المحدّثة للنماذج |
deliveryPolicy | string | null | auto، verified، official، null | القيمة null ترث سياسة التسليم الخاصة بـ Workspace. |
expiresAt | string | null | تاريخ ووقت بتنسيق RFC3339 | القيمة null تلغي تاريخ انتهاء الصلاحية |
ملاحظات
-
الحقول المالية تدعم عملة USD فقط. تم إيقاف مدخلات
CNYوترجع الخطأ400 currency_retired. -
لا يوفر Management API إمكانية الحذف. استخدم
inactiveللإيقاف المؤقت وrevokedلتعطيل المفتاح نهائياً. -
استبدل المفتاح الملغى (revoked) بمفتاح جديد. ضبط مفتاح ملغى إلى
activeيرجع الخطأ409 api_key_revoked. -
يمكن أن تظهر الحالة
suspendedفي الاستجابات، ولكن لا يمكنك إرسالها.
الطلب
curl -X PATCH "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456" \
-H "Authorization: Bearer mt-your-management-token" \
-H "Content-Type: application/json" \
-d '{
"status": "inactive",
"limitAmount": 0
}'الطلب / الاستجابة
توفر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من الطرفية (terminal) أو العميل الخاص بك باستخدام Management Token؛ الإرسال المباشر غير متاح في هذه الصفحة.
الاستجابة
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "inactive",
"limit_amount": 0,
"limit_amount_decimal": "0",
"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
}حقول مهمة
active، inactive، suspended، أو revoked.null تعني غير محدود.null تعني غير محدود.auto، verified، official، null. القيمة null ترث سياسة التسليم الخاصة بـ Workspace.null في حال عدم وجود تاريخ انتهاء.null إذا لم يُستخدم بعد.التفويض
ManagementTokenAuth مصادقة رمز الإدارة (Management token). قم بإنشاء أو إدارة رموز الإدارة في Dashboard > API > Management Tokens.
الموضع: header
معاملات المسار
جسم الطلب
application/json
يجب توفير حقل واحد على الأقل.
1 <= propertiesالاستجابة
application/json
application/json
application/json
application/json
application/json
application/json