العودة إلى التوثيق

بدء سريع للمطورين

ابدأ العمل مع واجهة zalink.ai API في دقائق

إنشاء مفتاح API

يتم إنشاء مفاتيح API من لوحة تحكم التاجر. كل مفتاح مرتبط بمتجر محدد.

1

سجل الدخول إلى لوحة تحكم zalink.ai

2

انتقل إلى الإعدادات > مفاتيح API

3

انقر على "إنشاء مفتاح جديد" وحدد الصلاحيات

4

انسخ المفتاح فوراً (لن يظهر مرة أخرى)

5

خزّن المفتاح بأمان في متغيرات البيئة

لا تكشف مفاتيح API في الكود من جانب العميل أو المستودعات العامة.

أول استدعاء API

ابحث عن المنتجات في متجرك المتصل بطلب GET بسيط.

curl -X GET "https://api.zalink.ai/api/stores/YOUR_STORE_ID/products?q=headphones&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

اتصال MCP (Claude Desktop)

أضف zalink.ai كخادم MCP في ملف تكوين Claude Desktop لمنح Claude إمكانية الوصول إلى بيانات متجرك.

  1. 1

    افتح إعدادات Claude Desktop

  2. 2

    انتقل إلى المطور > خوادم MCP

  3. 3

    أضف التكوين أدناه مع بيانات اعتمادك

  4. 4

    أعد تشغيل Claude Desktop للتفعيل

claude_desktop_config.json

{
  "mcpServers": {
    "zalink-ai": {
      "url": "https://api.zalink.ai/mcp/YOUR_STORE_ID",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

OpenAPI / إجراءات ChatGPT

استخدم نقاط نهاية ACP مع مواصفات OpenAPI لإنشاء إجراءات ChatGPT مخصصة لمتجرك.

  1. 1

    اذهب إلى ChatGPT > My GPTs > إنشاء/تعديل

  2. 2

    اختر "الإجراءات" واختر "استيراد من URL"

  3. 3

    استخدم: https://api.zalink.ai/acp/stores/YOUR_STORE_ID/openapi.json

  4. 4

    هيّئ المصادقة بمفتاح API الخاص بك

مخطط إجراء OpenAPI

{
  "openapi": "3.1.0",
  "info": {
    "title": "zalink.ai Store API",
    "version": "1.0.0"
  },
  "servers": [
    { "url": "https://api.zalink.ai" }
  ],
  "paths": {
    "/acp/stores/{storeId}/products/search": {
      "get": {
        "operationId": "searchProducts",
        "summary": "Search store products",
        "parameters": [
          { "name": "storeId", "in": "path", "required": true, "schema": { "type": "string" } },
          { "name": "q", "in": "query", "schema": { "type": "string" } }
        ]
      }
    }
  }
}

بدء سريع مع Webhooks

سجل عنوان URL لـ webhook لاستلام إشعارات الأحداث في الوقت الفعلي.

1

في لوحة التحكم، انتقل إلى الإعدادات > Webhooks

2

أدخل عنوان URL لنقطة نهاية HTTPS

3

اختر الأحداث التي تريد الاشتراك بها

4

انسخ مفتاح webhook السري للتحقق من التوقيع

5

اختبر webhook بحدث تجريبي من لوحة التحكم

مقتطفات المصادقة

مساعدات تجديد الرمز للحفاظ على تشغيل التكامل بسلاسة.

// Token refresh middleware
async function apiRequest(url, options = {}) {
  let token = getStoredToken();
  if (isExpiringSoon(token)) {
    token = await refreshToken(token.refreshToken);
    storeToken(token);
  }
  return fetch(url, {
    ...options,
    headers: {
      ...options.headers,
      "Authorization": `Bearer ${token.accessToken}`,
    },
  });
}

الخطوات التالية

مرجع API الكامل

توثيق كامل لنقاط النهاية مع مخططات الطلب/الاستجابة

توثيق Webhooks

أنواع الأحداث والحمولات والتحقق من التوقيع وسياسة إعادة المحاولة

الدروس

أدلة خطوة بخطوة لتكاملات المنصات وإعداد AI