Die technischste Seite des Radiobereichs, und das darf sie sein — wer hierherkommt, baut selbst etwas. Sie geben eine Adresse an, und Ihr Sender ruft sie auf, sobald etwas passiert.
Der Webhook-Bildschirm
Das steckt in den größeren Paketen. Ist es nicht in Ihrem, können Sie bestehende Webhooks noch aufräumen, aber keine hinzufügen.
Unterschied zu "melden, was läuft"
Das steht unter Doorgeven aan anderen und betrifft nur Titelwechsel, mit Interpret und Titel in der URL. Webhooks sind breiter: Sie melden auch, dass Ihr Sender gestartet oder gestoppt hat oder dass ein DJ sich verbunden hat, und sie schicken eine echte Nachricht statt nur eine Adresse.
Einen Endpunkt anlegen
Geben Sie die Adresse an, an die wir senden dürfen, und haken Sie an, welche Ereignisse Sie empfangen wollen.
Das Geheimnis sehen Sie einmal, direkt nach dem Anlegen. Danach nirgends mehr. Speichern Sie es sofort — deshalb bleibt es groß im Bild stehen, bis Sie es selbst wegklicken. Mit diesem Geheimnis prüfen Sie auf Ihrer Seite, dass eine Nachricht wirklich von uns kommt.
Was die Ereignisse bedeuten
Zwei davon werden leicht falsch gelesen, deshalb zuerst:
Ihr Sender ist auf einen anderen Server umgezogen betrifft Ihren Sender, der die Maschine wechselt. Das ist nicht das Stille-Netz, das einspringt — das ist etwas anderes.
Ihr Datenverbrauch ist aufgebraucht kommt, wenn er aufgebraucht ist, nicht als Warnung vorab. Ihr Sender sendet aber weiter.
Daneben gibt es Meldungen für Start und Stopp Ihres Senders, für einen DJ, der sich verbindet oder auflegt, und für den Titelwechsel.
Die Zustellungen
Unter Ihren Endpunkten steht, was gesendet wurde und ob es angekommen ist. Ohne das tragen Sie eine Adresse ein und wissen nie, ob je etwas angekommen ist.
Schauen Sie zuerst hier, wenn Ihr System nichts empfängt. Steht dort ein Fehlercode, wurde die Nachricht sehr wohl gesendet und Ihre Seite hat sie abgelehnt.
Worauf Sie achten müssen
Ihr Endpunkt muss schnell antworten. Dauert es zu lange, gilt es als fehlgeschlagen.
Antworten Sie mit einem Code im 200er-Bereich, sobald Sie die Nachricht angenommen haben, und erledigen Sie die eigentliche Arbeit danach. Mit der Antwort zu warten, bis Sie fertig sind, ist der häufigste Fehler.