API:Query/de

Mit dem  können Sie Informationen über ein Wiki und die darin gespeicherten Daten abrufen, z. B. den Wikitext einer bestimmten Seite, die Links und Kategorien einer Seitengruppe oder den Token, den Sie zum  benötigen.

Abfragemodule
Das Abfragemodul hat drei Typen von Submodulen (auch Abfragemodule genannt):


 * über das Wiki und angemeldete Benutzer.
 * von Seiten, darunter Seitenversionen und Seiteninhalt.
 * von Seiten, die bestimmte Kriterien erfüllen.

Beispiel 1: Seiten angeben
Im Gegensatz zu Meta- und Abfrage-Modulen funktionieren alle Eigenschaften-Abfragemodule auf einem Satz von Seiten, der auf eine der folgenden Wege festgelegt werden kann:


 * Nach Name mit dem -Parameter, z.B..
 * Nach Seiten-ID mit dem -Parameter, z.B..
 * Nach Versions-ID mit dem -Parameter, z.B.  . Die meisten Abfragemodule werden die Versions-ID in die entsprechende Seiten-ID umwandeln. Nur  nutzt derzeit die Versions-ID selbst.
 * Mit einem Generator.

Beispiel 2: Titelnormalisierung
Titelnormalisierung wandelt Seitentitel in ihr kanonisches Format um.

Dies bedeutet, dass das erste Zeichen großgeschrieben wird, Unterstriche durch Leerzeichen ersetzt werden und Namensräume in die lokalisierte Form umgewandelt werden, die für das Wiki genutzt wird.

Beispiel 3: Fehlende und ungültige Titel
Titel, die nicht existieren oder ungültig sind, werden in der Antwort eines der Attribute  oder   erhalten.

In Ausgabeformaten, die numerische Array-Schlüssel unterstützen, haben fehlende und ungültige Titel negative Seiten-IDs.

Beispiel 4: Fortsetzen von Abfragen
Wenn in der Antwort der Abfrage nicht alle Daten ausgegeben werden, gibt es ein -Attribut, das angibt, dass es noch weitere Daten gibt.

Setze ihre Werte in die ursprüngliche Abfrage ein, um weitere Daten zu erhalten.

Beispiel 5: Batchcomplete
Die API gibt ein -Element aus, um anzuzeigen, dass alle Daten für den aktuellen Stapel von Objekten ausgegeben wurden.

In die Antwort der Beispiel-Abfrage unten wurde  eingebunden, um anzuzeigen, dass alle Daten für jedes der drei Bilder ausgegeben wurden.

Die nächste Fortsetzung wird mit der Ausgabe der Daten für den nächsten Satz von drei Bildern beginnen.

Beispiel 6: Generatoren
Nutze Generatoren, wenn du Daten über einen Satz von Seiten erhalten möchtest.

Um beispielsweise Daten über Seiten in einer bestimmten Kategorie zu erhalten, frage nicht zuerst  ab und dann nochmal mit   bei allen ausgegebenen Seiten, sondern kombiniere die beiden API-Abfragen mithilfe von.

Wenn du ein Listenmodul als Generator nutzt, musst du die Seiten nicht angeben.

Für ein Eigenschaftsmodul solltest du hingegen die Seiten angeben, die der Generator bearbeiten soll.

Nutze zum Beispiel, um alle Seiten zu laden, die von der Hauptseite verlinkt sind.

Parameter, die an einen Generator übergeben werden, müssen mit einem Präfix  versehen werden. Nutze bei  beispielsweise   statt.

Die einfache Abfrage unten fragt Links und Kategorien für die ersten drei Seiten im Hauptnamensraum, die mit "Ba" beginnen ab.

Parametergeschichte

 * v1.21: Eingeführt
 * v1.24: Eingeführt  (note raw continuation was the default behavior until v1.26)

Additional notes

 * Specifying titles through  or   is limited to 50 titles per query, or 500 for those with the   right.
 * Use multiple query modules together to get what you need in one request, e.g..
 * Generators always pass page titles to the query module. Unlike lists (which may include additional data by default), generators should not output any information themselves, unless when explicitly requested via the generator module's query parameters.

Resolving redirects
Redirects can be resolved automatically, so that the target of a redirect is returned instead of the given title. When present, they will always contain  and   attributes and may contain a   attribute for those redirects that point to specific sections.

Both normalization and redirection may take place. In the case of multiple redirects, all redirects will be resolved, and in case of a circular redirect, there might not be a page in the 'pages' section (see also below). Redirect resolution cannot be used in combination with the  parameter or with a generator generating revids; doing that will produce a warning and will not resolve redirects for the specified revids.

The examples below show how the  parameter works.

Siehe auch

 * - Die Schnellstart-Anleitung.
 * - Enthält Informationen zur Nutzung des Parameters.