Webhooks

Mit einem Webhook können Sie eine von Ihnen gewählte URL aufrufen, wenn ein bestimmtes Ereignis auftritt (zum Beispiel ein QR Code gescannt wird).

Webhook QR Code

Ereignisse

Event ausgelöst wenn
QR_CODE_CREATED ein QR Code angelegt wird
QR_CODE_SCANNED ein QR Code gescannt wurde
VOUCHER_CREATED ein Gutschein angelegt wurde
VOUCHER_UPDATED ein Gutschein aktualisiert wurde
VOUCHER_REDEEMED ein Gutschein eingelöst wurde
VOUCHER_EXPIRED ein Gutschein abgelaufen ist

Parameter

Eine Webhook URL wird je nach Ereignis mit bestimmten Parametern, die in einen POST Request verpackt werden, aufgerufen.

Standard Parameter
event Der Name des Ereignisses
z.B. QR_CODE_SCANNED
timestamp Der Zeitpunkt, wann das Ereignis aufgetreten ist
user Der Benutzer, der den QR Code angelegt hat
code Die Kurz-URL von dem QR Code

QR Code scanned
redirects Die Anzahl wie oft ein QR Code gescannt wurde
visitors Die Anzahl von eindeutigen Besuchern, die den QR Code gescannt haben
device Das Gerät, welches den QR Code gescannt hat
os Das Betriebssystem, welches den QR Code gescannt hat
country Das Land indem der QR Code gescannt wurde
lng/lat Eine optionale Ortsangabe mit einem lng/lat Paar,
wenn ein Benutzer seine GPS Daten mitschickt.

Debugging

Wenn Sie die Informationen, die an Ihren Server bei einem Webhook geschickt werden, ausgeben möchten, verwenden Sie folgendes PHP Skript um alle Parameter anzuzeigen:

<?php

    // Test WebHook und zeige übergebene Parameter an

    error_log("Fired WebHook");

    foreach ($_POST as $param_name => $param_val) {
        error_log("$param_name: $param_val");
    }
Top