الرابط الأساسي
https://api.zalink.aiالمصادقة
تتطلب جميع طلبات API المصادقة. أضف مفتاح API كرمز Bearer في رأس Authorization. لتدفقات OAuth، أعد توجيه المستخدمين إلى عنوان تفويض المنصة.
رمز Bearer
Authorization: Bearer YOUR_API_KEYتدفق OAuth 2.0
- 1.إعادة التوجيه إلى /oauth/connect/:platform مع معلمة state
- 2.المستخدم يفوّض على المنصة
- 3.استلام callback على /oauth/callback/:platform
- 4.تخزين الرموز وتشفيرها على الخادم
أمثلة الكود
curl -X GET "https://api.zalink.ai/api/stores/STORE_ID/products?limit=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
نقاط نهاية REST
المتجر
/api/stores/:idالحصول على تفاصيل المتجر وحالة الاتصال
/api/stores/:id/settingsتحديث إعدادات المتجر (الأعمال، الشحن، الضرائب، AI)
المنتجات
/api/stores/:id/productsقائمة المنتجات مع التصفح والفلاتر
/api/stores/:id/products/:productIdالحصول على منتج واحد حسب المعرف
الطلبات
/api/stores/:id/ordersقائمة الطلبات مع فلاتر التاريخ والحالة
/api/stores/:id/orders/:orderIdتفاصيل الطلب بما في ذلك عناصر السطر
العملاء
/api/stores/:id/customersقائمة العملاء مع البحث والتصفح
/api/stores/:id/customers/:customerIdملف العميل وسجل الطلبات
السلة
/api/stores/:id/cartإنشاء سلة جديدة مع عناصر
/api/stores/:id/cart/:cartIdتحديث عناصر السلة أو تطبيق كوبونات
/api/stores/:id/cart/:cartIdحذف سلة
التحليلات
/api/stores/:id/analytics/realtimeالزوار الفوريون والسلات النشطة والإيرادات
/api/stores/:id/analytics/dailyمقاييس المبيعات والحركة اليومية المجمعة
/api/stores/:id/analytics/productsأفضل المنتجات حسب المشاهدات والمبيعات
/api/stores/:id/analytics/customersبيانات اكتساب العملاء والاحتفاظ بهم
/api/stores/:id/analytics/aiمقاييس تفاعل AI ومعدلات التحويل
العروض
/api/stores/:id/promotionsقائمة جميع العروض
/api/stores/:id/promotionsإنشاء عرض أو كوبون جديد
/api/stores/:id/promotions/:promoIdتحديث عرض موجود
/api/stores/:id/promotions/:promoIdحذف عرض
أدوات MCP
أدوات بروتوكول سياق النموذج المتاحة لمساعدي الذكاء الاصطناعي مثل Claude.
واجهة API العامة (ACP)
نقاط نهاية بروتوكول التجارة الوكيلة لـ ChatGPT ووكلاء AI الآخرين.
/acp/stores/:idمعلومات المتجر وقدراته
/acp/stores/:id/products/searchالبحث في المنتجات مع فلاتر
/acp/stores/:id/cartإنشاء سلة للدفع
/acp/stores/:id/checkoutإنشاء رابط الدفع
أحداث Webhook
الأحداث المرسلة إلى عنوان webhook المسجل.
رموز الأخطاء
| الرمز | الاسم | الوصف |
|---|---|---|
| 400 | طلب سيء | معلمات أو جسم طلب غير صالح |
| 401 | غير مصرح | مفتاح API مفقود أو غير صالح |
| 403 | ممنوع | صلاحيات غير كافية لهذا المورد |
| 404 | غير موجود | المورد غير موجود |
| 429 | طلبات كثيرة | تجاوز حد المعدل، أعد المحاولة بعد فترة |
| 500 | خطأ الخادم | خطأ داخلي، تواصل مع الدعم إذا استمر |
حدود المعدل
الحدود مفروضة لكل مفتاح API. الرؤوس: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
| النقطة | الحد |
|---|---|
| واجهة لوحة التحكم | 100 طلب/دقيقة |
| نقاط OAuth | 20 طلب/دقيقة |
| نقاط MCP | 100 طلب/دقيقة |
| نقاط ACP | 100 طلب/دقيقة |
| معالجات Webhook | 200 طلب/دقيقة |