ربط Make بوحدة HTTP
تطبيق Marcomm AI لـ Make قيد المراجعة. إلى أن تتم الموافقة عليه، استدعِ API الخاصة بـ Marcomm AI من سيناريو في Make بوحدة HTTP ومفتاح API شخصي.
- 1في Marcomm، انتقل إلى الإعدادات → التكاملات → Make لترى الحالة والقيم التي تحتاجها.

تعرض صفحة Make الحالة الحالية والخطوات والقيم المطلوب نسخها، وما إذا كان الوصول إلى API معتمدًا لمساحة العمل هذه. - 2افتح الإعدادات → API. إذا لم يكن لمساحة العمل وصول إلى API بعد، يملأ المالك أو المسؤول التقدّم بطلب الوصول إلى API ويختار إرسال الطلب.
- 3بعد الموافقة، افتح إنشاء مفتاح، واختر مفتاح شخصي، وحدّد النطاقات التي تحتاجها، ثم اختر إنشاء المفتاح. انسخ المفتاح فورًا لأنه يظهر مرة واحدة فقط.
- 4في سيناريو Make، أضف وحدة HTTP واختر Make a request.
- 5أدخل نقطة نهاية من وثائق المطوّرين بعد
https://marcomm.works/api/v1، وأضف الترويسةAuthorizationبالقيمةBearerمتبوعة بمفتاحك.
ابدأ بـ GET /me للتحقق من المفتاح قبل بناء بقية السيناريو.
تطبيق Marcomm AI لـ Make قيد المراجعة ولا يمكن إضافته بعد. بعد الموافقة، تستدعي وحدته Make an API call أي نقطة نهاية في مرجع API بالمفتاح الشخصي نفسه. وحتى ذلك الحين تؤدي وحدة HTTP العمل نفسه. يمكن أيضًا إرسال أحداث Marcomm AI إلى عنوان webhook في Make تضيفه في تبويب Webhooks ضمن الإعدادات → API.
تحدّد النطاقات ما يستطيع المفتاح فعله. المحتوى (content) يقرأ البيانات الصحفية ومقالات المدونة والفعاليات الصحفية، وكتابة المحتوى (content:write) ينشئ المسودات ويعدّلها، والنشر والإرسال (distribution) ينشر ويرسل بالبريد الإلكتروني، والموافقات (approvals) يغطي خطوات الموافقة. تعمل النطاقات الثلاثة الأخيرة مع مفتاح شخصي فقط، لأن الإجراء يُسجَّل باسم من أنشأ المفتاح. أما مفتاح مساحة العمل فيقرأ فقط، وكل مفتاح يعمل بدور منشئه وصلاحياته.
لا يمكن التراجع عن النشر والإرسال. لا تنفّذهما API إلا إذا احتوى الطلب على confirm: true أو ترويسة Idempotency-Key، ولا تنشر شيئًا وتردّ بالرمز 409 ما دامت الموافقة مطلوبة أو كان المحتوى مجدولًا أو تحت حظر النشر. إعادة المحاولة بالمفتاح Idempotency-Key نفسه والطلب نفسه تعيد النتيجة الأولى لمدة 24 ساعة بدل التنفيذ مرة أخرى. في وحدة HTTP، أضف ترويسة Idempotency-Key بنفسك إلى كل طلب كتابة.
تتوفر API في خطة Team وما فوقها. يراجع فريق Marcomm AI كل طلب، ولا تعمل المفاتيح إلا بعد الموافقة. لا يستخدم المفتاح إلا النطاقات المعتمدة لمساحة العمل، ويمكن لكل شخص امتلاك 10 مفاتيح كحد أقصى. افتراضيًا يمكن لمساحة العمل إرسال 60 طلبًا في الدقيقة و10,000 طلب في اليوم، وبعد ذلك تردّ API بالرمز 429 مع ترويسة Retry-After. لرفع الحدود، استخدم تحتاج إلى حدود أعلى؟ في الإعدادات → API. لفصل Make، اختر إلغاء بجانب المفتاح، فتفقد الأنظمة التي تستخدمه الوصول فورًا.
الأسئلة الشائعة
استدعِ
GET https://marcomm.works/api/v1/meمع الترويسةAuthorization: Bearerمتبوعة بمفتاحك. يعمل ذلك مع أي مفتاح معتمد أيًا كانت نطاقاته، ويعيد مساحة العمل واسم المفتاح ونطاقاته.لا يسجّل المفتاح الخدمة التي تستخدمه، لذلك لا يضع Marcomm علامة متصل على بطاقة Make. تعرض الإعدادات → API آخر مرة استُخدم فيها كل مفتاح.
أدخل
https://marcomm.works/api/v1متبوعًا بمسار من وثائق المطوّرين، مثل/press-releasesلعرض قائمة البيانات الصحفية.