الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

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

​
جسم الطلب

يجب أن يتضمن طلب PATCH حقلًا واحدًا على الأقل.
الحقلالنوعالقيم الافتراضية / القيودالوصف
statusenum-active أو inactive أو revoked
namestringالطول 1-50اسم العرض بعد التحديث
limitAmountnumber | nullالحد الأدنى 0، الحد الأقصى 100000null = غير محدود، 0 = حصة صفرية، والقيمة الموجبة = سقف بالدولار
limitCurrencyenumالقيمة الافتراضية USDاختياري: USD أو CNY. عند ضبطه على CNY سيتم تفسير limitAmount كقيمة بالرنمينبي ثم تحويلها إلى USD على الخادم قبل التخزين
modelsstring[]-قائمة النماذج المنطقية المسموح بها بعد التحديث
expiresAtstring | nullتاريخ ووقت RFC3339null يزيل وقت الانتهاء

​
ملاحظات

  • لا يدعم Management API v1 الحذف النهائي عمدًا.
  • تُعامل الحالة revoked عادةً كحالة نهائية؛ وإذا احتجت إلى مفتاح جديد، فغالبًا يكون إنشاء مفتاح جديد هو الخيار الأفضل.
  • افتراضيًا يتم تفسير limitAmount على أنه USD. إذا أرسلت limitCurrency: "CNY" فسيتم التعامل مع الحد كقيمة بالرنمينبي ثم تحويله تلقائيًا إلى USD باستخدام سعر الصرف الحالي قبل تخزينه.
  • تتضمن الاستجابة exchange_rate بالإضافة إلى حقول العرض بالرنمينبي limit_amount_cny و used_amount_cny.

​
مثال

curl -X PATCH "https://api.lemondata.cc/v1/management/api-keys/key_abc123def456" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "inactive",
    "limitAmount": 0
  }'

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

استخدم لوحة OpenAPI التفاعلية أعلاه للاطلاع على المخطط الدقيق وحقول الاستجابة.