المرحلة: التسجيل والاستقطاب

التسجيل والاستقطاب: إدخال المرشحين إلى جديرون. يسجّل المرشحون أنفسهم في صفحة الوظائف لديك، ويمكن عبر الواجهة البرمجية أن تضيفهم أيضًا لوحة وظائف أو أداة استقطاب أو مخزون المواهب في نظام ERP لديك.

الموارد

المسار المعتاد

1. أنشئ المرشح بـ POST /api/v1/candidates، أو عددًا كبيرًا دفعة واحدة بـ POST /api/v1/candidates/bulk (يمكن أن يحمل كل صف رابط https في cvUrl؛ فينزّل جديرون السيرة الذاتية ويحفظها بشكل خاص).
2. أضف المرشح إلى شاغر: انظر التوظيف.
3. اقرأ السيرة الذاتية بـ GET /api/v1/candidates/{id}/cv (تُبث مباشرةً؛ ولا يعطي جديرون رابط تخزين أبدًا). ويحتاج ذلك recruitment.candidate.contact، لأن الملف يعرض بيانات التواصل.
4. اشترك في candidate.created وcandidate.updated لترى المرشحين الذين سجلوا بأنفسهم.

قواعد تستحق المعرفة

• يُخفى بريد المرشح وهاتفه ورقم هويته في الاستجابات وحمولات خطافات الويب ما لم يكن التكامل يملك recruitment.candidate.contact؛ ومن دونها يتركها PATCH دون تغيير.
• يُرفض الشخص المكرر (409 conflict، وdetails.reason قيمته duplicate_person).
• لا يُحذف المرشح نهائيًا عبر الواجهة البرمجية أبدًا. والمرشح الذي يحذف حسابه بنفسه يرسل candidate.deleted ويترك أثر حذف.