API:Suchen und Finden

MediaWiki, seine Erweiterungen und und seine Schwesterprojekte bieten enormes Potenzial, um Wissen durch Suchen zu entdecken. Das Search-Platform-Team entwickelt den Mechanismus, Werkzeuge und Dienste, um dies zu tun.

Benutzer können Informationen in MediaWiki finden, indem sie sie direkt suchen und in Wikidata, indem sie Help:Navigation in Wikidata lesen.

MediaWiki

Die MediaWiki API hat unterschiedliche Module mit Bezug zu Suchen. Du kannst am /w/api.php-Eingangspunkt jedes Wikis Abfragen stellen und dir die generierte Hilfe ansehen oder auf Special:ApiSandbox API-Abfrageparameter eintragen.

Suchmodule

action=opensearch

Siehe API:OpenSearch . Gibt Suchergebnisse im OpenSearch-Format aus, jeweils mit Erweiterung:TextExtracts in Wikimedia-Projekten. Generierte API-Hilfe ansehen

action=languagesearch

Nach Sprachnamen in einem beliebigen Skript suchen. Generierte API-Hilfe ansehen

Abfragelisten-Submodule

Diese Abfrage-Submodule geben eine Liste von Wiki-Seiten aus, die Such-Kriterien erfüllen und geben teilweise zusätzliche Informationen über jede Seite aus. Darüber hinaus kannst du jedes als Generator nutzen, um viele andere Eigenschaften zu den zurückgegebenen Seiten bereitzustellen, wie das Einleitungsbild, Ausschnitt und/oder Seitenbeschreibung.

action=query list=prefixsearch

Ruft Titel von Wiki-Seiten mit dem angegebenen Präfix ab. Siehe den Artikel Seiteninfo in Suchergebnissen. Siehe die Modul-Dokumentation für API:Präfixsuche und sieh dir die generierte API-Hilfe an.

action=query list=search

Nutzt die Wiki-Suchmaschine, um passende Seiten zu finden. In Wikimedia-Wikis bietet es Suchergebnisse der CirrusSearch, die typische Informationen zu Suchergebnissen, wie Text-Ausschnitte und Seitengröße ausgibt. Siehe die Modul-Dokumentation für API:Suche und sieh dir die generierte API-Hilfe an

action=query list=geosearch

Wenn die GeoData-Erweiterung im Wiki installiert ist, gibt dies Wiki-Seiten in der Nähe mit geografischen Informationen aus. Siehe den Artikel Nahegelegene-Orte-Betrachter, die Modul-Dokumentation für die Geosuche und sieh dir die generierte API-Hilfe an.

Clients

Kommandozeile

Aus der Kommandozeile kannst du die API abfragen, indem du cURL nutzt, um die API-Abfrage zu stellen und jq, um die JSON-Abfrage zu parsen.

Lass uns zum Beispiel das Datenobjekt Richard Feynman (Q39246) in Wikidata nachschlagen und die englische Bezeichnung abfragen:

$ URL='https://www.wikidata.org/w/api.php?action=wbgetentities&ids=Q39246&format=json'
$ curl -s $URL | jq '.entities[].labels.en.value'
"Richard Feynman"

$ curl -s $URL | jq '.entities[].claims|length'
55

Wir finden heraus, dass Q39246 der Wikidata-Identifikator für das Datenobjekt mit der englischen Bezeichnung "Richard Feynman" ist und dass es 55 Aussagen über ihn gibt.

JavaScript

Um einen MediaWiki-API-Client in JavaScript zu schreiben, wird nur ein JSONP-Handler benötigt. Viele Bibliotheken (z.B. jQuery) umfassen JSONP-Clients oder es kann ein unabhängiger geschrieben werden.

Im MediaWiki-Ökosystem kann jQuery direkt genutzt werden:

$.ajax({
  url: '//www.wikidata.org/w/api.php',
  data: { action: 'wbgetentities', ids: mw.config.get('wgWikibaseItemId'), format: 'json' },
  dataType: 'jsonp',
  success: function (x) {
    console.log('wb label', x.entities.Q39246.labels.en.value);
    console.log('wb description', x.entities.Q39246.descriptions.en.value);
  }
});

