Helpdesk
Helpdesk

Tonen wat er nu op de radio is

Haal via de API op welk programma nu op de radio is en wat er hierna komt.

Voor techniciOnderdeel: ProgrammagidsBijgewerkt op
Op deze pagina

Wil je op je website, in je app of in beeld laten zien wat er nu op de radio is? Dat kan met de API van Airly. Airly kijkt daarvoor in de De programmagids bekijken en aanpassen. Een sleutel maak je zoals bij Een ander systeem koppelen met de API.

Zo werkt het#

Je hebt een beheerder nodig om de sleutel te maken.

  1. Ga naar Instellingen › API en kies Nieuwe sleutel.
  2. Geef de sleutel het recht om de programmagids te lezen.
  3. Haal de gegevens op met deze sleutel in de kop x-api-key:
GET https://app.airly.nl/api/v1/public/channels/{zender-id}/now-on-air

Het zender-ID vind je bij Instellingen › Zenders: open de zender en kopieer het op het tabblad Algemeen.

Wat je terugkrijgt#

{
  "now": "2026-11-05T15:01:29.197Z",
  "current": {
    "startTime": "15:00",
    "endTime": "17:00",
    "startsAt": "2026-11-05T14:00:00.000Z",
    "endsAt": "2026-11-05T16:00:00.000Z",
    "program": { "title": "De Middagshow" }
  },
  "next": {
    "startTime": "17:00",
    "endTime": "18:00",
    "startsAt": "2026-11-05T16:00:00.000Z",
    "endsAt": "2026-11-05T17:00:00.000Z",
    "program": { "title": "De Avondshow" }
  }
}
  • current is de uitzending van nu. next is de uitzending die daarna begint.
  • startTime en endTime zijn Nederlandse tijd. startsAt en endsAt zijn in UTC. Daarmee reken je makkelijk uit hoe lang iets nog duurt.
  • Bij program krijg je dezelfde gegevens als in de programmagids van de API. Dit voorbeeld is ingekort.

Goed om te weten#

  • Staat er nu niets in de gids? Dan is current leeg (null). Staat er de komende week niets meer? Dan is next ook leeg.
  • Haal de gegevens niet vaker op dan nodig. Eén keer per minuut is genoeg.

Verder lezen

Dit artikel linkt naar

Hier naartoe gelinkt vanuit

Kom je er niet uit? Vraag het aan de beheerder van Airly bij jouw omroep. Die kan zo nodig contact opnemen met ons.