المطوّرون
واجهة REST موصوفة بـ OpenAPI، وSDK بأنواع مولَّدة من سجل العمليات، وخادم MCP.
وصف الواجهةOpenAPI 3.1/v1/openapi.json
نوع المفتاح—غير معروف
SDK@marketing-os/sdkأنواع العمليات مولَّدة من السجل نفسه
MCPmamz_mcp_مفاتيح منفصلة، للقراءة افتراضيًا
كيف تبدأ
- احصل على مفتاح
مفتاح يبدأ بـ
mamz_test_يجبر كل تنفيذ على وضع التجربة، فلا يستطيع تحريك ميزانية حقيقية. ابدأ به دائمًا. - ثبّت الـ SDK
pnpm add @marketing-os/sdk - نفّذ عملية
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 }, ); - مفتاح التكرار للكتابة
كل عملية كتابة تحتاج
idempotencyKeyيصف القصد لا المحاولة. توليد مفتاح جديد لكل محاولة يُبطل الحماية كلها، وهو أشهر طريقة لإرسال الشيء مرتين. - الموافقات
قد تُعيد الكتابة
approval_requiredبدل التنفيذ. هذا هو النظام يعمل، لا فشل: مرّرapprovalIdفي الاستدعاء التالي لاستئناف الطلب نفسه.
العمليات المتاحة لهذا المفتاح
جارٍ التحميل…
لا تعرض MOAS قيمة أي مفتاح أو سر. تُدار المفاتيح من إعدادات النشر.