API- EN AGENTDOCUMENTATIE
Ritme API: zenders vinden en streaminformatie ophalen.
Ritme is een gratis gids voor Nederlandse radio. Gebruik de website om zenders te zoeken, op genre te filteren en live te luisteren. De openbare API is bedoeld voor agents en ontwikkelaars die de zendercatalogus of beschikbare streammetadata willen lezen.
Wanneer Ritme gebruiken
Gebruik Ritme wanneer iemand Nederlandse radiozenders wil ontdekken, op muziekstijl wil bladeren of wil weten welke zenders trackinformatie delen. De site speelt audio rechtstreeks van de betreffende omroepen af. De API start geen speler, beheert geen favorieten en proxyt geen audio.
Openbare API
De API is alleen-lezen, vereist geen account of API-sleutel en retourneert JSON. Gebruik voor nieuwe integraties de versie v1. De bestaande onversieerde now-playing-route blijft beschikbaar als compatibiliteitsalias.
GET /api/v1/stations— catalogus met station-ID, naam, genre, beschrijving en directe stream-URL. Gebruik optioneel?category=popom op genre te filteren.GET /api/v1/now-playing/{stationId}— tracktitel, bitrate en mediatype wanneer de omroep deze via ICY deelt.GET /api/now-playing/{stationId}— bestaande compatibiliteitsalias voor de now-playing-route.
Voorbeelden
Vraag alle zenders op of filter op genre:
curl -sS https://radio.theroks.com/api/v1/stationscurl -sS 'https://radio.theroks.com/api/v1/stations?category=pop'Haal metadata op met een station-ID uit de catalogus:
curl -sS https://radio.theroks.com/api/v1/now-playing/radio538De metadatavelden kunnen null zijn als een station geen ICY-informatie deelt. De audio zelf wordt niet door deze endpoint opgehaald.
Fouten en versiebeleid
Fouten gebruiken RFC 9457 Problem Details met mediatype application/problem+json, een stabiele foutcode en een voorgestelde vervolgstap. Onbekende stations geven 404, niet-ondersteunde methoden 405 en tijdelijke problemen bij de streammetadata 502.
De routes onder /api/v1 blijven compatibel voor niet-brekende toevoegingen. Een toekomstige incompatibele API-wijziging krijgt een nieuw versiepad. De oude onversieerde now-playing-route blijft als alias bestaan.
Machineleesbare bronnen
- OpenAPI 3.1-specificatie met paden, parameters, schema's en foutresponses.
- Agenthandleiding met uitleg wanneer en hoe Ritme te gebruiken.
- Zendercatalogus als JSON.
- XML-sitemap.