توثيق API

الاتصال والعمل مع واجهة برمجة تطبيقات Shifton

واجهة برمجة التطبيقات Shifton تمنحك الوصول إلى جميع الميزات الرئيسية للمنصة — من إدارة الجداول إلى التكامل مع إدارة الموارد البشرية , الرواتب، و أنظمة التحليلات الخارجية.
باستخدام واجهة برمجة التطبيقات، يمكنك أتمتة العمليات وربط Shifton بخدمات الشركة الداخلية.

وثائق واجهة برمجة التطبيقات

نحن ندعم نسختين من وثائقنا:

• 📄 الوثائق القديمة — النسخة السابقة من مرجع واجهة برمجة التطبيقات (لا تزال مدعومة للتكاملات الحالية):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 الوثائق الجديدة — النسخة الحالية من واجهة برمجة التطبيقات مع هيكل محدث وأحدث الطرق:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

البدء

الحصول على مفتاح API

في إعدادات شركتك على منصة Shifton، قم بإنشاء مفتاح API.
يتم التفويض عبر الرأس:

قم بإجراء الطلب الأول

على سبيل المثال، لاسترداد قائمة الموظفين:

مثال على الاستجابة:

دمج واجهة برمجة التطبيقات في سير العمل الخاص بك

• إنشاء وتعديل الشفتات تلقائيًا

• إدارة طلبات الإجازات المرضية والإجازات السنوية

• تصدير البيانات إلى أنظمة الرواتب

• بناء لوحات القيادة والتقارير المخصصة

قدرات API الأساسية

• الموظفين – إضافة، تحرير، وإدارة الأدوار

• الجداول – إنشاء، تعديل الشفت، تخطيط العمل

• الإجازات والغيابات – إدارة طلبات الإجازات والغياب المرضي

• التقارير – تصدير بيانات الوقت، الرواتب، والحضور

أكواد الأخطاء

يستخدم Shifton API أكواد حالة HTTP القياسية:

• 200 — طلب ناجح

• 201 — تم إنشاء الكائن بنجاح

• 400 — بارامترات غير صالحة

• 401 — خطأ في التفويض (مفتاح API غير صالح)

• 403 — تم رفض الوصول

• 404 — المورد غير موجود

• 500 — خطأ في الخادم

نصائح الاستخدام

• دائمًا استخدم إصدار API الجديد للتكاملات الجديدة

• استخدام Postman أو curl للاختبار

• احترام القيود المفروضة على المعدلات لتجنب الحظر

• تحديث التكاملات التي لا تزال تعتمد على الوثائق القديمة