Make verbindet sich über die REST-API und Webhooks mit Quire und verwendet dafür die HTTP- und Webhook-Module von Make. Alles aus der API-Referenz ist verfügbar.
Ein Szenario durch ein Quire-Ereignis starten
- Fügen Sie als erstes Modul Webhooks mit Custom webhook hinzu und kopieren Sie dessen Adresse.
- Öffnen Sie in Quire
/admin/webhooks, wählen Sie Add subscription, fügen Sie die Adresse ein und wählen Sie die Ereignisse. Mit Quire’s Testereignis kann Make die Form des Bodys ermitteln: Führen Sie das Modul während des Versands einmal aus. - Prüfen Sie die Signatur, bevor Sie weitere Aktionen ausführen. Leiten Sie in den erweiterten Einstellungen des Webhooks die Header weiter und prüfen Sie
webhook-signatureanhand von{webhook-id}.{webhook-timestamp}.{body}und dem Abonnement-Secret, wie im Entwicklerhandbuch beschrieben. Fügen Sie einen Filter hinzu, der das Szenario bei fehlgeschlagener Prüfung stoppt.
Quire aus einem Szenario aufrufen
Verwenden Sie im Modul HTTP die Aktion Make a request:
| Feld | Wert |
|---|---|
| URL | https://acme.quirelms.com/api/v1/<resource> |
| Methode | Wie in der API-Referenz angegeben |
| Header | Authorization: Bearer qk_live_... und bei Schreibvorgängen Idempotency-Key |
| Body-Typ | Raw, JSON |
| Antwort parsen | Yes |
Erstellen Sie unter /admin/integrations/api-keys einen Schlüssel ausschließlich für Make und vergeben Sie nur die Berechtigungsbereiche, die das Szenario benötigt. Durchlaufen Sie Listen, solange page.has_more den Wert true hat, und übergeben Sie page.next_cursor als cursor: Das gelingt mit Make’s Repeater und einer Set variable, die den Cursor speichert.
Für Szenarien, die als Person handeln sollen, registrieren Sie unter /admin/integrations/oauth-clients einen OAuth-Client und verwenden das Modul HTTP von Make mit der Aktion Make an OAuth 2.0 request.
Beispiel: Wöchentliche Übersicht der Abschlüsse
- Schedule: jeden Montag.
- HTTP:
GET /api/v1/course_completions?updated_since=<a week ago>. - Iterator über
data, Aggregator zu einer Tabelle. - Senden Sie die Tabelle per E-Mail oder veröffentlichen Sie sie.