De technischste pagina van het radiodeel, en dat mag — wie hier komt bouwt zelf iets. Je geeft een adres op, en je station roept dat aan zodra er iets gebeurt.
Het webhookscherm
Dit zit in de grotere pakketten. Zit het niet in het jouwe, dan kun je bestaande webhooks nog opruimen maar er geen bij maken.
Verschil met "Laten weten wat er draait"
Die staat bij Doorgeven aan anderen en gaat alleen over titelwissels, met de artiest en titel in de URL. Webhooks zijn breder: ze melden ook dat je station is gestart, gestopt, of dat er een dj verbonden is, en ze sturen een echt bericht in plaats van alleen een adres.
Een endpoint maken
Geef het adres op waar wij naartoe mogen sturen, en vink aan welke gebeurtenissen je wilt ontvangen.
Het geheim krijg je één keer te zien, direct na het aanmaken. Daarna nergens meer. Bewaar het meteen — daarom blijft het groot in beeld staan tot je het zelf wegklikt. Met dat geheim controleer je aan jouw kant dat een bericht werkelijk van ons komt.
Wat de gebeurtenissen betekenen
Twee ervan worden makkelijk verkeerd gelezen, dus die eerst:
Je station is naar een andere server verhuisd gaat over jouw station dat van machine wisselt. Dit is niet het stiltevangnet dat inspringt — dat is iets anders.
Je dataverbruik is op komt als het verbruik op is, niet als waarschuwing vooraf. Je station blijft wel gewoon uitzenden.
Verder zijn er meldingen voor het starten en stoppen van je station, voor een dj die verbindt of ophangt, en voor het wisselen van het nummer.
De leveringen
Onder je endpoints staat wat er verstuurd is en of het is aangekomen. Zonder dat lijst je een adres aan en weet je niet of er ooit iets is gearriveerd.
Kijk hier eerst als je systeem niets ontvangt. Staat er een foutcode, dan is het bericht wél verstuurd en heeft jouw kant het geweigerd.
Waar je op moet letten
Je endpoint moet snel antwoorden. Duurt het te lang, dan telt het als mislukt.
Antwoord met een code in de 200-reeks zodra je het bericht hebt aangenomen, en doe het echte werk daarna. Wachten met antwoorden tot je klaar bent is de meest gemaakte fout.