API:REST API/Reference/de

Die REST-API lässt dich durch das Absenden von HTTP-Abfragen an einzigartige URLs mit MediaWiki interagieren. Du kannst die API nutzen, um Apps und Skripte zu erstellen, die Wiki-Seiten und Versionsgeschichten durchsuchen.

= Suche =

Suchergebnisobjekt
Das Suchergebnisobjekt repräsentiert eine Wiki-Seite, die mit der angefragten Suche übereinstimmt.

Seiten suchen
Sucht nach Titeln von Wiki-Seiten und Inhalten für die angegebenen Suchbegriffe und gibt passende Seiten aus.

Automatische Vervollständigung des Seitentitels
Sucht Titel von Wiki-Seiten und gibt Treffer zwischen dem Beginn eines Titels und den angegebenen Suchbegriffen aus. Du kannst diesen Endpunkt für eine Typeahead-Suche nutzen, die automatisch relevante Seiten anhand ihres Titels vorschlägt.

Antworten
= Seiten =

Seiten-Objekt
Das Seiten-Objekt repräsentiert die letzte Version einer Wiki-Seite.

Seitensprachen-Objekt
Das Seitensprachen-Objekt repräsentiert eine Wiki-Seite und ihre Sprache.

Seite erstellen
Erstellt eine Wiki-Seite. Die Antwort umfasst einen -Header, der den API-Endpunkt enthält, um die neue Seite zu erhalten.

Dieser Endpunkt wurde entworfen, um zusammen mit dem Autorisierungsprozess der OAuth-Erweiterung genutzt zu werden. Anrufer, die die Cookie-basierte Authentifizierung nutzen, müssen stattdessen ein CSRF- zum Abfragekörper hinzufügen. Um ein CSRF-Token zu erhalten, siehe die Action API.

Eine Seite aktualisieren
Aktualisiert oder erstellt eine Wiki-Seite. Dieser Endpunkt wurde entworfen, um zusammen mit dem Autorisierungsprozess der OAuth-Erweiterung genutzt zu werden. Anrufer, die die Cookie-basierte Authentifizierung nutzen, müssen stattdessen ein CSRF- zum Abfragekörper hinzufügen. Um ein CSRF-Token zu erhalten, siehe die Action API.

Du benötigst die Kennung der letzten Version der Seite und die Quellseite. Rufe zunächst den Endpunkt an, um die Quellseite zu erhalten und nutze dann  und , um die Seite zu aktualisieren. Wenn  nicht mit der letzten Version einer Seite übereinstimmt, löst die API Konflikte automatisch, sofern dies möglich ist. Im Fall eines Bearbeitungskonfliktes, gibt die API einen 409-Fehler aus.

Lasse  bei der Abfrage weg, um eine Seite zu erstellen.

Seite erhalten
Gibt das Standard-Seiten-Objekt für eine Wiki-Seite mit dem API-Pfad zum Erhalt des letzten Inhalts in HTML, der Lizenz und Informationen über die letzte Version aus.

Seite offline erhalten
Gibt Informationen über eine Wiki-Seite aus, darunter die Lizenz, die letzte Version und der letzte Inhalt in HTML.

Quellseite erhalten
Gibt den Inhalt einer Wiki-Seite im durch die Eigenschaft  angegebenen Format, die Lizenz und Informationen über die letzte Version aus.

HTML erhalten
Gibt den letzten Inhalt einer Wiki-Seite in HTML aus.

Sprachen erhalten
Durchsucht verbundene Wikis nach Seiten mit dem gleichen Thema in einer anderen Sprache. Gibt ein Array der Seitensprachen-Objekte aus, das den Namen der Sprache, den Sprachcode und den übersetzten Seitentitel enthält.

Dateien von einer Seite erhalten
Gibt Informationen über Mediendateien aus, die auf einer Wiki-Seite genutzt werden.

Antworten
= Mediendateien =

Datei-Objekt
The file object represents a file uploaded to a wiki.

Datei erhalten
Returns information about a file, including links to download the file in thumbnail, preview, and original formats.

Responses
= History =

Revision object
The revision object represents a change to a wiki page.

Get page history
Returns information about the latest revisions to a wiki page, in segments of 20 revisions, starting with the latest revision. The response includes API routes for the next oldest, next newest, and latest revision segments, letting you scroll through page history.

Get page history counts
Returns data about a page's history.

Get revision
Returns details for an individual revision.

Compare revisions
Returns data that lets you display a line-by-line comparison of two revisions. (See an example.) Only text-based wiki pages can be compared.