Service Information
===================

.. http: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 <https://www.etsi.org/deliver/etsi_ts/102800_102899/102818/03.05.01_60/ts_102818v030501p.pdf>`_. 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**:

        .. sourcecode:: http

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

        **Example response**:

        .. sourcecode:: http

            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>