Boas conexões
começam por aqui.
Rádios brasileiras, metadados e transmissões individuais. Integre seu aplicativo ou leve seu catálogo para o XUI.
Você precisa de uma conta com plano ativo. Seus endereços estão disponíveis em Minha conta.
JSON APIPara sua aplicaçãoCatálogo paginado, metadados e links de transmissão.
M3U PLAYLISTPara seu reprodutorLista individual organizada em grupos por estado.
Autenticação
Copie o endereço da API na sua conta. Ele já contém a chave individual. Para integrações, você também pode enviar a chave pelo cabeçalho Authorization.
Bearer tokenAuthorization: Bearer SUA_CHAVE_INDIVIDUAL
Não coloque sua chave em código público. Renovar os links na sua conta invalida os endereços e as transmissões anteriores.
Listar rádios
O catálogo retorna somente rádios aprovadas e habilitadas. Cada item contém um link de transmissão individual, sem expor o endereço original da emissora.
curl 'https://radio.verdim.top/premium-api.php?action=catalog&page=1&size=100' \ -H 'Authorization: Bearer SUA_CHAVE_INDIVIDUAL'
| Parâmetro | Padrão | Descrição |
|---|---|---|
page | 1 | Página do catálogo. |
size | 100 | Quantidade por página, de 1 até 500. |
key | — | Chave individual, como alternativa ao cabeçalho Bearer. |
200 OK{
"ok": true,
"items": [{
"id": 123,
"name": "Exemplo FM",
"logo": "https://exemplo.com/logo.png",
"city": "São Paulo",
"state": "SP",
"genre": "Pop",
"stream_url": "https://radio.verdim.top/stream.php?..."
}],
"total": 1,
"page": 1,
"pages": 1
}Resposta ilustrativa. Os nomes, a quantidade e os endereços reais são retornados pelo seu catálogo.
O que você recebe.
| Campo | Conteúdo |
|---|---|
id | Identificador da rádio. |
name / logo | Nome e endereço da imagem. |
city / state | Cidade e sigla do estado, quando informadas. |
genre | Categoria da rádio. |
stream_url | Link individual para reprodução. |
Use pages para percorrer o catálogo e total para saber a quantidade de rádios disponíveis.
Do catálogo para o seu player.
Em Minha conta, clique em Copiar M3U e importe o endereço no XUI ou em um reprodutor compatível. Você também pode baixar o arquivo.
- Entre na sua contaConfirme que seu plano está ativo.
- Copie seu link M3UA lista é individual e separada por estado.
- Conecte ao reprodutorUse a importação de playlists do seu aplicativo.
O limite do plano conta as transmissões abertas no servidor Radio API. Se o XUI redistribui uma transmissão para várias pessoas, a autenticação dessas pessoas deve ser feita pelo próprio XUI.
Respostas e limites
| HTTP | O que significa |
|---|---|
200 | Consulta autorizada. |
401 | Chave ausente ou em formato inválido. |
402 | Plano vencido ou inativo. |
403 | Chave revogada, conta bloqueada ou acesso não permitido. |
404 | Rádio ou transmissão não disponível. |
429 | Limite de consultas ou de conexões atingido. |
A API permite até 120 consultas por minuto por conta. A atualização da M3U permite até 30 solicitações por minuto. O limite de transmissões simultâneas depende do plano.
Links já importados param de transmitir quando o plano vence. Após renovar a assinatura, eles voltam a funcionar. Se você renovar suas chaves, atualize também os links nas integrações.
Uma conexão encerrada em um reprodutor externo pode levar até 45 segundos para liberar a vaga. A disponibilidade das emissoras pode mudar entre uma verificação e a reprodução.