Documentação Radio World Connect API

Introdução

Esta documentação tem como objetivo orientá-lo na exploração dos recursos oferecidos pelo Radio World Connect API, demonstrando passo a passo como realizar consultas. Dessa forma, você poderá aproveitar ao máximo todas as funcionalidades disponíveis

Infos

Esta API é completamente gratuita, de código aberto e pode ser utilizada por qualquer pessoa para:

  • Integrá-la em software, seja ele livre ou proprietário.
  • Possibilita a instalação em seu próprio servidor, permitindo espelhar todos os dados.
  • É possível realizar o processo de Fork para adaptações personalizadas.

Uso

Listar todas as Estações cadastradas:

GET: https://radio-world-connect.onrender.com/radio/all

Exemplo de Resposta:

{
    "content": [
      {
        "id": 1,
        "name": "Bahia FM 88.7",
        "urlRadio": "https://f13.fabricahost.com.br/radiobahiafm?f=1696021054N01HBHBQ1A1YF5PMVNYTV7K5B2D&tid=01HBC7DCRRSGZT1Q5YJRJKRYE5",
        "image": "",
        "longitude": -38.505876,
        "latitude": -12.990079
      },
      {
        "id": 2,
        "name": "107.5 Educadora FM",
        "urlRadio": "https://streaming.educadora.irdeb.ba.gov.br/stream-01",
        "image": "",
        "longitude": -38.523465,
        "latitude": -13.004749
      }
    ],
    "pageable": "INSTANCE",
    "totalElements": 2,
    "totalPages": 1,
    "last": true,
    "size": 2,
    "number": 0,
    "sort": {
      "empty": true,
      "sorted": false,
      "unsorted": true
    },
    "numberOfElements": 2,
    "first": true,
    "empty": false
  }

Informação e Paginação:

A API oferece informações sobre a paginação dos dados, para isso, basta adicionar os seguintes parâmetros na URL:

ChaveValor
size2
page1

Sendo 'size' a quantidade de itens que serão retornados e 'page' a página atual. Lembrando que a paginação começa em 0.

GET: https://radio-world-connect.onrender.com/radio/all?size=10&page=1

{
    "content": [
      {
        "id": 3,
        "name": "107.5 Educadora FM",
        "urlRadio": "https://streaming.educadora.irdeb.ba.gov.br/stream-01",
        "image": "",
        "longitude": -38.523465,
        "latitude": -13.004749
      },
      {
        "id": 4,
        "name": "GFM 90.1 MHz Salvador - BA",
        "urlRadio": "https://f58.fabricahost.com.br/radiogfm?f=1697830151N01HD79090HQXRYG0T6J4VEGEE6&tid=01HAKVGYX4Q1CBNTNENTFFK64N",
        "image": "",
        "longitude": -38.519118,
        "latitude": -12.99503
      }
    ],
    "pageable": {
      "pageNumber": 1,
      "pageSize": 2,
      "sort": {
        "empty": true,
        "sorted": false,
        "unsorted": true
      },
      "offset": 2,
      "paged": true,
      "unpaged": false
    },
    "last": false,
    "totalElements": 26,
    "totalPages": 13,
    "size": 2,
    "number": 1,
    "sort": {
      "empty": true,
      "sorted": false,
      "unsorted": true
    },
    "first": false,
    "numberOfElements": 2,
    "empty": false
  }

Filtrar Estações por nome:

Para filtrar as estações por nome, é suficiente adicionar os seguintes parâmetros à URL:

ChaveValor
nameBahia FM 88.7

GET: https://radio-world-connect.onrender.com/radio/filter?name=88

Lembrando que se nenhum parâmetro for fornecido, a lista irá incluir todas as estações disponíveis.

[
    {
      "id": 2,
      "name": "Bahia FM 88.7",
      "urlRadio": "https://f13.fabricahost.com.br/radiobahiafm?f=1696021054N01HBHBQ1A1YF5PMVNYTV7K5B2D&tid=01HBC7DCRRSGZT1Q5YJRJKRYE5",
      "image": "",
      "longitude": -38.505876,
      "latitude": -12.990079
    }
  ]

OBS:

Este projeto foi concebido com o propósito de estudo e pode conter eventuais imperfeições. Por favor, caso detecte algum problema, fique à vontade para atualizar a API, se possível. Estou também à disposição através do LinkedIn para qualquer tipo de assistência ou esclarecimento adicional. O objetivo principal desta iniciativa foi apoiar os apaixonados por rádios.