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
- 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. - 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”: “”
}
- Resposta
{
“error”: false,
“usuario”: {
“apiKey”: “cOx/XH6HoffO9+s7g4IYIUAD05+Y2WrRXz+wAnm3rwg=”,
“nome”: “Ouvinte de Teste”
},
“message”: “Login efetuado com sucesso!”
}
}
Perfil do Ouvinte - Introdução
A API de perfil do ouvinte permite recuperar informações detalhadas sobre um ouvinte específico. - 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.) - 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
- Introdução
A API de Atualização de Senha permite que os usuários alterem a senha de sua conta. - 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”
} - Resposta
{
“error”: false,
“message”: “Nova senha cadastrada com sucesso!”
}
Recuperação de Senha - 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. - 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”
} - Resposta
{
“error”: false,
“message”: “E-mail enviado! Siga as instruções contidas nesse e-mail para
trocar a sua senha.”
}
Consulta de CEP - Introdução
A API de Consulta de CEP permite que os usuários obtenham informações sobre um determinado
CEP. - 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 - 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 - Introdução
A API de Cadastro de Novo Ouvinte permite que novos usuários se cadastrem na plataforma. - 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
}
}
}
- 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 - Introdução
A API de Atualização de Perfil do Ouvinte permite que os usuários atualizem as informações do seu
cadastro. - 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
}
}
}
- Resposta
{
“error”: false,
“message”: “Cadastro atualizado com sucesso!”
}
Registro de Interação - 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. - 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”
}
}
- Resposta
{
“error”: false,
“message”: “Interação registrada com sucesso!”
}
Histórico de Interações - 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. - 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
} - 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 - Introdução
A API de Inscrição em Promoção permite que os usuários realizem inscrições em promoções da
rádio. - 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”
}
} - 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