Dies nutzt $.ajax() von jQuery, der in vielen interaktiven JavaScript-Code-Umgebungen verfügbar ist und Sinn macht, wenn dein Ziel ein eigenständiges Projekt ist.

Wenn dein Ziel ist, Code in einem Wiki auszuführen, z.B. als Gadget, solltest du die höherstufige Funktion mw.api() nutzen, die vom 'mediawiki.api'-ResourceLoader-Modul angeboten wird.

In anderen Umgebungen kann ein einfacher JSONP-Handler geschrieben werden:

var mw;
(function (mw) {

  /**
   * Query a MediaWiki api.php instance with the given options
   */
  function mwQuery(endpoint, options) {

    /**
     * Create a uniquely-named callback that will process the JSONP results
     */
    var createCallback = function (k) {
      var i = 1;
      var callbackName;
      do {
        callbackName = 'callback' + i;
        i = i + 1;
      } while (window[callbackName])
      window[callbackName] = k;
      return callbackName;
    }

    /**
     * Flatten an object into a URL query string.
     * For example: { foo: 'bar', baz: 42 } becomes 'foo=bar&baz=42'
     */
    var queryStr = function (options) {
      var query = [];
      for (var i in options) {
        if (options.hasOwnProperty(i)) {
          query.push(encodeURIComponent(i) + '=' + encodeURIComponent(options[i]));
        }
      }
      return query.join('&');
    }

    /**
     * Build a function that can be applied to a callback.  The callback processes
     * the JSON results of the API call.
     */
    return function (k) {
      options.format = 'json';
      options.callback = createCallback(k);
      var script = document.createElement('script');
      script.src = endpoint + '?' + queryStr(options);
      var head = document.getElementsByTagName('head')[0];
      head.appendChild(script);
    };

  }

  mw.api = {
    query: mwQuery,
  };

})(mw || (mw = {}));

CirrusSearch

CirrusSearch ist eine MediaWiki-Erweiterung, um die Elastic-basierte Suche des MediaWiki-Inhalts zu aktivieren. Sie fungiert als Such-Backend, wobei action=query&list=search die Haupt-Oberfläche hierfür ist.

Du kannst die gleichen Cirrus-Funktionen in API-Abfragen nutzen, die Benutzer in die Such-Box eingeben können. Zum Beispiel kannst du das Spezial-Präfix morelike: nutzen, um verwandte Seiten zu finden.

Suche nach Seiten mit Bezug zu Marie Curie und Radium.

api.php?action=query&list=search&srsearch=morelike:Marie_Curie|radium&srlimit=10&srprop=size&formatversion=2 [In der ApiSandbox ausprobieren]

Zusätzliche CirrusSearch-API-Module

Zusätzlich kann CirrusSearch seine Konfiguration und interne Informationen ausgeben. Diese APIs sind wahrscheinlich nur nützlich, wenn du dich mit Elasticsearch auskennst und sehen möchtest, wie CirrusSearch sie nutzt. Sie sind alle interne APIs zur Fehlersuche und es gibt keine Garantien hinsichtlich ihrer Rückwärts-Kompatibilität von Änderungen ihrer Ausgabe.

Seitenparameter ?action=cirrusdump

Zum Beispiel https://en.wikipedia.org/wiki/2014?action=cirrusdump

?cirrusDumpQuery-Parameter für Special:Search-Abfragen

Dies ist ein Action-Parameter für index.php, zum Beispiel https://en.wikipedia.org/wiki/Special:Search/cat%20dog%20chicken?cirrusDumpQuery

?cirrusDumpResult-Parameter für Special:Search-Abfragen

Dies ist ein Action-Parameter für index.php, zum Beispiel https://en.wikipedia.org/wiki/Special:Search/cat%20dog%20chicken?cirrusDumpResult

Ein zusätzlicher Parameter cirrusExplain kann mit cirrusDumpResult übergeben werden, um die Lucene-Erklärung des Ergebnisses zu erhalten, das im Ergebnis-Dump enthalten ist. Zum Beispiel https://en.wikipedia.org/wiki/Special:Search/cat%20dog%20chicken?cirrusDumpResult&cirrusExplain

API-Module cirrus-config-dump, cirrus-settings-dump, cirrus-mapping-dump

Diese geben das CirrusSearch-Setup aus.

Hier ist eine Beispiel-Abfrage

