Curriculo ATS REST API

التكامل

الوصول البرمجي الكامل لبيانات التوظيف الخاصة بك. إنشاء وظائف، سحب درجات المرشحين، مزامنة خطوط الأنابيب، وبناء سير عمل مخصص. متاح في خطة Pro (50 دولار شهريًا).

يوفر CurriculoATS REST API الوصول البرمجي الكامل لبيانات التوظيف الخاصة بك، مما يمكّن الفرق من إنشاء وظائف، واسترجاع درجات المرشحين، وإدارة مراحل خطوط الأنابيب، وبناء تكاملات مخصصة مع أنظمة إدارة الموارد البشرية، والرواتب، وأدوات التقارير. يستخدم API معايير REST القياسية مع استجابات JSON، ومصادقة مفتاح API، وأحداث الويب للUpdates اللحظية. متاح في خطة Pro بسعر 50 دولارًا في الشهر، بدون رسوم طلب لكل طلب ضمن حدود المعدل.

قدرات API

CRUD للوظائف والمرشحين

إنشاء وقراءة وتحديث وحذف الوظائف والمرشحين برمجيًا. نشر قوائم وظائف جديدة من الأدوات الداخلية، وتحديث مراحل المرشحين بشكل جماعي، ومزامنة ملفات تعريف المرشحين مع الأنظمة الخارجية. عمليات CRUD كاملة على جميع الموارد الأساسية.

درجات وبيانات خطوط الأنابيب

استرجاع درجات التأثير (0–100) وتحليلات الأبعاد لكل مرشح. استفسار حول مراحل خطوط الأنابيب، تتبع تقدم المرشحين، وسحب مقاييس التوظيف المجمع لمؤشرات الأداء المخصصة والتقارير.

أحداث الويب

الاشتراك في أحداث الويب في الوقت الفعلي: استلام طلب جديد، تسجيل درجة المرشح، تغيير المرحلة، إرسال العرض، توظيف المرشح. كل حدث ويب يقدم حمولة JSON كاملة مع سياق الحدث إلى نقطة النهاية الخاصة بك.

التصدير الجماعي

تصدير بيانات المرشحين، ونتائج الدرجات، ولقطات خطوط الأنابيب بشكل جماعي. سحب جميع المرشحين لدور معين، جميع الدرجات عبر الأدوار، أو تاريخ خطوط الأنابيب الكامل لتلبية متطلبات الالتزام والتقارير.

حالات الاستخدام

المزامنة مع HRIS والرواتب

عند تمييز مرشح على أنه تم توظيفه في CurriculoATS، دفع ملفه الشخصي تلقائيًا إلى نظام HRIS الخاص بك (BambooHR، Rippling، إلخ) أو نظام الرواتب (Gusto، ADP). القضاء على الإدخال اليدوي للبيانات بين التوظيف والتوجيه.

لوحات المعلومات التحليلية المخصصة

سحب مقاييس التوظيف عبر API وبناء لوحات معلومات مخصصة في أداة BI التي تفضلها، مثل Looker أو Metabase أو Google Sheets. تتبع الوقت حتى التوظيف، جودة المصدر، توزيع الدرجات، ومعدلات تحويل القمع.

نشر وظائف آلي

إنشاء قوائم وظائف في CurriculoATS برمجيًا من أدواتك الداخلية أو نظام إدارة الموقع الوظيفي. عندما تفتح فريقك دورًا جديدًا، ينشئ API الوظيفة، ويحدد معايير التسجيل، وينشط خط الأنابيب تلقائيًا.

إثراء بيانات المرشحين

استخدم أحداث الويب لتفعيل سير عمل الإثراء عندما يتقدم مرشحون جدد. سحب بيانات إضافية من Clearbit أو LinkedIn أو قواعد البيانات الخاصة بك، ثم كتابة الملفات الشخصية الغنية مرة أخرى إلى Curriculo ATS عبر API.

التقنية

المصادقة وحدود المعدل

مصداقية مفتاح API

توليد مفتاح API من لوحة معلومات CurriculoATS الخاصة بك تحت الإعدادات > API. تضمين المفتاح في رأس التفويض لكل طلب. يمكن تدوير المفاتيح في أي وقت دون تعطيل التكاملات النشطة.

حدود المعدل

حدود المعدل القياسية هي 100 طلب في الدقيقة لكل مفتاح API. يُرجع API رموز الحالة 429 عند تجاوز الحدود، مع رأس Retry-After يشير إلى متى يجب المحاولة مرة أخرى. حدود أعلى متاحة في خطة Enterprise.

التوثيق

التوثيق الكامل لـ API متاح في بوابة مطوري CurriculoATS لمشتركي خطة Pro. يشمل مستكشف API تفاعلي، وأمثلة الشيفرة بلغة cURL، Python، Node.js، وRuby، بالإضافة إلى أدوات اختبار أحداث الويب.

مثال للشفرة

إنشاء قائمة وظائف جديدة مع استدعاء API واحد.

# إنشاء قائمة وظيفة جديدة
curl -X POST https://api.curriculo.me/v1/jobs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Senior Backend Engineer",
"department": "Engineering",
"location": "Remote",
"employment_type": "full_time",
"description": "Build and scale our API infrastructure...",
"scoring_criteria": {
"role_fit_weight": 40,
"outcomes_weight": 35,
"context_weight": 25
}
}'