user-choices

الوصول والصلاحيات

Authorization: Bearer <access_token>

يمكن لواجهة ERP الداخلية استخدام الجلسة الحالية مع CSRF. هوية المستخدم وصلاحياته وقواعد العملية تحدد الوصول إلى البيانات.

مصادقة الإضافات

Authorization: HarplinkPlugin <client-uuid>.<secret>

يمكن استخدام Bearer للمستخدم المخوّل أو اعتماد الإضافة لهذه العملية. اعتماد الإضافة يتطلب النطاقات التالية إضافة إلى صلاحيات مستخدم ERP:

معلمات الاستعلام

{
  "results": [
    {
      "id": 7,
      "username": "integration_user",
      "name": "Integration User",
      "email": "user@example.com",
      "branch_id": 2,
      "branch_name": "Example Branch"
    }
  ]
}

مستخدمون وملفات مستخدم فعالة ضمن الشركة والفرع إن توفر. دون شركة تعاد قائمة فارغة.

البحث باسم المستخدم والاسم الأول والأخير والبريد. الترتيب بالاسم الأول ثم اسم المستخدم؛ limit الافتراضي 50 والحد الأعلى 200.

نطاق الاعتماد الصحيح platform.users.read.

401 لمصادقة مفقودة أو غير صالحة؛ 403 عند رفض نطاق الاعتماد أو صلاحية المستخدم. حقول الطلب غير الصالحة تعيد 400 عندما توجد قواعد تحقق.

التعامل مع الأخطاء