API

Kostenloser API für Webmaster

Unsere API ermöglicht es Webmastern, auf einfache Weise unsere Akkorddatenbank abzufragen und unsere Diagramme (und mehr) auf ihrer Website zu veröffentlichen. Sie benötigen lediglich einen gültigen API - Schlüssel (+ einen Link zurück zuhttps://ukulele-chords.com), jetzt einen gratis sichern!

Funktionsweise

So greifen Sie auf die Daten von ukulele-chords.com zu

  • API URL : ukulele-chords.com/get?
  • Parameter : "ak" (Ihr API Schlüssel), "r" (Grundton eines Akkords), "Art" (Akkordart), "sk" (Slash Akkord) and "Uke" (Stimmung)
  • Alle Parameter sind obligatorisch außer "sk" und "uke"
  • r ist der Grundton des Akkords. Kann eingestellt werden auf "A", "Bb", "B" , "C", "Db", "D", "Eb", "E", "F", "Gb", "G" und "Ab"
  • typ ist die Art des Akkords. Kann eingestellt werden auf "Dur", "m", "aug", "dim", "7", "m7", "maj7", "m7b5", "sus2", "sus4", "7sus4", "9", "11", "13", "6", "m6", "add9", "m9", "5", "dim7", "m13", "7sus2", "mMaj7", "m11" und "maj9".
  • sk ist der veränderte Grundton eines Slash Akkords. Optional. (Akzeptierte Werte : siehe "r")
  • uke ist die Stimmung. Kann auf "Sopran" gesetzt werden (Standardwert), "Bariton" (G-Stimmung), "d-Stimmung" oder "Slack-key". Optional.
  • Beispiel: um Csus2-Akkordinfos abzufragen, rufen Sie unsere API auf: "http://ukulele-chords.com/get?ak=your_api_key&r=C&typ=sus2"

Ausgabe (XML format)

  • chord_name Der Akkordname...
  • chord_diff Schwierigkeit (auf 10)
  • chord_diag Akkorddiagramm (200x250)
  • chord_diag_mini Akkorddiagramm (90x130)
  • chord_photo Foto (Gibt "falsch" aus, wenn wir das Foto nicht haben)
  • chord_url Link zu Ukulele-chords.com für mehr Infos

Gibt falsch aus, wenn der angeforderte Akkord nicht gefunden wird.

Funktionierendes PHP-Beispiel

Sie sind sich nicht sicher, wie Sie unsere API verwenden sollen? Hier ist ein funktionierendes Beispiel, um ein 'C Dur' Akkorddiagramm zu bekommen, mit Hilfe der SimpleXML Erweiterung (nativ seit 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" />';
?>

Bitte kontaktieren Sie uns oder besuchen Sie unsere Facebook Seite, wenn Sie Hilfe bei der Verwendung unserer API benötigen.


© 2011-2024 Ukulele-chords.com