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".
  • r es la nota fundamental del acorde. Se puede ajustar para "A", "Bb", "B" , "C", "Db", "D", "Eb", "E", "F", "Gb", "G" y "Ab"
  • typ es 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".
  • sk es la nota fundamental alterada de un acorde de barra. Opcional. (Valores aceptados: ver "r")
  • uke es 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_name El nombre del acorde ...
  • chord_diff Dificultad (en 10)
  • chord_diag Diagrama de acordes (200x250)
  • chord_diag_mini Diagrama de acordes (90x130)
  • chord_photo Imagen (da un mensaje de "falso" si no tenemos la foto)
  • chord_url Entra 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.


© 2011-2024 Ukulele-chords.com