المطورون

اربط كيريرسم بأنظمتك الخاصة.

واجهة برمجة عامة وويب هوك للوظائف والموظفين وتتبع الوقت والطلبات والإجازات وهيكل المؤسسة. متاح على خطتي Professional و Enterprise.

14 مورداً
الوظائف والموظفون والوقت والطلبات والرواتب والأداء وأكثر
ويب هوك موقّع
احصل على إشعار لحظة حدوث أي شيء، بدون استعلام متكرر
مفاتيح محددة الصلاحية
كل مفتاح يصل فقط إلى الموارد التي تختارها
البدء

من التسجيل إلى أول طلب في دقائق.

تتم العملية بالكامل من لوحة التحكم، دون حساب مطورين منفصل.

  1. الترقية إلى خطة Professional أو Enterprise

    الوصول إلى واجهة البرمجة العامة مشمول في هاتين الخطتين. إذا كنت على خطة Starter أو التجربة المجانية، قم بالترقية أولاً من إعدادات المؤسسة.

  2. إنشاء مفتاح واجهة برمجة

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

  3. استدعاء واجهة البرمجة

    أرسل مفتاحك كرمز Bearer في ترويسة Authorization لأي طلب إلى إحدى نقاط النهاية أدناه.

  4. الاشتراك في الويب هوك (اختياري)

    سجّل رابطاً وأنواع الأحداث التي تهمك، وستقوم كيريرسم بتسليم حمولات موقّعة إلى نقطتك فور حدوثها.

المصادقة

كل مفتاح محدد الصلاحية وقابل للإلغاء.

تُعرض المفاتيح مرة واحدة فقط عند إنشائها. احفظ مفتاحك كما تحفظ أي بيانات اعتماد إنتاج أخرى.

رموز Bearer

أرسل مفتاحك بصيغة Authorization: Bearer YOUR_KEY مع كل طلب. المفاتيح مستقلة عن تسجيل دخولك في كيريرسم ولا تنتهي من تلقاء نفسها.

الصلاحيات

يعمل المفتاح فقط مع الموارد التي مُنحت له عند إنشائه، مثل jobs:read أو time_off:read. اطلب فقط ما تحتاجه عملية التكامل بالفعل.

الإلغاء

يمكنك إلغاء مفتاح من تبويب المطورين في أي وقت. يسري الإلغاء فوراً على الطلب التالي.

حدود المعدل

لكل مفتاح حد خاص به لعدد الطلبات في الدقيقة، يظهر في ترويسة الاستجابة X-RateLimit-Remaining، بحيث لا تؤثر عملية تكامل واحدة على الأخرى.

الموارد

أربع عشرة نقطة نهاية، بشكل متسق واحد.

كل استجابة محددة بشركتك تلقائياً. تستخدم الصفحات معاملات limit و offset. اضغط على نقطة نهاية لرؤية نموذج طلب واستجابة.

الويب هوك

تفاعل مع الأحداث، لا تستعلم عنها.

سجّل رابطاً مستهدفاً وأنواع الأحداث التي تريدها، من تبويب المطورين.

employee.hired

تم إنشاء سجل موظف جديد.

application.stage_changed

انتقل مرشح إلى مرحلة جديدة في إحدى وظائفك.

leave.approved

تمت الموافقة على طلب إجازة.

timesheet.submitted

قدّم موظف سجلات وقت للمراجعة.

تتضمن كل عملية تسليم ترويسة X-Careersome-Signature، وهي HMAC للحمولة باستخدام سر الويب هوك الخاص بك، لتتحقق من أنها قادمة من كيريرسم فعلاً. تُعاد محاولة عمليات التسليم الفاشلة تلقائياً بفترات متزايدة.

جاهز لربط أنظمتك؟

أنشئ أول مفتاح واجهة برمجة من إعدادات المؤسسة، أو تحدث معنا عن عملية التكامل الخاصة بك.