HARPLINK ↗HARPLINK DEVELOPERSمساحة المطور ↗متجر التطبيقات ↗
OFFICIAL SANDBOX

جرّب الربط على بيئة HARPLINK التجريبية

https://demo.harplink.net ↗ · اسم المستخدم: demo · كلمة المرور: demo

بيئة مشتركة للفحص ببيانات تجريبية. تظهر نتائج عمليات الكتابة داخل ERP وقد يغيّرها مستخدمون آخرون؛ استخدم بيانات وهمية. كل طلب API يتطلب توكناً والصلاحيات اللازمة. لربط شركة فعلية غيّر عنوان ERP واستخدم حسابها المخوّل.

اختر العملية وافحصها من المتصفح ←

تنزيل مرجع OpenAPI ↓

منصة الإضافات

context

سياق المستخدم والشركة والفرع

دليل العملية
GET
/api/platform/v1/context/
AUTHENTICATION

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

Authorization: Bearer <access_token>

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

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

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

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

platform.context.read

استجابة توضيحية

200 OK
{
  "api_version": "v1",
  "harplink_version": "8.3",
  "user": {
    "id": 7,
    "username": "integration_user",
    "display_name": "Integration User",
    "is_superuser": false
  },
  "tenant": {
    "company": {
      "id": 1,
      "code": "COMPANY",
      "name": "Example Company"
    },
    "branch": {
      "id": 2,
      "code": 1,
      "name": "Example Branch"
    },
    "fiscal_year": null
  }
}

company وbranch وfiscal_year قد تكون null. لا تستنتج وجود سياق شركة من نجاح المصادقة وحده.

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

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

400راجع بيانات الطلب
401أعد المصادقة
403راجع صلاحية الحساب
429انتظر قبل إعادة المحاولة
REQUEST BUILDER

جهّز مثال الربط

خصّص المعلمات وانسخ المثال إلى تطبيقك.

اترك الفرع فارغاً عند اختيار Bearer. للقوائم، أدخل القيم مفصولة بفواصل؛ نرسل معلمة متكررة لكل قيمة.
TRY THIS ENDPOINT

جرّب الطلب على نظام ERP الخاص بك

الحصول على توكن من المتصفح

أدخل عنوان ERP في الأعلى ثم بيانات حساب ERP، وليس حساب المنصة. بيانات الدخول تُرسل مباشرةً إلى ERP، ولا تُحفظ في المنصة.

أدخل التوكن أو client-uuid.secret بدون اسم نوع المصادقة. يُستخدم لهذا الطلب ولا يُحفظ في المتصفح.

يمكنك تسجيل الدخول أعلاه أو إدخال توكن لديك. هذه تجربة فعلية؛ عمليات الإنشاء والتعديل والحذف قد تغيّر بيانات ERP.

cURL

مرّر التوكن من التخزين الآمن في تطبيقك. الأمثلة تستخدم متغيراً للتوكن وتُولّد محلياً.

حقول ظاهرة في تنفيذ العملية

هذه أسماء مستخرجة من الكود، وقد توجد حقول إضافية أو شروط تعتمد على نوع العملية. راجع عقد العملية ونتيجة الفحص.

حقول الاستجابة

api_version harplink_version tenant user