API

API grauite pour les webmestres

Notre API permet aux webmestres de facilement accéder à notre base de données et publier nos diagrammes (et plus) sur leurs sites web. Tout ce qu'il vous faut c'est une tonalité API valide (+ un lien vers https://ukulele-chords.com), obtenez-en une gratuitement !

Comment cela fonctionne ?

Voici comment accéder aux données de ukulele-chords.com's

URL API : ukulele-chords.com/get?
Paramètres : "ak" (votre tonalité API), "r" (note fondamentale d'un accord), "typ" (type d'accord), "sk" (accord renversé) et "uke" (Type)
Tous les paramètres doivent être précisés sauf "sk" et "uke"
r est la note fondamentale d'un accord. Cela peut être "A", "Bb", "B" , "C", "Db", "D", "Eb", "E", "F", "Gb", "G" et "Ab"
typ est le type d'accord. Cela peut être "majeur", "m", "aug", "dim", "7", "m7", "maj7", "m7b5", "sus2", "sus4", "7sus4", "9", "11", "13", "6", "m6", "aj9", "m9", "5", "dim7", "m13", "7sus2", "mMaj7", "m11" and "maj9".
sk est la note basse d'un accord renversé. Optionel. (valeurs acceptées : voir "r")
uke est le type. Cela peut être "soprano" (Valeur par défaut), "baritone" (G-tuning, baryton), "d-tuning" (D) ou "slack-key". Optionel.
Exemple: Pour trouver les informations de l'accord Csus2, nommez notre API: "http://ukulele-chords.com/get?ak=votre_tonalité_API&r=C&typ=sus2"

Résultat (format XML)

chord_name Le nom de l'accord...
chord_diff Difficulté (sur 10)
chord_diag Diagramme d'accord (200x250)
chord_diag_mini Diagramme d'accord (90x130)
chord_photo Image (retroune "faux" si nous n'avons pas la photo)
chord_url Lien vers Ukulele-chords.com pour plus d'informations

Retourne faux si un accord demandé ne peut pas être trouvé.

Exemples de PHP qui fonctionnent

Vous ne savez pas comment utiliser notre API ? Voici un exemple concret pour récupérer un diagramme de l'accord 'Do Majeur', en utilisant l'extension SimpleXML (intégrée de base depuis PHP 5.0):


<?php
//XML file to load
$api_url = 'http://www.ukulele-chords.com/get?ak=YOUR_API_KEY&r=C&typ=major';
//converts the specified XML file into a SimpleXMLElement object
$xml = simplexml_load_file($api_url);
//Navigate through the tree to get your info (chord diagram here)
//chord[0] returns the "main chord". For alternative positions, use a foreach() loop.
$res = $xml->chord[0]->chord_diag_mini;
//print the result
echo '<img class="lazy" src="/img/img_load.png" data-src="'. $res .'" alt="" width="90" height="130" />';
?>

Merci de nous contacter ou visiter notre Page Facebook si vous avez besoin d'aide pour utiliser notre API.