API-codes | Panel DJ portal - Audiostreamen FAQ

Bij API-codes vind je de luisterlinks en API-koppelingen voor jouw station. Hiermee kan een website, app of eigen player je stream afspelen en informatie tonen, zoals het huidige nummer, de cover en het aantal luisteraars.

Waar vind je API-codes?

Open het DJ portal vanuit Console en klik links op API-codes. De pagina heet API en begint met API-koppelingen. Kies rechtsboven de juiste stream bij Mount selecteren. Controleer de stationsnaam boven de links voordat je iets kopieert.

De onderdelen hieronder staan in dezelfde volgorde als op de pagina. De screenshots tonen Audiostreamen Demo. Gebruik voor je eigen station altijd de links uit jouw eigen DJ portal.

Wat is een API-link?

Een API-link is een internetadres waarmee een website, app of player informatie kan ophalen. Zo kan je website automatisch laten zien welk nummer er speelt. Je websitebouwer verwerkt die informatie in jouw website of app.

De luisterlinks zijn bedoeld om de audio af te spelen. De overige koppelingen leveren informatie over je station of stream.

Luisterlinks

Hier staan de directe HTTPS- en HTTP-luisterlink van de geselecteerde stream.

Kopieer HTTPS: kopieer de beveiligde luisterlink voor je website, app of player. Gebruik op een HTTPS-website ook de HTTPS-luisterlink.
Open HTTPS: open de beveiligde luisterlink in je browser.
Kopieer HTTP: kopieer de HTTP-luisterlink wanneer een toepassing specifiek deze versie nodig heeft.
Open HTTP: open de HTTP-luisterlink in je browser.

Luisterlinks met HTTPS, HTTP en de bijbehorende kopieer- en openknoppen — Kopieer de luisterlink van de geselecteerde stream. Dit voorbeeld gebruikt Audiostreamen Demo.

Je streams

Met deze API-link kan een website of app zien welke streams bij jouw station horen. Klik op Kopieer naast het adres om de volledige link over te nemen.

Onder Voorbeeld staat een opdracht die begint met curl. Daarmee kan je websitebouwer de koppeling opvragen. De tweede knop Kopieer kopieert deze volledige voorbeeldopdracht. Je hoeft die opdracht zelf niet uit te voeren om de link te kunnen gebruiken.

Je streams met de API-link en het curl-voorbeeld, elk met een knop Kopieer — De bovenste knop kopieert de API-link; de onderste knop kopieert de voorbeeldopdracht.

Aantal luisteraars

Deze link geeft het actuele aantal luisteraars van de geselecteerde stream door aan je website of app. Gebruik Kopieer om het adres over te nemen of Open om het antwoord te bekijken.

Het antwoord is JSON, bijvoorbeeld {"listeners":12}. Dat betekent dat de meting twaalf luisteraars aangeeft; het getal in de toelichting op de pagina is een voorbeeld.

Laat je websitebouwer de link maximaal eenmaal per 30 seconden opvragen. Zonder verse meting is listeners tijdelijk null en geeft de API HTTP 503 terug. Dat betekent dat er geen actueel aantal beschikbaar is, niet dat er nul luisteraars zijn.

Aantal luisteraars met de Metrics-link, Kopieer, Open en uitleg over JSON en ontbrekende metingen — De luisteraarskoppeling bevat ook de opvraaglimiet en de betekenis van een ontbrekende meting.

Wat nu speelt

Gebruik deze koppeling om het huidige nummer, de cover en DJ-informatie te tonen. In de tabel zie je:

Station: de naam van het radiostation.
Streamnaam: de stream waarop de informatie betrekking heeft.
Link: het API-adres voor die stream. Met Kopieer neem je de hele link over.

Welke gegevens je ermee kunt tonen, staat verderop bij Wat kun je tonen?

Wat nu speelt met de kolommen Station, Streamnaam en Link — Kopieer de link bij de stream waarvan je de huidige titel, cover en DJ-informatie wilt tonen.

DAB+ metadata

Geef deze link aan je DAB+ provider voor de artiest, titel en afbeelding van je eigen stream. De afbeelding wordt aangeboden als baseline JPEG van 320 × 240 pixels.

Onder de stationsnaam staat het bijbehorende adres. Klik op Kopieer om de link door te geven of op Open om het antwoord te bekijken. Dit is een koppeling voor de metadata; de audio luister je via de luisterlinks bovenaan.

DAB+ metadata met uitleg over artiest, titel en de afbeelding van 320 bij 240 pixels — De DAB+ koppeling levert metadata voor je provider, inclusief het genoemde afbeeldingsformaat.

Laatst gespeeld

Met deze API-link kan je website of app recent gespeelde nummers tonen. In de tabel staan het Station met de streamnaam en de bijbehorende Link. Gebruik Kopieer om het adres over te nemen.

Is je stream net gestart, dan kan hier tijdelijk alleen het huidige nummer staan. Wil je een kant-en-klare weergave op je website plaatsen? Bekijk dan de uitleg bij Laatst gespeeld onder Players instellen.

Laatst gespeeld met station, API-link, kopieerknop en de melding voor een pas gestarte stream — Deze API-link levert de recente afspeelgeschiedenis van je stream.

Welke informatie kan een website tonen?

Het onderdeel Wat kun je tonen? legt uit welke informatie de link bij Wat nu speelt kan leveren:

Onderdeel	Betekenis
Artiest	De naam van de artiest die nu te horen is.
Titel	De titel van het nummer dat nu speelt.
Nu op de radio	De volledige tekst die vanuit de studio wordt doorgestuurd.
Afbeelding	De cover van het nummer, of wanneer die ontbreekt een DJ-, bericht- of stationfoto.
DJ live	Of er een DJ live is, inclusief de naam en foto van de DJ.
Starttijd	Het moment waarop het huidige nummer is gestart, bijvoorbeeld voor een voortgangsbalk.

Klap Voor je websitebouwer open om de technische veldnamen te bekijken. Geef deze samen met jouw API-link door aan degene die je website, app of player bouwt:

Veldnaam	Informatie
`current.artist`	Artiest
`current.title`	Titel
`current.track`	Volledige regel of titel uit de studio
`current.art_100`	Cover, DJ-, bericht- of stationfoto
`current.dj_active`	DJ-status
`current.dj_name`	Naam van de DJ
`current.dj_picture`	Foto van de DJ
`current.track_start`	Starttijd van het nummer

Wat kun je tonen met alle zes onderdelen en de uitgeklapte veldnamen voor de websitebouwer — Wat kun je tonen?, met Voor je websitebouwer uitgeklapt.

Moet ik dit zelf op mijn website plaatsen?

Je websitebouwer kan de API-links voor je verwerken. Wil je dit door Audiostreamen laten plaatsen? Klik bij Wat kun je tonen? op Neem contact op om de mogelijkheden met support te bespreken. Deze knop opent een e-mail aan support@audiostreamen.com.