Ereignisse
| Ereignis | Gesendet, wenn |
|---|---|
| client.created | Ein Kunde wird hinzugefügt. |
| order.submitted | Ein Auftrag wird erteilt. |
| order.approved | Ein Auftrag wird genehmigt. |
| order.settled | Ein Auftrag wird abgewickelt und Anteile werden ausgegeben. |
| distribution.approved | Eine Ausschüttung wird genehmigt. |
| transfer.completed | Eine Übertragung zwischen Anlegern wird abgeschlossen. |
| message.received | Ein Kunde sendet eine Nachricht. |
Nutzdaten enthalten IDs, Nummern und Beträge, aber keine personenbezogenen Daten. Ihr System ruft die Details mit einem API-Schlüssel ab.
Endpunkt hinzufügen
- Öffnen Sie Einstellungen, dann Webhooks, und wählen Sie Endpunkt hinzufügen.
- Geben Sie eine
https-Adresse ein, die innerhalb weniger Sekunden mit einem 2xx-Status antwortet. Wählen Sie die Ereignisse. - Kopieren Sie das Signaturgeheimnis. Es wird einmal angezeigt.
- Wählen Sie Testereignis senden, um den Empfang zu prüfen.
- Nur
https-Adressen auf öffentlichen Hosts sind zulässig. Adressen zu privaten oder internen Netzwerken werden abgewiesen. - Weiterleitungen werden nicht verfolgt.
Signatur prüfen
Jede Zustellung ist ein JSON-POST mit den Headern EasyHaus-Event, EasyHaus-Delivery und EasyHaus-Signature. Die Signatur sieht so aus: t=<unix time>,v1=<hex>. Berechnen Sie mit Ihrem Geheimnis einen HMAC-SHA256 des Textes <t>.<raw body>, vergleichen Sie ihn mit v1 und weisen Sie alte Zeitstempel zurück.
Der Nachrichtentext lautet {id, type, created_at, organization_id, data}.
Wiederholungen und Deaktivierung
- Antworten Sie innerhalb von 10 Sekunden. Eine fehlgeschlagene Zustellung wird mit zunehmenden Abständen bis zu 10 Mal versucht.
- Nach 20 aufeinanderfolgenden Fehlern wird der Endpunkt deaktiviert und Eigentümer sowie Administratoren werden per E-Mail informiert. Beheben Sie das Problem und aktivieren Sie ihn erneut; dadurch wird der Zähler zurückgesetzt.
- Das Zustellprotokoll zeigt jede Zustellung mit Status und HTTP-Code und ermöglicht eine erneute Zustellung.
- Sie können Ereignisse bearbeiten, einen Endpunkt deaktivieren, das Geheimnis rotieren (das alte endet sofort) oder ihn löschen.