Para desenvolvedores

Referência da API.

Tudo que você precisa para integrar usando a base pública https://mtabeats.online.

Começar

Use sempre o endereço público abaixo como base das requisições:

https://mtabeats.online

As rotas documentadas nesta página são as rotas recomendadas para integrações públicas. Detalhes de infraestrutura e rotas administrativas não fazem parte da documentação pública.

GET/music/search

Pesquisar músicas

Pesquisa músicas e retorna uma lista de resultados que pode ser usada para montar sua interface.

Parâmetro	Tipo	Uso
q	string	Texto da pesquisa. Obrigatório.
limit	number	Quantidade desejada de resultados. Opcional.

curl "https://mtabeats.online/music/search?q=Matuê%20333&limit=5"

Campos úteis do retorno incluem id, title, author, duration, thumbnail, views e playUrl.

GET/music/play/:id

Reproduzir música

Use o ID retornado pela pesquisa para iniciar a reprodução. O cliente deve permitir redirecionamentos HTTP.

https://mtabeats.online/music/play/l4EGT-Za10c

Em HTML, você pode usar essa URL diretamente em um elemento <audio>.

GET/music/info/:id

Informações da música

Consulta os metadados disponíveis para um ID específico.

curl "https://mtabeats.online/music/info/l4EGT-Za10c"

GET/music/thumbnail/:id

Thumbnail

Obtém a imagem associada à música. Pode ser usada diretamente no atributo src de uma imagem.

https://mtabeats.online/music/thumbnail/l4EGT-Za10c

GET/music/link/:id

Link de reprodução

Retorna as informações de link disponíveis para o ID informado.

curl "https://mtabeats.online/music/link/l4EGT-Za10c"

Exemplos rápidos

JavaScript

const response = await fetch(
  "https://mtabeats.online/music/search?q=musica&limit=5"
);

if (!response.ok) throw new Error("Falha na API");
const musicas = await response.json();

for (const musica of musicas) {
  console.log(musica.id, musica.title, musica.playUrl);
}

Player HTML

<audio
  controls
  src="https://mtabeats.online/music/play/l4EGT-Za10c">
</audio>

Lua

local baseUrl = "https://mtabeats.online"
local musicId = "l4EGT-Za10c"
local playUrl = baseUrl .. "/music/play/" .. musicId

Tratamento de erros

Considere sempre o status HTTP antes de usar a resposta. Como regra geral:

Status	Significado para o consumidor
200	Requisição concluída.
3xx	Redirecionamento; permita redirects no cliente quando necessário.
400	Parâmetro ou ID inválido.
404	Recurso não encontrado.
429	Muitas requisições; aguarde antes de tentar novamente.
5xx	Falha temporária do serviço; tente novamente depois.

Não dependa do texto exato de uma mensagem de erro. Use o status HTTP e trate respostas JSON de forma defensiva.