مفاتيح API
أنشئ مفتاحاً مُحدَّد الصلاحيات للوصول البرمجي، وأرسِله في كل طلب /v1، ودوّره فور تسرّبه.
آخر تحديث 18 يونيو 2026
أنشئ مفتاحاً
ضمن مفاتيح API في البوابة (أو POST /portal/api-keys)، أنشئ مفتاحاً بتسمية وصلاحيات (حقل Send=1, Read=2, Contacts=4, Admin=8 البِتّي، غير صفري). يتحكّم live ببادئة المفتاح (حيّ مقابل تجريبي). ويُرجَع المفتاح الخام مرة واحدة فقط — انسخه الآن؛ ولا يُحفَظ سوى التجزئة.
أرسِله في كل طلب
صادِق على استدعاءات /v1 بالمفتاح في ترويسة — X-Api-Key: <key>، أو Authorization: Bearer <key> / Authorization: ApiKey <key>. تُشتقّ هوية المستأجِر من المفتاح. والمفتاح الناقص أو غير الصالح يفشل مغلقاً بـ 401.
أقل امتياز
امنح الصلاحيات التي يحتاجها المفتاح فقط. تكامل الإرسال فقط ينال Send؛ ولوحة تقرأ الحالة تنال Read. والمفتاح الفاقد لصلاحية مسارٍ ينال 403 — وهذه إشارة لإعادة الإنشاء بالصلاحية الصحيحة، لا للإفراط في المنح.
دوّره عند التسرّب
ألغِ مفتاحاً مسرَّباً فوراً (DELETE /portal/api-keys/{id}) وأنشئ بديلاً. ولأنّه لا يُحفَظ سوى التجزئة، لا يمكن لـ Servus استرجاع القيمة الخام لك — والتدوير هو مسار الاسترداد.