إدارة عملاء البوابة (إنشاء/عرض/تعديل/حذف)

الهدف

إدارة عملاء بوابة API عبر الإجراءات: عرض القائمة GET /api/v1/gateway/clients، إنشاء عميل POST /api/v1/gateway/clients، عرض التفاصيل GET /clients/{client}، تعديل البيانات PUT /clients/{client}، وحذف العميل DELETE /clients/{client}.

الخطوات

1. للعرض: أرسل GET مع فلاتر اختيارية status وsearch وper_page.
2. للإنشاء: أرسل name (إلزامي) مع الحقول الاختيارية: description، allowed_ips، allowed_domains، permissions، rate_limit، rate_limit_per_day، expires_at.
3. يُظهر الرد عند الإنشاء api_key والسر plain_secret مرة واحدة فقط — احفظه فوراً.
4. للتعديل: أرسل PUT مع الحقول المراد تغييرها فقط.
5. للحذف: أرسل DELETE؛ يُحذف العميل نهائياً.

رسائل الخطأ

• 422 — الاسم مطلوب ولا يتجاوز 255 حرفاً، عناوين IP غير صالحة، حد الطلبات يجب أن يكون رقماً بين 1 و10000 (بالدقيقة) و1 و100000 (يومياً)، وتاريخ الانتهاء يجب أن يكون في المستقبل.
• 403 — الحساب ليس SuperAdmin.

نصائح

• قيد العملاء باختصار المسموحات permissions ليتحكم النظام بالوصول الفعلي.
• حذف عميل لا يلغي مفاتيحه تلقائياً من السجلات؛ تُحفظ السجلات للتدقيق.

الأذونات

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