MediaWiki-API-Hilfe
Dies ist eine automatisch generierte MediaWiki-API-Dokumentationsseite.
Dokumentation und Beispiele: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=edit
- Dieses Modul erfordert Leserechte.
- Dieses Modul erfordert Schreibrechte.
- Dieses Modul akzeptiert nur POST-Anfragen.
- Quelle: MediaWiki
- Lizenz: GPL-2.0-or-later
Erstellen und Bearbeiten von Seiten.
- title
Titel der Seite, die bearbeitet werden soll. Kann nicht zusammen mit pageid verwendet werden.
- pageid
Seitennummer der Seite, die bearbeitet werden soll. Kann nicht zusammen mit title verwendet werden.
- Typ: Ganzzahl
- section
Abschnittskennzeichen. 0 für die Einleitung, new für einen neuen Abschnitt. Meist eine positive ganze Zahl, kann aber auch nicht-numerisch sein.
- sectiontitle
Die Überschrift für einen neuen Abschnitt, wenn section=new verwendet wird.
- text
Seiteninhalt.
- summary
Bearbeitungszusammenfassung.
Wird dieser Parameter nicht angegeben oder ist er leer, wird automatisch eine Bearbeitungszusammenfassung erstellt.
Wenn section=new angegeben und sectiontitle nicht angegeben wird, wird stattdessen der Wert dieses Parameters für den Titel des Abschnitts verwendet, und es wird automatisch eine Bearbeitungszusammenfassung erstellt.
Auf die Version anzuwendende Änderungsmarkierungen.
- Werte (mit | trennen oder Alternative):
- minor
Markiert diese Bearbeitung als geringfügig.
- Type: boolean (details)
- notminor
Diese Bearbeitung nicht als geringfügig markieren, auch wenn die Benutzereinstellung „Eigene Änderungen standardmäßig als geringfügig markieren“ festgelegt ist.
- Type: boolean (details)
- bot
Diese Bearbeitung als Bot-Bearbeitung markieren.
- Type: boolean (details)
- baserevid
ID der Basisversion, die zum Erkennen von Bearbeitungskonflikten verwendet wird. Kann über action=query&prop=revisions bezogen werden. Selbstkonflikte führen dazu, dass die Bearbeitung fehlschlägt, es sei denn, basetimestamp ist festgelegt.
- Typ: Ganzzahl
- basetimestamp
Zeitstempel der Basisversion, wird verwendet zum Aufspüren von Bearbeitungskonflikten. Kann abgerufen werden durch action=query&prop=revisions&rvprop=timestamp. Eigenkonflikte werden ignoriert.
- Typ: Zeitstempel (erlaubte Formate)
- starttimestamp
Zeitstempel, an dem der Bearbeitungsprozess begonnen wurde. Er wird zum Aufspüren von Bearbeitungskonflikten verwendet. Ein geeigneter Wert kann mithilfe von curtimestamp beim Beginn des Bearbeitungsprozesses (z. B. beim Laden des Seiteninhalts zum Bearbeiten) abgerufen werden.
- Typ: Zeitstempel (erlaubte Formate)
- recreate
Keinen Fehler zurückgeben, wenn die Seite in der Zwischenzeit gelöscht wurde.
- Type: boolean (details)
- createonly
Seite nicht bearbeiten, falls sie bereits vorhanden ist.
- Type: boolean (details)
- nocreate
Einen Fehler zurückgeben, falls die Seite nicht vorhanden ist.
- Type: boolean (details)
- watch
- Veraltet.
Seite der Beobachtungsliste hinzufügen.
- Type: boolean (details)
- unwatch
- Veraltet.
Seite von der Beobachtungsliste entfernen.
- Type: boolean (details)
- watchlist
Die Seite zur Beobachtungsliste des aktuellen Benutzers hinzufügen oder von ihr entfernen, die Standardeinstellungen (werden für Bot-Benutzer ignoriert) verwenden oder die Beobachtung nicht ändern.
- Einer der folgenden Werte: nochange, preferences, unwatch, watch
- Standard: preferences
- md5
Der MD5-Hash des Parameters text oder der aneinandergehängten Parameter prependtext und appendtext. Wenn angegeben, wird die Bearbeitung nicht ausgeführt, wenn der Hash nicht korrekt ist.
- prependtext
Diesen Text an den Anfang der Seite oder des Abschnitts setzen. Überschreibt text.
- appendtext
Diesen Text an das Ende der Seite oder des Abschnitts hinzufügen. Überschreibt text.
Verwende statt dieses Parameters section=new zum Anhängen eines neuen Abschnitts.
- undo
Diese Version rückgängig machen. Überschreibt text, prependtext und appendtext.
- Typ: Ganzzahl
- Der Wert darf nicht kleiner sein als 0.
- undoafter
Alle Versionen von undo bis zu dieser rückgängig machen. Falls nicht angegeben, nur eine Version rückgängig machen.
- Typ: Ganzzahl
- Der Wert darf nicht kleiner sein als 0.
- redirect
Weiterleitungen automatisch auflösen.
- Type: boolean (details)
- contentformat
Für den Eingabetext verwendetes Inhaltsserialisierungsformat.
- Einer der folgenden Werte: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- contentmodel
Inhaltsmodell des neuen Inhalts.
- Einer der folgenden Werte: css, javascript, json, text, unknown, wikitext
- token
Ein „csrf“-Token abgerufen von action=query&meta=tokens
Der Token sollte immer als letzter Parameter gesendet werden, zumindest aber nach dem text-Parameter.
- Dieser Parameter ist erforderlich.
- returnto
Seitentitel. Wenn durch das Speichern der Bearbeitung ein temporäres Konto erstellt wurde, antwortet die API möglicherweise mit einer URL, die der Client besuchen sollte, um die Anmeldung abzuschließen. Wenn dieser Parameter angegeben wird, wird die URL auf die angegebene Seite umgeleitet und nicht auf die Seite, die bearbeitet wurde.
- Typ: Seitenname
- Akzeptiert nicht existierende Seiten.
- returntoquery
URL-Abfrageparameter (mit führendem ?). Wenn durch das Speichern der Bearbeitung ein temporäres Konto erstellt wurde, kann die API mit einer URL antworten, die der Kunde besuchen sollte, um die Anmeldung abzuschließen. Wenn dieser Parameter angegeben wird, wird die URL auf eine Seite mit den angegebenen Abfrageparametern umgeleitet.
- Standard: (leer)
- returntoanchor
URL-Fragment (mit führendem #). Wenn durch das Speichern der Bearbeitung ein temporäres Konto erstellt wurde, kann die API mit einer URL antworten, die der Kunde besuchen sollte, um die Anmeldung abzuschließen. Wenn dieser Parameter angegeben wird, wird die URL auf eine Seite mit dem angegebenen Fragment umgeleitet.
- Standard: (leer)
- Eine Seite bearbeiten
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [in Spielwiese öffnen]
- __NOTOC__ bei einer Seite voranstellen
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [in Spielwiese öffnen]
- Versionen 13579 bis 13585 mit automatischer Zusammenfassung rückgängig machen
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [in Spielwiese öffnen]