يجب تحميل ملف السيرة الذاتية باستخدام form-data كمعامل يسمى file. يجب عليك أيضًا تقديم سلسلة content بوصف كامل للوظيفة. يُعرّف المعامل الاختياري language لغة مخرجات التفسير (الافتراضي هو الإنجليزية).
الخطوة 1. تقديم طلب تقييم التوافق
نقطة النهاية: POST - /api/v1/hr/resume_job_match_score
مثال على الطلب:
curl --location 'https://sharpapi.com/api/v1/hr/resume_job_match_score' \
--header 'Accept: application/json' \
-H "Authorization: Bearer YOUR_API_TOKEN" \
--form 'file=@"Resume.pdf"' \
--form 'content="مهندس برمجيات - نحن نبحث عن مهندس برمجيات متمرس في JavaScript و React و Node.js، مع خبرة في منهجيات Agile."' \
--form 'language="English"'
مثال على الرد:
{
"status_url": "https://sharpapi.com/api/v1/job/status/45da1abe-35a3-4628-ae70-e2cb48c084c2",
"job_id": "45da1abe-35a3-4628-ae70-e2cb48c084c2"
}
الخطوة 2. مراقبة وجلب النتائج
نقطة النهاية: GET - /api/v1/hr/resume_match_score/job/status/:uuid
تعيد هذه النقطة النهائية حالة ونتيجة مطابقة السيرة الذاتية مع الوظيفة.
مثال على النتيجة:
{
"data": {
"type": "api_job_result",
"id": "2f17d9ef-dcbc-4521-9a20-6d9f41e58de8",
"attributes": {
"status": "success",
"type": "hr_resume_job_match_score",
"result": {
"match_scores": {
"overall_match": 65,
"skills_match": 80,
"experience_match": 90,
"education_match": 0,
"certifications_match": 0,
"job_title_relevance": 70,
"industry_experience_match": 85,
"project_experience_match": 75,
"technical_stack_match": 80,
"methodologies_match": 60,
"soft_skills_match": 75,
"language_proficiency_match": 100,
"location_preference_match": 50,
"remote_work_flexibility": 80,
"certifications_training_relevance": 0,
"years_experience_weighting": 90,
"recent_role_relevance": 60,
"management_experience_match": 100,
"cultural_fit_potential": 70,
"stability_score": 85
},
"explanations": {
"skills_match": "لدى المرشح مهارات قوية في PHP و MySQL، والتي تتوافق بشكل جيد مع متطلبات الوظيفة. ومع ذلك، لم يتم ذكر خبرة في Laravel بشكل محدد.",
"experience_match": "لدى المرشح أكثر من 22 عامًا من الخبرة في البرمجة، وهو ما يتناسب بشدة ويتجاوز المتطلبات النموذجية للدور.",
"education_match": "لم يتم تقديم خلفية تعليمية محددة في السيرة الذاتية، مما يجعل من المستحيل تقييم التوافق مع متطلبات الوظيفة.",
"certifications_match": "لم يتم ذكر أي شهادات في السيرة الذاتية، لذلك لا يمكن تقييم التوافق مع أي شهادات مطلوبة.",
"language_proficiency_match": "لدى المرشح كفاءة مهنية في اللغة الإنجليزية، والتي تتوافق مع متطلبات الوظيفة لمهارات التواصل باللغة الإنجليزية."
}
}
}
}
}
المعاملات المدعومة
| الاسم |
النوع |
الوصف |
| file |
ملف |
ملف السيرة الذاتية (PDF، DOCX، TXT، إلخ.) |
| content |
سلسلة |
وصف كامل للوظيفة بنص عادي |
| language |
سلسلة |
لغة التفسيرات (الافتراضي هو "الإنجليزية") |
المواضيع ذات الصلة: مطابقة السيرة الذاتية مع الوظيفة، واجهة برمجة تطبيقات تقييم السيرة الذاتية، محرك تقييم السيرة الذاتية، برنامج مطابقة الموارد البشرية، مساعد التوظيف بالذكاء الاصطناعي، واجهة برمجة تطبيقات تقييم المتقدمين، توافق نظام تتبع المتقدمين