مركز المساعدةمركز المساعدة / المطورون · مرجع
كيف يسجّل برنامج الدخول إلى API المتجر، وكيف تتحقق من رمز، وحدّ الطلبات.
هذه الصفحة ترجمة آلية ولم تُراجع بعد.
يقبل API المتجر رمزًا يخص حسابًا واحدًا في اللوحة. الطلب المرسَل به يتصرف بصفة ذلك الشخص.
العنوان الأساسي: عنوان لوحتك متبوعًا بـ /api/shop. أرسل JSON، وأرسل Accept: application/json لتعود الأخطاء بصيغة JSON.
توجد طريقتان.
من اللوحة. يفتح المالك المتجر › واتساب API و Webhooks ويختار 1. إنشاء رمز، أو إعادة الإنشاء إذا كان هناك رمز. 2. إظهار الرمز يكشفه و3. نسخ ينسخه. الخطوات في صفحة واتساب API و Webhooks.
بتسجيل الدخول. POST /api/shop/login
| الحقل | مطلوب | المعنى |
|---|---|---|
email | نعم | البريد الإلكتروني لحساب مالك متجر أو موظف في المتجر |
password | نعم | كلمة مرور ذلك الحساب |
{ "success": true, "data": { "auth_token": "<your token>", "user_id": 42 }, "message": [] }
البيانات الخاطئة تفشل في التحقق مع الرسالة "username or password incorrect" على الحقل password.
أرسله كترويسة مع كل طلب:
curl -X POST 'https://<your panel address>/api/shop/product/bulk-update' \
-H 'Authorization: Bearer <your token>' \
-H 'Content-Type: application/json' -H 'Accept: application/json' \
-d '{"products":[{"id":1042,"price":120}]}'
تذكر اللوحة أن الرمز لا تنتهي صلاحيته.
POST /api/shop/validate-login
| الحقل | مطلوب | المعنى |
|---|---|---|
auth_token | نعم | الرمز الذي تحمله |
user_id | نعم | قيمة user_id التي أُعيدت معه |
يُجيب بالقيمتين نفسيهما auth_token وuser_id إذا كان الزوج هو المحفوظ لمالك أو لمدير المتجر. وإلا يفشل التحقق مع الرسالة "invalid auth_token or user_id". الرمز الذي استُبدل برمز أحدث يفشل في هذا الفحص.
| القاعدة | القيمة |
|---|---|
| الطلبات | 500 في الدقيقة. بعدها تكون الاستجابة HTTP 429 |
| رمز مفقود أو مرفوض في طلب محمي | HTTP 403 مع النص "Unauthorized." |
تحت /api/shop يوجد طلب بيانات واحد: تحديث المنتجات بالجملة. لإنشاء المنتجات أو مزامنة المخزون أو قراءة الطلبات، استخدم API الوارد، وله رمزه الخاص.