المطوّرون

واجهة REST موصوفة بـ OpenAPI، وSDK بأنواع مولَّدة من سجل العمليات، وخادم MCP.

وصف الواجهةOpenAPI 3.1/v1/openapi.json
نوع المفتاحغير معروف
SDK@marketing-os/sdkأنواع العمليات مولَّدة من السجل نفسه
MCPmamz_mcp_مفاتيح منفصلة، للقراءة افتراضيًا

كيف تبدأ

  1. احصل على مفتاح

    مفتاح يبدأ بـ mamz_test_ يجبر كل تنفيذ على وضع التجربة، فلا يستطيع تحريك ميزانية حقيقية. ابدأ به دائمًا.

  2. ثبّت الـ SDK
    pnpm add @marketing-os/sdk
  3. نفّذ عملية
    const client = new MarketingOsClient({
      baseUrl: "https://ai.zon.sa",
      apiKey: process.env.MOAS_API_KEY ?? "",
    });
    
    const result = await client.execute(
      "ga4.run_report",
      { propertyId, startDate, endDate },
      { connectionId },
    );
  4. مفتاح التكرار للكتابة

    كل عملية كتابة تحتاج idempotencyKey يصف القصد لا المحاولة. توليد مفتاح جديد لكل محاولة يُبطل الحماية كلها، وهو أشهر طريقة لإرسال الشيء مرتين.

  5. الموافقات

    قد تُعيد الكتابة approval_required بدل التنفيذ. هذا هو النظام يعمل، لا فشل: مرّر approvalId في الاستدعاء التالي لاستئناف الطلب نفسه.

اختر مساحة عمل

كل ما يظهر في MOAS مرتبط بمساحة عمل واحدة. اختر واحدة للمتابعة.

مساحات العمل

اختر مساحة عمل

كل ما يظهر في MOAS مرتبط بمساحة عمل واحدة. اختر واحدة للمتابعة.

مساحات العمل

اختر مساحة عمل

كل ما يظهر في MOAS مرتبط بمساحة عمل واحدة. اختر واحدة للمتابعة.

مساحات العمل

العمليات المتاحة لهذا المفتاح

جارٍ التحميل…

لا تعرض MOAS قيمة أي مفتاح أو سر. تُدار المفاتيح من إعدادات النشر.