الأتمتة والمطوّرون
مفاتيح API
أنشئ المفاتيح التي تصادق على الوصول إلى API وحدد نطاقها ودوّرها.
تُستخدم مفاتيح API لمصادقة الوصول البرمجي إلى PeekHire — سواء إلى REST API أو إلى أتمتتك بدون كود.
إنشاء مفتاح
- انتقل إلى أدوات المطور → مفاتيح API → إنشاء.
- امنح المفتاح اسمًا وصفيًا (مثل تكامل Zapier) حتى تتذكر الغرض منه.
- انسخ قيمة المفتاح عند ظهورها — لأسباب أمنية، لن تتمكن من رؤيتها مرة أخرى بعد ذلك.
استخدام مفتاح
أرسل المفتاح كرمز bearer في كل طلب:
curl https://your-api-host/api/v1/applications \
-H "Authorization: Bearer YOUR_API_KEY"
الصلاحيات
يحمل كل مفتاح صلاحيات تحدد ما يمكنه فعله:
- قراءة — جلب البيانات (عرض واسترجاع الحملات والطلبات والمستخدمين).
- كتابة — إنشاء البيانات أو تعديلها.
امنح التكامل الصلاحيات التي يحتاجها فقط (مبدأ أقل امتياز). يكفي مفتاح للقراءة فقط لمزامنة البيانات إلى جدول بيانات أو لوحة معلومات؛ أضف كتابة فقط عندما يحتاج التكامل إلى تغيير شيء ما في PeekHire.
الحفاظ على أمان المفاتيح
- تعامل مع المفاتيح مثل كلمات المرور. يمكن لأي شخص لديه مفتاح أن يتصرف في بياناتك.
- لا تحفظ المفاتيح أبدًا في مستودع أو تضعها في كود يعمل على جهة العميل.
- استخدم مفتاحًا منفصلًا لكل تكامل، حتى تتمكن من إلغاء أحدها دون التأثير على الآخرين.
- خزّن المفاتيح في مدير أسرار أو في مخزن بيانات الاعتماد الخاص بأداتك، وليس كنص عادي.
تدوير المفاتيح وإلغاؤها
إذا تم كشف مفتاح — أو كنت تدور المفاتيح وفق جدول منتظم — أنشئ مفتاحًا جديدًا، وحدّث التكامل لديك، ثم احذف المفتاح القديم. يؤدي حذف المفتاح إلى إلغاء وصوله فورًا.