Quire
يتصل Make بـQuire عبر REST API وخطافات الويب، باستخدام وحدات HTTP وخطافات الويب الخاصة به. كل ما يقدمه مرجع API متاح.
ابدأ سيناريو من حدث في Quire
- أضف الوحدة Custom webhook ضمن Webhooks لتكون أول وحدة، ثم انسخ عنوانها.
- افتح
/admin/webhooksفي Quire واختر إضافة اشتراك والصق العنوان واختر الأحداث. يساعد حدث الاختبار من Quire Make على معرفة شكل محتوى الطلب؛ شغّل الوحدة مرة أثناء إرساله. - تحقق من التوقيع قبل تنفيذ أي إجراء. مرر الرؤوس من الإعدادات المتقدمة لخطاف الويب، ثم تحقق من
webhook-signatureمقابل{webhook-id}.{webhook-timestamp}.{body}باستخدام سر الاشتراك كما يوضح دليل المطور. أضف عامل تصفية يوقف السيناريو عند فشل التحقق.
استدعِ Quire من سيناريو
استخدم وحدة HTTP وإجراء Make a request:
| الحقل | القيمة |
|---|---|
| URL | https://acme.quirelms.com/api/v1/<resource> |
| Method | كما يحدده مرجع API |
| Headers | Authorization: Bearer qk_live_... وIdempotency-Key لعمليات الكتابة |
| Body type | Raw, JSON |
| Parse response | Yes |
أنشئ مفتاحًا خاصًا بـMake في /admin/integrations/api-keys ولا تمنحه سوى النطاقات التي يحتاجها السيناريو. وفي القوائم، كرر العملية ما دامت page.has_more تساوي true، ومرر page.next_cursor كقيمة cursor: يمكن لوحدة Repeater مع Set variable تحمل قيمة المؤشر تنفيذ ذلك.
للسيناريوهات التي ينبغي أن تتصرف بصفتها شخصًا، سجّل عميل OAuth في /admin/integrations/oauth-clients واستخدم وحدة HTTP وإجراء Make an OAuth 2.0 request معه.
مثال: ملخص أسبوعي للإكمال
- الجدولة: كل يوم اثنين.
- HTTP:
GET /api/v1/course_completions?updated_since=<a week ago>. - استخدام Iterator على
dataثم Aggregator لجمع النتائج في جدول. - إرسال الجدول عبر البريد أو نشره.