تجديد مفاتيح API

الهدف

توليد زوج مفاتيح جديد للعميل عبر POST /api/v1/gateway/clients/{client}/regenerate عند تسريب السر أو الاشتباه باختراق.

الخطوات

1. أرسل طلب POST إلى مسار التجديد.
2. يُولَّد api_key جديد وapi_secret جديد (يُخزن السر مشفراً).
3. يُعرض السر الجديد plain_secret مرة واحدة في الرد — احفظه فوراً.

رسائل الخطأ

• 403 — الحساب ليس SuperAdmin.
• 404 — العميل غير موجود.

نصائح

بعد التجديد، المفاتيح القديمة تتوقف فوراً؛ حدّثها في أنظمة العميل قبل أن تنتهي فترته.

الأذونات

تتطلب مصادقة Sanctum ودور SuperAdmin.