Cifralize | Documentação

Embed - Incorporar Cifras

Você pode incorporar qualquer cifra do Cifralize em outro site usando a tag <iframe>. Basta utilizar a URL do embed com o artista e a música desejados.

// Formato básico
<iframe src="https://cifralize.com.br/embed/artista/musica"
width="100%" height="400" frameborder="0"></iframe>

Parâmetros do Embed

Personalize a exibição das cifras utilizando parâmetros na URL:

Parâmetro	Tipo	Descrição	Exemplo
`transpose`	Integer	Número de semitons para transpor (positivo sobe, negativo desce)	`?transpose=2`
`layout`	String	Tema visual: `light` ou `dark`	`?layout=dark`
`show_title`	Boolean	Exibir ou ocultar o título da música	`?show_title=false`
`show_artist`	Boolean	Exibir ou ocultar o nome do artista	`?show_artist=false`

Exemplos de Uso

Transpor 2 semitons com tema escuro:

Sem título e sem artista:

Endpoints da API

Endpoints públicos disponíveis para integração:

GET /embed/:artista/:musica

Retorna a cifra formatada para incorporação via iframe

GET /search?q=:query&format=json

Busca músicas, artistas e playlists. Retorna resultados em JSON

GET /autocomplete?q=:query

Autocompletar para campo de busca. Retorna sugestões em JSON

GET /:artista/:musica

Página pública da cifra com transposição via parâmetro tom

Observações

Todos os endpoints públicos não requerem autenticação
O embed é responsivo e se adapta ao tamanho do container
O parâmetro transpose aceita valores de -11 a 11
Use layout=dark para ambientes com pouca luz
As URLs de artistas e músicas usam slugs (ex: artista-nome)