Rádios GRPCOM Documentação – API Radioin v2

Versão 1.0.0 – 15/12/2023
Dados de acesso
URL base (produção)
http://radioinapi.grpcom.com.br:9595/v1
URL base (homologação)
Ainda não disponível.
Autenticação do Ouvinte

  1. Introdução
    A API de autenticação da Radioin permite que usuários realizem login e obtenham uma chave de
    API para acessar recursos restritos.
  2. Requisição
    2.1 Detalhes da Requisição
    Método: POST
    Endpoint: /login
    2.2 Observações sobre o Corpo da Requisição
    Antes de realizar a requisição, observe as seguintes considerações:
    2.2.1 senha
    A senha deve ser fornecida em formato md5.
    2.2.2 origem
    O campo “origem” pode ter os seguintes valores:
  • R98FM (98FM Curitiba)
  • RMLFM (Mundo Livre FM Curitiba)
  • RMLMGA (Mundo Livre FM Maringá)
  • RMLLON (Mundo Livre FM Londrina)
    2.3 Parâmetros da Requisição
    Body (json):
    {
    “username”: “ouvinte@mundolivrefm.com.br”,
    “password”: “e10adc3949ba59abbe56e057f20f883e”,
    “origem”: “R98FM”,
    “ip”: “”
    }
  1. Resposta
    {
    “error”: false,
    “usuario”: {
    “apiKey”: “cOx/XH6HoffO9+s7g4IYIUAD05+Y2WrRXz+wAnm3rwg=”,
    “nome”: “Ouvinte de Teste”
    },
    “message”: “Login efetuado com sucesso!”
    }
    }
    Perfil do Ouvinte
  2. Introdução
    A API de perfil do ouvinte permite recuperar informações detalhadas sobre um ouvinte específico.
  3. Requisição
    2.1 Detalhes da Requisição
    Método: GET
    URL: /perfil
    2.2 Parâmetros da Requisição
    Headers:
    Authorization: c72d92360ce63bbaa2d308308d2dc88a
    (Nota: Este código de autorização é gerado durante o processo de login e é obtido por meio da
    apiKey. Consulte a seção de Autenticação para mais informações.)
  4. Resposta
    {
    “error”: false,
    “ouvinte”: {
    “id”: 131473,
    “nome”: “Ouvinte de Teste”,
    “username”: “ouvinte@mundolivrefm.com.br”,
    “cpf”: “08925203022”,
    “dataNascimento”: “08/04/1955”,
    “email”: null,
    “ativo”: true,
    “endereco”: {
    “cep”: “73360401”,
    “logradouro”: “QUADRA 4 CONJUNTO A”,
    “numero”: “345435”,
    “complemento”: “St. Res. Leste | Buritís I Q 4 a 40 – Planaltina, Brasília
  • DF, 73360-401″,
    “bairro”: “ST RES LESTE (PLANALTINA)”,
    “cidade”: “BRASILIA”,
    “estado”: “DF”
    },
    “consentimentos”: {
    “a837d1f38828cb031eac7575cc8c3ccdb9d3a8e97bbf7ca5739203219a904835”: false,
    “1594c90cae0a4d043c5c7534153dfb16f20a4c61841add8da4f0a411581781e3”: true,
    “fbf08e02ec15f35a9bc065651629a32845054204622c697660a3d1d1e9bf9b50”: true,
    “90652c1e867e0801ae60c53b78cc22e50b775efa5ef838ef723b0e2c32dd7f6d”: false
    }
    }
    }
    Atualização de Senha
  1. Introdução
    A API de Atualização de Senha permite que os usuários alterem a senha de sua conta.
  2. Requisição
    2.1 Detalhes da Requisição
    Método: POST
    URL: /novasenha
    2.2 Parâmetros da Requisição
    Headers:
    Authorization: c72d92360ce63bbaa2d308308d2dc88a
    (Nota: Este código de autorização é gerado durante o processo de login e é obtido por meio da
    apiKey. Consulte a seção de Autenticação para mais informações.)
    Body (json):
    {
    “oldPassword”: “e10adc3949ba59abbe56e057f20f883e”,
    “newPassword”: “e10adc3949ba59abbe56e057f20f883e”
    }
  3. Resposta
    {
    “error”: false,
    “message”: “Nova senha cadastrada com sucesso!”
    }
    Recuperação de Senha
  4. Introdução
    A API de Recuperação de Senha permite que os usuários solicitem a recuperação de sua senha por
    meio do envio de um e-mail com instruções.
  5. Requisição
    2.1 Detalhes da Requisição
    Método: POST
    URL: /recuperasenha
    2.2 Parâmetros da Requisição
    Body (json):
    {
    “username”: “ouvinte@mundolivrefm.com.br”,
    “origem”: “R98FM”
    }
  6. Resposta
    {
    “error”: false,
    “message”: “E-mail enviado! Siga as instruções contidas nesse e-mail para
    trocar a sua senha.”
    }
    Consulta de CEP
  7. Introdução
    A API de Consulta de CEP permite que os usuários obtenham informações sobre um determinado
    CEP.
  8. Requisição
    2.1 Detalhes da Requisição
    Método: GET
    URL: /cep/consultar?cep=80810110
    2.2 Parâmetros da Requisição
    Parâmetros na URL:
    cep=80810110
  9. Resposta
    {
    “error”: false,
    “logradouro”: {
    “id”: 408067,
    “tipoLogradouro”: “R”,
    “logradouro”: “JULIO PERNETA”,
    “bairro”: “MERCES”,
    “cidadeId”: 6015,
    “cidade”: “CURITIBA”,
    “estado”: “PR”,
    “cep”: “80810110”
    },
    “message”: “Cadastro efetuado com sucesso!”
    }
    Cadastro de Novo Ouvinte
  10. Introdução
    A API de Cadastro de Novo Ouvinte permite que novos usuários se cadastrem na plataforma.
  11. Requisição
    2.1 Detalhes da Requisição
    Método: POST
    URL: /cadastro
    2.2 Parâmetros da Requisição
    Antes de realizar a requisição, observe as seguintes considerações:
    2.2.1 senha
    A senha deve ser fornecida em formato md5.
    2.2.2 origem
    O campo “origem” pode ter os seguintes valores:
  • R98FM (98FM Curitiba)
  • RMLFM (Mundo Livre FM Curitiba)
  • RMLMGA (Mundo Livre FM Maringá)
  • RMLLON (Mundo Livre FM Londrina)
    2.2.3 endereco
    Enviar todos os dados do endereço, preenchidos pelo usuário, quando o CEP retornar um
    logradouro vazio
    2.2.4 consentimentos
    Enviar o ID do consentimento da Privacy Tools e o aceite/rejeição do usuário (este campo passará
    por ajustes e simplificação)
    Body (json):
    {
    “username”: “ouvinte_novo@mundolivrefm.com.br”,
    “password”: “e10adc3949ba59abbe56e057f20f883e”,
    “nome”: “Novo Ouvinte”,
    “cpf”: “70273308300”,
    “dataNascimento”: “05/03/2001”,
    “cep”: “80810110”,
    “logradouro”: “JULIO PERNETA”,
    “bairro”: “MERCES”,
    “numero”: “300”,
    “complemento”: “Sem complemento”,
    “origem”: “R98FM”,
    “link”: “https://98fmcuritiba.com.br”,
    “consentimentos”: {
    “a837d1f38828cb031eac7575cc8c3ccdb9d3a8e97bbf7ca5739203219a904835”: {
    “title”: “Pedido Musical – Política de Privacidade”,
    “required”: “N”,
    “status”: “A”,
    “value”: false,
    “retention”: 120
    },
    “1594c90cae0a4d043c5c7534153dfb16f20a4c61841add8da4f0a411581781e3”: {
    “title”: “Políticas e Termos de Uso”,
    “required”: “S”,
    “status”: “A”,
    “value”: true,
    “retention”: 700
    },
    “fbf08e02ec15f35a9bc065651629a32845054204622c697660a3d1d1e9bf9b50”: {
    “title”: “Recebimento de e-mails sobre promoções, pesquisas, informações
    sobre a rádio, etc.”,
    “required”: “N”,
    “status”: “A”,
    “value”: false,
    “retention”: 12
    },
    “90652c1e867e0801ae60c53b78cc22e50b775efa5ef838ef723b0e2c32dd7f6d”: {
    “title”: “Novo consentimento de Cadastro”,
    “required”: “N”,
    “status”: “A”,
    “value”: false,
    “retention”: null
    }
    }
    }
  1. Resposta
    {
    “error”: false,
    “message”: “Cadastro efetuado com sucesso!”,
    “obs”: “Aguarde o recebimento de um e-mail para confirmação e ativação do seu
    cadastro!”
    }
    Atualização de Perfil do Ouvinte
  2. Introdução
    A API de Atualização de Perfil do Ouvinte permite que os usuários atualizem as informações do seu
    cadastro.
  3. Requisição
    2.1 Detalhes da Requisição
    Método: POST
    URL: /perfil/atualizar
    2.2 Parâmetros da Requisição
    Antes de realizar a requisição, observe as seguintes considerações:
    2.2.1 origem
    O campo “origem” pode ter os seguintes valores:
  • R98FM (98FM Curitiba)
  • RMLFM (Mundo Livre FM Curitiba)
  • RMLMGA (Mundo Livre FM Maringá)
  • RMLLON (Mundo Livre FM Londrina)
    2.2.2 endereco
    Enviar todos os dados do endereço, preenchidos pelo usuário, quando o CEP retornar um
    logradouro vazio
    2.2.3 consentimentos
    Enviar o ID do consentimento da Privacy Tools e o aceite/rejeição do usuário (este campo passará
    por ajustes e simplificação)
    Headers:
    Authorization: c72d92360ce63bbaa2d308308d2dc88a
    (Nota: Este código de autorização é gerado durante o processo de login e é obtido por meio da
    apiKey. Consulte a seção de Autenticação para mais informações.)
    Body (json):
    {
    “username”: “ouvinte_novo@mundolivrefm.com.br”,
    “nome”: “Novo Ouvinte Atualizado”,
    “cpf”: “70273308300”,
    “dataNascimento”: “05/03/2001”,
    “cep”: “80810000”,
    “logradouro”: “MANOEL RIBAS”,
    “bairro”: “MERCES”,
    “numero”: “314”,
    “complemento”: “Sem complemento”,
    “consentimentos”: {
    “a837d1f38828cb031eac7575cc8c3ccdb9d3a8e97bbf7ca5739203219a904835”: {
    “title”: “Pedido Musical – Política de Privacidade”,
    “required”: “N”,
    “status”: “A”,
    “value”: false,
    “retention”: 120
    },
    “1594c90cae0a4d043c5c7534153dfb16f20a4c61841add8da4f0a411581781e3”: {
    “title”: “Políticas e Termos de Uso”,
    “required”: “S”,
    “status”: “A”,
    “value”: true,
    “retention”: 700
    },
    “fbf08e02ec15f35a9bc065651629a32845054204622c697660a3d1d1e9bf9b50”: {
    “title”: “Recebimento de e-mails sobre promoções, pesquisas, informações
    sobre a rádio, etc.”,
    “required”: “N”,
    “status”: “A”,
    “value”: false,
    “retention”: 12
    },
    “90652c1e867e0801ae60c53b78cc22e50b775efa5ef838ef723b0e2c32dd7f6d”: {
    “title”: “Novo consentimento de Cadastro”,
    “required”: “N”,
    “status”: “A”,
    “value”: false,
    “retention”: null
    }
    }
    }
  1. Resposta
    {
    “error”: false,
    “message”: “Cadastro atualizado com sucesso!”
    }
    Registro de Interação
  2. Introdução
    A API de Registro de Interação permite que os usuários registrem diferentes tipos de interações,
    como pedidos musicais, na plataforma.
  3. Requisição
    2.1 Detalhes da Requisição
    Método: POST
    URL: /interacao/registrar
    2.2 Parâmetros da Requisição
    Antes de realizar a requisição, observe as seguintes considerações:
    2.2.1 acao
    Para registro de Pedido Musical enviar “pedido-musical”
    2.2.2 origem
    O campo “origem” pode ter os seguintes valores:
  • R98FM (98FM Curitiba)
  • RMLFM (Mundo Livre FM Curitiba)
  • RMLMGA (Mundo Livre FM Maringá)
  • RMLLON (Mundo Livre FM Londrina)
    2.2.3 PT_USER
    Criar uma hash única para incluir na requisição o identificador do pedido musical na Privacy Tools
    e utilizar sha256 para sua geração.
    Body:
    {
    “acao”: “pedido-musical”,
    “origem”: “R98FM”,
    “link”: “https://98fmcuritiba.com.br”,
    “assunto”: “Pedido Musical – 98FM”,
    “conteudo”: {
    “NOME”: “NOME DO OUVINTE”,
    “ARTISTA”: “SNOW PATROL”,
    “MUSICA”: “CHASING CARS”,
    “CIDADE”: “ADRIANÓPOLIS”,
    “PT_USER”:
    “0c4de185ce04126dae4dc2d05b972ec85de7e748ae171862bb20ca7ba2be02b8”
    }
    }
  1. Resposta
    {
    “error”: false,
    “message”: “Interação registrada com sucesso!”
    }
    Histórico de Interações
  2. Introdução
    A API de Histórico de Interações permite que os usuários obtenham o histórico de interações, como
    inscrições em promoções, na plataforma.
  3. Requisição
    2.1 Detalhes da Requisição
    Método: GET
    URL: /interacao/historico?origem=R98FM&offset=0&limit=10
    2.2 Parâmetros da Requisição
    Headers:
    Authorization: c72d92360ce63bbaa2d308308d2dc88a
    (Nota: Este código de autorização é gerado durante o processo de login e é obtido por meio da
    apiKey. Consulte a seção de Autenticação para mais informações.)
    Parâmetros na URL:
    origem=R98FM
    offset=0
    limit=10
    Body (json):
    {
    “origem”: “R98FM”,
    “offset”: 0,
    “limit”: 10
    }
  4. Resposta
    {
    “error”: false,
    “historico”: [
    {
    “id”: 526061,
    “tipo”: “Inscrição Promoção”,
    “slug”: “inscricao-promocao”,
    “descricao”: “Se inscreveu na promoção ‘STOP 98FM (2021)’”,
    “data”: “2021-06-26 16:01”
    },
    {
    “id”: 526041,
    “tipo”: “Inscrição Promoção”,
    “slug”: “inscricao-promocao”,
    “descricao”: “Se inscreveu na promoção ‘Supergame 98′”,
    “data”: “2021-06-25 18:50”
    }
    // Outros registros do histórico…
    ],
    “origem”: “R98FM”,
    “offset”: 10,
    “message”: “Histórico retornado com sucesso!”
    }
    Inscrição em Promoção
  5. Introdução
    A API de Inscrição em Promoção permite que os usuários realizem inscrições em promoções da
    rádio.
  6. Requisição
    2.1 Detalhes da Requisição
    Método: POST
    URL: /promocao/inscricao
    2.2 Parâmetros da Requisição
    Antes de realizar a requisição, observe as seguintes considerações:
    2.2.1 promocaoId
    Id da promoção dentro do Radioin.
    2.2.2 resposta
    A resposta deve ser enviada de forma serializada.
    2.2.3 acao
    Enviar “inscricao-promocao” para indicar que é uma inscrição.
    2.2.4 link
    Link da página da promoção cadastrada no site.
    2.2.5 assunto
    Enviar “Inscrição”.
    2.2.6 conteudo > ID_WP
    Id do post da promoção dentro do WordPress.
    2.2.7 conteudo > PROMOCAO
    Título do post da promoção dentro do WordPress.
    2.2.8 consentimentos
    Id do consentimento da Privacy Tools e aceite/rejeição (1/0) do usuário.
    Headers:
    Authorization: c72d92360ce63bbaa2d308308d2dc88a
    (Nota: Este código de autorização é gerado durante o processo de login e é obtido por meio da
    apiKey. Consulte a seção de Autenticação para mais informações.)
    Body (json):
    {
    “promocaoId”: “1331”,
    “resposta”: “a:5:{s:16:\”endereco-ouvinte\”;s:56:\”R. Tocantins, 480 –
    Argentina, Criciúma – SC, 88813-540\”;s:14:\”bairro-ouvinte\”;s:17:\”Perpétuo
    Socorro\”;s:16:\”telefone-ouvinte\”;s:10:\”4199889966\”;s:13:\”musicapedida\”;s:20:\”Charlie Brown Junior\”;s:12:\”cantor-banda\”;s:18:\”Vou te levar
    daqui\”}”,
    “pergunta”: “”,
    “acao”: “inscricao-promocao”,
    “origem”: “R98FM”,
    “link”: “https://98fmcuritiba.com.br/promocao/sabado-premiado-2023/”,
    “assunto”: “Inscrição”,
    “conteudo”: {
    “ID_WP”: “192866”,
    “PROMOCAO”: “Sábado Premiado 2023”
    },
    “consentimentos”: {
    “34e179e8421475952ce2be53868275f6b9af06a45548e1516d5b5e8772c84d4d”: “1”
    }
    }
  7. Resposta
    {
    “error”: false,
    “message”: “Inscrição realizada com sucesso!”
    }

Rádios GRPCOM
Documentação – Streaming

Versão 1.0.0 – 15/12/2023
Links do Streaming
98FM Curitiba
https://playerservices.streamtheworld.com/api/livestream-redirect/98FM_CWBAAC.aac
Mundo Livre
Curitiba
https://playerservices.streamtheworld.com/api/livestream-redirect/
MUNDOLIVRE_CWBAAC_64.aac
Londrina
https://rrdns-continental.webnow.com.br/mllondrina.mp3
Maringá
https://rrdns-continental.webnow.com.br/cultura.aac
Desenvolvimento do Player
Para tocar os links descritos acima basta construir o player utilizando a tag