api.php?action=cirrus-config-dump&formatversion=2 [In der ApiSandbox ausprobieren]

Wikidata

Die Wikidata-API enthält einige Funktionen (wbgetentities, wbgetclaims, wbsearchentities), die genutzt werden können, um nach Informationen über Datenobjekte, Eigenschaften und Aussagen zu suchen.

Wikidata-Abfragedienst

Wikidata Query Service führt graph-basierte Suchen in Wikidata über eine SPARQL-API aus. Er ist verfügbar auf https://query.wikidata.org/

Der WDQS-Explorer (Demo) (Quellcode) bietet Graph im Browser an, indem SPARQL-Abfragen an den Wikidata-Abfragedienst gestellt werden.

Interaktive Beispiele

Wikipedia

Gehe auf https://en.wikipedia.org/wiki/Main_Page, öffne die JavaScript-Konsole und führe folgendes aus:

$.ajax({
  url: '//en.wikipedia.org/w/api.php',
  data: {
    action: 'query',
    list: 'search',
    srsearch: 'Richard Feynman',
    format: 'json',
    formatversion: 2
  },
  dataType: 'jsonp',
  success: function (x) {
    console.log('title', x.query.search[0].title);
  }
});

Dadurch wird die Zeichenkette Richard Feynman in der JavaScript-Konsole protokolliert.

Wenn die MediaWiki-Bibliotheken und -Umgebung nicht verfügbar sind, kann dies durch Nutzung der Funktion wmQuery() von oben erfolgen:

var queryWikipedia = mw.api.query('//en.wikipedia.org/w/api.php',
  { action: 'query', list: 'search', srsearch: 'Richard Feynman' });

queryWikipedia(function (x) {
  console.log('title', x.query.search[0].title);
});

Wikidata

Durch Nutzung von JSONP können wir die Schritte direkt von der JavaScript-Konsole des Browsers aus ausführen. In Wikipedia ist der Wikidata-Datenobjekt-Identifikator über den MediaWiki-Konfigurationswert wgWikibaseItemId verfügbar.

Gehe auf https://en.wikipedia.org/wiki/Richard_Feynman, öffne die JavaScript-Konsole und führe folgendes aus:

$.ajax({
  url: '//www.wikidata.org/w/api.php',
  data: { action: 'wbgetentities', ids: mw.config.get('wgWikibaseItemId'), format: 'json' },
  dataType: 'jsonp',
  success: function (x) {
    console.log('wb label', x.entities.Q39246.labels.en.value);
    console.log('wb description', x.entities.Q39246.descriptions.en.value);
  }
});

Dadurch wird die Zeichenkette Richard Feynman und die Zeichenkette der Beschreibung des Wikidata-Eintrags "American quantum physicist" in der JavaScript-Konsole protokolliert.

Wenn die MediaWiki-Bibliotheken und -Umgebung nicht verfügbar sind, kann dies durch Nutzung der Funktion wmQuery() von oben erfolgen:

var queryWikidata = mw.api.query('//www.wikidata.org/w/api.php',
  { action: 'wbgetentities', ids: 'Q39246' }); 

queryWikidata(function (x) {
  console.log('wb label', x.entities.Q39246.labels.en.value);
  console.log('wb description', x.entities.Q39246.descriptions.en.value);
});

Wiktionary

Gehe auf https://en.wikipedia.org/wiki/Main_Page, öffne die JavaScript-Konsole und führe folgendes aus:

$.ajax({
  url: '//en.wiktionary.org/w/api.php',
  data: { action: 'query', prop: 'revisions', rvprop: 'content', titles: 'Richard Feynman', format: 'json' },
  dataType: 'jsonp',
  success: function (x) {
    console.log('wiktionary title', x.query.pages['-1'].title);
  }
});

Dadurch wird die Zeichenkette Richard Feynman in der JavaScript-Konsole protokolliert.

Wenn die MediaWiki-Bibliotheken und -Umgebung nicht verfügbar sind, kann dies durch Nutzung der Funktion wmQuery() von oben erfolgen:

var queryWiktionary = mw.api.query('//en.wiktionary.org/w/api.php',
  { action: 'query', prop: 'revisions', rvprop: 'content', titles: 'Richard Feynman' });

queryWiktionary(function (x) {
  console.log('wiktionary title', x.query.pages['-1'].title);
});