REST API v3

دليل تكامل ووكومرس

اربط متجر ووردبريس بـ ZaLinkAI باستخدام REST API v3 وافتح قدرات التجارة بالذكاء الاصطناعي.

إعداد مفاتيح API

يستخدم ووكومرس مصادقة مفتاح المستهلك/السر بدلاً من OAuth. أنشئ بيانات الاعتماد من لوحة تحكم ووردبريس.

1

افتح لوحة تحكم ووردبريس

انتقل إلى لوحة إدارة ووردبريس على yoursite.com/wp-admin. اذهب إلى WooCommerce > الإعدادات > متقدم > REST API.

2

إنشاء مفاتيح API

انقر على "إضافة مفتاح" وأدخل وصفاً (مثل "ZaLinkAI"). اختر مستخدماً بصلاحيات المسؤول واضبط الأذونات على قراءة/كتابة.

3

نسخ بيانات الاعتماد

انسخ مفتاح المستهلك وسر المستهلك. تُعرض مرة واحدة فقط. يقوم ZaLinkAI بتشفيرها بـ AES-256 قبل التخزين.

4

الإدخال في ZaLinkAI

الصق مفتاح المستهلك وسر المستهلك ورابط متجرك في نموذج إعداد ZaLinkAI. يتم التحقق من الاتصال فوراً.

قدرات REST API v3

كل ما يمكن لوكلاء الذكاء الاصطناعي تحقيقه عبر موصل WooCommerce REST API v3.

إدارة المنتجات

  • دعم المنتجات البسيطة والمتغيرة
  • متغيرات المنتج مع السمات
  • هرمية الفئات والعلامات
  • إدارة معرض الصور

معالجة الطلبات

  • إنشاء وقراءة وتحديث الطلبات
  • ملاحظات الطلب للتواصل الداخلي
  • تحديثات التنفيذ والتتبع
  • معالجة الاسترداد عبر API

الكوبونات والخصومات

  • إنشاء والتحقق من الكوبونات
  • خصومات بالنسبة المئوية والمبلغ الثابت
  • حدود الاستخدام وتواريخ الانتهاء
  • دعم كوبون الشحن المجاني

بيانات العملاء

  • ملفات العملاء والعناوين
  • سجل المشتريات وعدد الطلبات
  • معالجة عملاء الدفع كضيف
  • ملاحظات وبيانات وصفية للعملاء

المنتجات المتغيرة والكوبونات

يتفوق ووكومرس في هياكل المنتجات المعقدة والعروض المرنة.

  • منتجات متغيرة بسمات غير محدودة (المقاس، اللون، المادة، إلخ).

  • كل متغير يمكن أن يكون له سعره وSKU ومستوى مخزونه وصورته الخاصة.

  • الكوبونات تدعم أنواع خصم بالنسبة المئوية والسلة الثابتة والمنتج الثابت.

  • قيود الكوبون تشمل حد أدنى للإنفاق واستثناءات المنتجات/الفئات وحدود الاستخدام.

  • يمكن لوكلاء الذكاء الاصطناعي التحقق من الكوبونات وحساب الخصومات في الوقت الفعلي أثناء المحادثات.

متطلبات ووردبريس

الحد الأدنى من البيئة المطلوبة لاتصال ZaLinkAI موثوق.

WordPress

6.0+

WooCommerce

8.0+

PHP

8.1+

REST API

مفعّل (افتراضي)

الروابط الدائمة

روابط جميلة (ليست عادية)

SSL

HTTPS مطلوب لمصادقة مفتاح API

استكشاف الأخطاء

المشكلات الشائعة وحلولها لتكامل ووكومرس.

woocommerce_rest_authentication_error

مفتاح المستهلك أو السر غير صالح أو تم إعادة إنشائه.

أنشئ مفاتيح API جديدة في لوحة تحكم ووردبريس > WooCommerce > الإعدادات > متقدم > REST API. حدّث بيانات الاعتماد في ZaLinkAI.

401 Unauthorized (SSL)

استخدام HTTP بدلاً من HTTPS لمصادقة مفتاح API.

يتطلب ووكومرس HTTPS لمصادقة مفتاح المستهلك/السر. تأكد من أن موقعك يحتوي على شهادة SSL صالحة.

rest_no_route

REST API لووكومرس معطل أو الروابط الدائمة مضبوطة على "عادي".

فعّل الروابط الدائمة الجميلة في لوحة تحكم ووردبريس > الإعدادات > الروابط الدائمة. اختر أي خيار عدا "عادي".

product_variations_not_found

المنتج المتغير موجود لكن لا يحتوي على متغيرات مُعدّة.

في لوحة تحكم ووردبريس، اذهب لمحرر المنتج وأضف متغيرات تحت تبويب "المتغيرات". احفظ وانشر.

اربط متجر ووكومرس الخاص بك