Quire
Make از راه REST API و وب‌هوک‌ها و با ماژول‌های HTTP و webhook خود Make به Quire وصل می‌شود. همهٔ قابلیت‌های مرجع API در دسترس‌اند.
آغاز سناریو با رویداد Quire
- ماژول Webhooks و Custom webhook را به‌عنوان ماژول نخست اضافه و نشانی‌اش را کپی کنید.
- در Quire،
/admin/webhooksرا باز کنید، Add subscription را بزنید، نشانی را بچسبانید و رویدادها را انتخاب کنید. رویداد آزمایشی 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 | بله |
کلیدی ویژهٔ Make در /admin/integrations/api-keys بسازید و فقط دامنه‌هایی را بدهید که سناریو لازم دارد. برای فهرست‌ها تا وقتی page.has_more درست است حلقه بزنید و page.next_cursor را به‌عنوان cursor بفرستید: Repeater در Make به همراه Set variable که مقدار cursor را نگه می‌دارد، این کار را انجام می‌دهد.
برای سناریوهایی که باید از طرف شخصی عمل کنند، یک کلاینت OAuth در /admin/integrations/oauth-clients ثبت کنید و از ماژول HTTP در Make و کنش Make an OAuth 2.0 request استفاده کنید.
نمونه: گزارش هفتگی تکمیل دوره
- Schedule: هر دوشنبه.
- HTTP:
GET /api/v1/course_completions?updated_since=<a week ago>. - Iterator روی
dataو Aggregator برای ساخت جدول. - ایمیل بفرستید یا جدول را منتشر کنید.