autocomplete

Der Parameter ?action=autocomplete erzeugt eine alphabetisch sortierte Liste von Treffern zu einem Suchwort oder Wortanfang (case insensitive). Gesucht wird in Titeln und Alternativtiteln, beispielsweise wird bei der Suche nach "bach" auch Charles Gounod über das Pseudonym "Bach-Gounod" gefunden.

Die Rückgabe erfolgt als einfache Liste aus Titel, Entitätstyp und interner ID.

Beispiel Ausgabe Autovervollständigung "bach" (php):

array (
  0 => 
  array (
    0 => '"Die Kunst der Fuge" Contrapunctus 1 bis 19 und Orgelchoral: "Vor deinen Threon tret ich hiermit" (Bach, Johann Sebastian)',
    1 => 'work',
    2 => '21954',
  ),
  1 => 
  array (
    0 => '1. Akademisches Konzert, Volkshaus (Jena), 13.4.1946 19:00',
    1 => 'event',
    2 => '37459',
  ),
  2 => 
  array (
    0 => '1. Sonate G-Dur für Violoncello und Cembalo (Bach, Johann Sebastian)',
    1 => 'work',
    2 => '21593',
  ),
  3 => 
  array (
    0 => '1. Suite G-Dur für Violoncello allein (Bach, Johann Sebastian)',
    1 => 'work',
    2 => '21590',
  ),
  ...
)

Beipiele

Auslesen der API in PHP über inlcude und setzen des &return-Parameters (nicht empfohlen, funktioniert nur wenn allow_url_include in der php.ini aktiviert wurde; vgl.: https://www.php.net/manual/de/filesystem.configuration.php#ini.allow-url-include):

<?php
$autocomplete = include('https://performance.musiconn.de/api?action=autocomplete&title=bach&return');

echo('<ul>');
foreach($autocomplete as $value) {
    echo('<li>' . $value[0] . '</li>');
};
echo('</ul>');
?>

Auslesen der API in PHP über file_get_contents als serialisiertes Array:

<?php
$autocomplete = file_get_contents('https://performance.musiconn.de/api?action=autocomplete&title=bach&serialize');

echo('<ul>');
foreach(unserialize($autocomplete) as $value) {
    echo('<li>' . $value[0] . '</li>');
};
echo('</ul>');
?>

Auslesen der API in PHP über file_get_contents im JSON-Format (empfohlen):

<?php
$autocomplete = file_get_contents('https://performance.musiconn.de/api?action=autocomplete&title=bach&format=json');

echo('<ul>');
foreach(json_decode($autocomplete, true) as $value) {
    echo('<li>' . $value[0] . '</li>');
};
echo('</ul>');
?>

Auslesen der API in JavaScript (jQuery) im JSONP-Format mit Callback-Funktion:

function callback(autocomplete) {
	$('body').append('<ul></ul>');
	$(autocomplete).each(function(index, value) {
		$('body ul').append('<li>' + value[0] + '</li>');
	});
}

$.ajax({
  method: "GET",
  url: "https://performance.musiconn.de/api?action=autocomplete&title=bach&format=jsonp",
  dataType: "script"
});

Alle obigen Beispiele erzeugen eine Ausgabe wie:

• "Die Kunst der Fuge" Contrapunctus 1 bis 19 und Orgelchoral: "Vor deinen Threon tret ich hiermit" (Bach, Johann Sebastian)
• 1. Akademisches Konzert, Volkshaus (Jena), 13.4.1946 19:00
• 1. Sonate G-Dur für Violoncello und Cembalo (Bach, Johann Sebastian)
• ...