Service Information

GET /radiodns/spi/3.1/SI.xml

Gets a Radio DNS Service Information document. If a valid API key is supplied, the document will also include stream URLs.

A successful request will receive a valid Service Information document. It consists of a service provider followed by a number of services.

Each service describes service metadata such as short, medium and long names; short and long descriptions; logos at various sizes; associated genres; keywords; links; and bearers.

Responses

200 OK: The request was successful

403 Forbidden: The supplied API key is invalid

Example request:

GET /radiodns/spi/3.1/SI.xml HTTP/1.1

Example response:

HTTP/1.1 200 OK
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<serviceInformation>
    <services>
        <serviceProvider>
            ...
        </serviceProvider>
        <service>
            <shortName>BBC 1Xtr</shortName>
            <mediumName>BBC Radio 1Xtra</mediumName>
            <longName>BBC Radio 1Xtra</longName>
            <mediaDescription>
                <shortDescription>Amplifying black music and culture</shortDescription>
            </mediaDescription>
            <mediaDescription>
                <longDescription>BBC Radio 1Xtra - Hip Hop, RnB, Grime, Dancehall, Afrobeat, Drum n Bass - championing UK and international underground diverse music</longDescription>
            </mediaDescription>
            <mediaDescription>
                <multimedia type="logo_colour_square" url="http://radiospi.api.bbci.co.uk/logos/bbc_1xtra/32x32.png"/>
            </mediaDescription>
            ...
            <genre href="urn:tva:metadata:cs:ContentCS:2002:3.6.5.2" type="main">R and B</genre>
            ...
            <keywords>1extra,chart,playlist,live lounge,hip hop,rnb,drum and bass,dnb,dancehall,reggae,garage,dubstep,grime,UK garage,1 extra,one extra,one xtra</keywords>
            <link description="Homepage" mimeValue="text/html" uri="https://www.bbc.co.uk/1xtra"/>
            <bearer cost="20" id="dab:ce1.ce15.c22a.0" mimeValue="audio/mpeg"/>
            ...
        </service>
        <service>
            ...
        </service>
        ...
    </services>
</serviceInformation>