تحديث مفتاح API

نظرة عامةCopy Anchor Link

استخدم هذا الـ endpoint لتحديث الاسم أو حد الاستخدام أو النماذج المسموح بها أو وقت الانتهاء أو الحالة الخاصة بمفتاح API موجود.

جسم الطلبCopy Anchor Link

يجب أن يتضمن طلب PATCH حقلًا واحدًا على الأقل.

ملاحظاتCopy Anchor Link

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

• لا يدعم Management API v1 الحذف النهائي عمدًا.

• تُعامل الحالة revoked عادةً كحالة نهائية للاستخدام التشغيلي العادي؛ وإذا احتجت إلى مفتاح جديد، فأنشئ مفتاحًا جديدًا بدلًا من توقع وجود مسار لاحق لفك الإلغاء.

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
  }'

الطلب / الاستجابةCopy Anchor Link

توفّر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من الطرفية أو برنامج العميل باستخدام 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-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
}

الحقول المهمةCopy Anchor Link