مركز المساعدةمركز المساعدة / المطورون · مرجع
اضبط الرمز الذي يرسله نظام ERP أو نقاط البيع لديك، وفعّل ما يُسمح له بتغييره، واعثر على مرجع API المدمج.
هذه الصفحة ترجمة آلية ولم تُراجع بعد.
يتيح API الوارد لأنظمتك الكتابة في المتجر: المنتجات والمخزون والأسعار والعملاء وقوائم الأسعار. ويمكنه أيضًا قراءة الطلبات وتعديل بنودها. هذا التبويب يحمل رمزه وأزرار تفعيله.
يبدأ التبويب بالعنوان اربط نظام ERP أو نقاط البيع أو أنظمة أخرى.
| الحقل | وظيفته |
|---|---|
| 1. رمز Webhook | المفتاح السري الذي ترسله أنظمتك مع كل طلب. المربع للقراءة فقط. اختر إنشاء رمز لتعبئته برمز عشوائي جديد |
| 2. Webhook المنتجات | يسمح بإنشاء المنتجات وتحديثها عبر item-create |
| 3. Webhook المستخدم | يسمح بإنشاء العملاء وتحديثهم عبر user-create |
| 4. Webhook نوع التاجر | يسمح بأنواع التجار وأسعارها وعملائها. يجب أن يكون مفعّلًا لأي طلب يخص أنواع التجار |
الأربعة كلها بيدك. لا شيء في هذا التبويب يحتاج إلى الدعم. الأزرار متوقفة في المتجر الجديد.
تحديثات المخزون ونقطتا نهاية الطلبات ليس لها زر تفعيل. تعمل فور حفظ رمز.
إذا لم تكن باقتك تشمل الميزة، يكون Webhook المنتجات وWebhook المستخدم مقفلين بشارة تديره المنصة. راجع الباقة والوصول.
تحت مرجع API يعرض التبويب:
/api/webhook.الأمثلة تستخدم بيانات مختلَقة والقيمة النائبة YOUR_WEBHOOK_TOKEN.
| القاعدة | التفصيل |
|---|---|
| الطريقة | POST، مع Content-Type: application/json |
| الرمز | الترويسة Authorization: Bearer <your token>. يُقبل أيضًا حقل password في محتوى JSON |
| رمز خاطئ أو مفقود | HTTP 401، "Authentication failed" |
| الحد | 500 طلب في الدقيقة. بعدها تكون الاستجابة HTTP 429 |
| حقول غير صالحة | HTTP 422، "Validation failed"، مع رسالة لكل حقل تحت data |
curl -X POST 'https://<your panel address>/api/webhook/stock-update' \
-H 'Authorization: Bearer <your token>' \
-H 'Content-Type: application/json' -H 'Accept: application/json' \
-d '{"products_info":[{"ID":"SKU-10045","qty":100}]}'
فضّل الترويسة. في user-create يكون حقل المحتوى password هو أيضًا كلمة مرور العميل، فيتعارض المعنيان.
| المجموعة | نقاط النهاية | الصفحة |
|---|---|---|
| الكتالوج | /item-create, /stock-update, /stock-update-by-order | المنتجات والمخزون |
| العملاء | /user-create | العملاء |
| أنواع التجار | سبع نقاط نهاية /vendor-type-… | أنواع التجار |
| الطلبات | /order/details, /order/updates | الطلبات |