API
API gratis para webmasters
Nuestra API permite a los webmasters consultar fácilmente nuestra base de datos de acordes y publicar nuestros diagramas (y más) en su sitio web. Todo lo que necesitas es una clave de API válida (+ un enlace a https://ukulele-chords.com ), ¡obtén una gratis!
¿Cómo funciona?
Aquí está cómo acceder a los datos de ukulele-chords.com
- API URL : ukulele-chords.com/get?
- Parameters : "ak" (tu clave API), "r" (nota raíz de un acorde), "typ" (tipo de acorde), "sk" (acorde de barra) y "uke" (Afinación)
- Todos los parámetros son obligatorios excepto "sk" y "uke".
res la nota fundamental del acorde. Se puede ajustar para "A", "Bb", "B" , "C", "Db", "D", "Eb", "E", "F", "Gb", "G" y "Ab"types el tipo de acorde. Se puede ajustar para "mayor", "m", "aug", "dim", "7", "m7", "maj7", "m7b5", "sus2", "sus4", "7sus4", "9", "11", "13", "6", "m6", "add9", "m9", "5", "dim7", "m13", "7sus2", "mMaj7", "m11" y "maj9".skes la nota fundamental alterada de un acorde de barra. Opcional. (Valores aceptados: ver "r")ukees la afinación. Puede ajustarse como "soprano" (valor predeterminado), "barítono" (sintonía G), "Afinación D" o "clave". Opcional.- Ejemplo: Para consultar información de acordes de Csus2, llama a nuestra API:"http://ukulele-chords.com/get?ak=your_api_key&r=C&typ=sus2"
Salida (formato XML)
chord_nameEl nombre del acorde ...chord_diffDificultad (en 10)chord_diagDiagrama de acordes (200x250)chord_diag_miniDiagrama de acordes (90x130)chord_photoImagen (da un mensaje de "falso" si no tenemos la foto)chord_urlEntra al enlace a Ukulele-chords.com para obtener más información
Da un mensaje de falso si no se encuentra el acorde solicitado.
Ejemplo de PHP de trabajo
¿No estás seguro de cómo usar nuestra API? Aquí hay un ejemplo práctico para obtener un diagrama de acordes de "C Major", usando la extensión SimpleXML (nativa desde PHP 5.0):
<?php
//Archivo XML para cargar
$api_url = 'http://www.ukulele-chords.com/get?ak=YOUR_API_KEY&r=C&typ=major';
//convierte el archivo XML especificado en un objeto SimpleXMLElement
$xml = simplexml_load_file($api_url);
//Navega por el árbol para obtener tu información (diagrama de acordes aquí)
//acorde [0] responde el "acorde principal". Para posiciones alternativas, usa un bucle foreach ().
$res = $xml->chord[0]->chord_diag_mini;
//imprimir el resultado
echo '<img class="lazy" src="/img/img_load.png" data-src="'. $res .'" alt="" width="90" height="130" />';
?>
Por favor contact us o visita nuestra Página Facebook Si necesitas ayuda para usar nuestra API.
