Painel Adm

API Radioin – Rádios GRPCOM v1

Aqui está o texto organizado, mantendo o conteúdo original e a estrutura lógica:

Rádios GRPCOM

Documentação – API Radioin

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

  • Método: POST
  • Endpoint: /login
2.2 Observações sobre o Corpo da Requisição
  • senha: Deve ser fornecida em formato MD5.
  • origem: Valores possíveis:
  • 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
{
  "username": "ouvinte@mundolivrefm.com.br",
  "password": "e10adc3949ba59abbe56e057f20f883e",
  "origem": "R98FM",
  "ip": ""
}

3. Resposta

{
  "error": false,
  "usuario": {
    "apiKey": "cOx/XH6HoffO9+s7g4IYIUAD05+Y2WrRXz+wAnm3rwg=",
    "nome": "Ouvinte de Teste"
  },
  "message": "Login efetuado com sucesso!"
}

Perfil do Ouvinte

1. Introdução

Permite recuperar informações detalhadas sobre um ouvinte.

2. Requisição

  • Método: GET
  • URL: /perfil
2.2 Parâmetros da Requisição
  • Headers:
    Authorization: c72d92360ce63bbaa2d308308d2dc88a (Obtido via apiKey no login)

3. 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

Permite alterar a senha da conta.

2. Requisição

  • Método: POST
  • URL: /novasenha
2.2 Parâmetros da Requisição
  • Headers:
    Authorization: c72d92360ce63bbaa2d308308d2dc88a
  • Body:
  {
    "oldPassword": "e10adc3949ba59abbe56e057f20f883e",
    "newPassword": "e10adc3949ba59abbe56e057f20f883e"
  }

3. Resposta

{
  "error": false,
  "message": "Nova senha cadastrada com sucesso!"
}

Recuperação de Senha

1. Introdução

Solicita recuperação de senha via e-mail.

2. Requisição

  • Método: POST
  • URL: /recuperasenha
2.2 Parâmetros da Requisição
{
  "username": "ouvinte@mundolivrefm.com.br",
  "origem": "R98FM"
}

3. Resposta

{
  "error": false,
  "message": "E-mail enviado! Siga as instruções contidas nesse e-mail para trocar a sua senha."
}

Consulta de CEP

1. Introdução

Obtém informações de um CEP.

2. Requisição

  • Método: GET
  • URL: /cep/consultar?cep=80810110

3. 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

1. Introdução

Permite cadastro de novos usuários.

2. Requisição

  • Método: POST
  • URL: /cadastro
2.2 Parâmetros da Requisição
  • senha: Formato MD5.
  • origem: Valores possíveis (mesmos da autenticação).
  • consentimentos: IDs de consentimento da Privacy Tools.
{
  "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
    },
    "...": "..."
  }
}

3. 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

1. Introdução

Permite atualizar informações do cadastro.

2. Requisição

  • Método: POST
  • URL: /perfil/atualizar
2.2 Parâmetros da Requisição
  • Headers: Authorization (obtido no login).
  • Body: Similar ao cadastro, com campos atualizáveis.

3. Resposta

{
  "error": false,
  "message": "Cadastro atualizado com sucesso!"
}

Registro de Interação

1. Introdução

Registra interações como pedidos musicais.

2. Requisição

  • Método: POST
  • URL: /interacao/registrar
2.2 Parâmetros da Requisição
  • acao: Ex: "pedido-musical".
  • PT_USER: Hash única (SHA-256).
{
  "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"
  }
}

3. Resposta

{
  "error": false,
  "message": "Interação registrada com sucesso!"
}

Histórico de Interações

1. Introdução

Obtém histórico de interações (ex: promoções).

2. Requisição

  • Método: GET
  • URL: /interacao/historico?origem=R98FM&offset=0&limit=10
2.2 Parâmetros da Requisição
  • Headers: Authorization.

3. 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"
    }
  ],
  "message": "Histórico retornado com sucesso!"
}

Inscrição em Promoção

1. Introdução

Realiza inscrições em promoções.

2. Requisição

  • Método: POST
  • URL: /promocao/inscricao
2.2 Parâmetros da Requisição
  • promocaoId: ID da promoção no Radioin.
  • resposta: Dados serializados.
{
  "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\"}",
  "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"
  }
}

3. Resposta

{
  "error": false,
  "message": "Inscrição realizada com sucesso!"
}

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 FM (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

Utilize a tag <audio> do HTML5 ou bibliotecas JavaScript.

Exibição de Dados da Música Atual

  • 98FM Curitiba:
    https://98fmcuritiba-static.s3.amazonaws.com/player/infoplayer.json
  • Mundo Livre FM (Curitiba):
    https://mundolivrefm-static.s3.amazonaws.com/player/infoplayer.json
  • Londrina:
    https://mundolivrefm-static.s3.amazonaws.com/londrina/player/infoplayer.json
  • Maringá:
    https://mundolivrefm-static.s3.amazonaws.com/maringa/player/infoplayer.json

Formato do JSON (Exemplo)

{
  "artista": "Luan Santana",
  "musica": "Coração Sigano",
  "imagem": "https://www.98fmcuritiba.com.br/wp-content/uploads/2017/01/13230336/capa_programcao_musical98.png",
  "programa": "Musical",
  "locutor": "Juliano Ribeiro"
}