API:Edit/de

From MediaWiki.org
Jump to navigation Jump to search
Sprachen: English  • Deutsch • español • français • 日本語 • русский • Tiếng Việt • 中文
MediaWiki version: 1.13

Zur Nutzung müssen die folgenden Konfigurationseinstellungen auf true gesetzt sein: $wgEnableAPI und $wgEnableWriteAPI. Siehe auch: Manual:DefaultSettings.php.


Token[edit]

Um eine Seite bearbeiten zu können wird ein Token benötigt. Das Token ist für alle Seiten gleich, aber ändert sich mit jedem Login. Wenn du dich gegen Bearbeitungskonflikte schützen willst (was zu empfehlen ist), brauchst du außerdem den Zeitstempel der letzen Version. Du erhältst diese wie folgt: Edit-Token holen

Seiten bearbeiten[edit]

Seiten können mit action=edit erstellt oder bearbeitet werden.

Parameter[edit]

  • title: Die zu bearbeitende Seite
  • section: Der zu bearbeitende Abschnitt. Nutze 0 für den Teil vor der ersten Überschrift und 'new' für einen neuen Abschnitt
  • text: Der neue Inhalt der Seite oder des Abschnitts
  • token: Edit-Token
  • summary: Bearbeitungskommentar
    • Bei Verwendung von section=new wird dieser Text für die Abschnittsüberschrift verwendet
  • minor: Die Bearbeitung wird als kleine Bearbeitung markiert
  • notminor: Die Bearbeitung nicht als klein markieren, selbst wenn „Eigene Änderungen standardmäßig als geringfügig markieren“ in den Einstellungen angegeben wurde
  • bot: Die Bearbeitung als Bot-Änderung markieren; selbst wenn du einen Bot-Account verwendest werden die Änderungen nicht markiert, wenn nicht dieses Flag gesetzt ist
  • basetimestamp: Zeitstempel der letzten Version; ungesetzt lassen um Bearbeitungskonflikte zu ignorieren
  • starttimestamp: Zeitstempel der den Zeitpunkt des Erhaltens des Edit-Tokens enthält; Wird auch verwendet um Bearbeitungskonflikte zu erkennen; ungesetzt lassen um Konflikte zu ignorieren
  • recreate: Keinen Fehler erzeugen, wenn die Seite zwischenzeitlich gelöscht wurde sondern die Seite einfach neu erstellen
  • createonly: Einen Fehler erzeugen, wenn die Seite schon existiert
  • nocreate: Einen Fehler erzeugen, wenn die Seite nicht existiert
  • watchlist: Angabe, wie die Beobachtungsliste von dieser Bearbeitung betroffen ist, zu setzen auf „watch“, „unwatch“, „preference“ oder „nochange“:
    • watch: Seite zur Beobachtungsliste hinzufügen
    • unwatch: Seite von der Beobachtungsliste hinzufügen
    • preferences: Benutzereinstellungen („Selbst geänderte und neu erstellte Seiten automatisch beobachten“) beachten (dies ist der Standardwert)
    • nochange: Beobachtungsliste nicht verändern
  • md5: MD5-Summe des text-Parameters. Wenn der Parameter gesetzt ist und die Prüfsummen nicht übereinstimmen wird die Bearbeitung nicht ausgeführt. Damit kann man sich vor Datenverfälschung schützen.
  • captchaid: CAPTCHA-ID der vorhergehenden Anfrage
  • captchaword: Antwort auf das CAPTCHA
  • undo: Versions-ID zum Zurücksetzen. text, prependtext und appendtext werden ignoriert.
  • undoafter: Alle Versionen von undo bis zu dieser aber nicht einschließlich dieser Version zurücksetzen. Wenn er nicht gesetzt ist wird nur eine Version rückgängig gemacht.

Beispiel[edit]

Hinweis: In diesem Beispiel werden alle Parameter der Einfachheit halber in einer GET-Anfrage übergeben. Die Software fordert für action=edit allerdings POST-Anfragen. GET-Anfragen werden einen Fehler verursachen. Vergiss nicht, die Header-Zeile Content-Type deiner Anfrage auf application/x-www-form-urlencoded zu setzen. Das Token, das du erhältst, endet mit +\ und muss URL-codiert werden, sodass es mit %2B%5C endet. Einen neuen Abschnitt zu en:Talk:Main Page hinzufügen

Captchas und Fehler aus Erweiterungen[edit]

Wenn eine Bearbeitung Captchas erfordert, wirst du so eine Antwort erhalten:

<?xml version="1.0" encoding="utf-8"?>
<api>
  <edit result="Failure">
    <captcha type="math" mime="text/tex" id="509895952" question="36 + 4 = " />
  </edit>
</api>

In den meisten Fällen wirst du kein Mathe-Captcha erhalten sondern eine URL zu einem Bild (im url-Feld). Wenn du das Captcha gelöst hast, sende die Anfrage erneut (in diesem Fall mit captchaid=509895952&Captchaword=40).

Andere Erweiterungen, die den APIEditBeforeSave-Hook verwenden, können Fehler zurückgeben und dabei entweder das oben beschriebene Format oder das übliche Fehlerformat verwenden.

Mögliche Fehler[edit]

Zusätzlich zu den üblichen Fehlern:

  • code: notitle
    • info: Der Parameter title muss gesetzt sein
  • code: notext
    • info: Einer der Parameter text, appendtext, prependtext und undo muss gesetzt sein
  • code: notoken
    • info: Der Parameter token muss gesetzt sein
  • code: invalidsection
    • info: Der Parameter section muss auf eine ganze Zahl oder 'new' gesetzt sein
  • code: protectedtitle
    • info: Das Lemma ist geschützt
  • code: cantcreate
    • info: Du hast keine Berechtigung die Seite zu erstellen
  • code: cantcreate-anon
    • info: Anonyme Benutzer können keine neuen Seiten erstellen
  • code: articleexists
    • info: Der Artikel existiert bereits
  • code: noimageredirect-anon
    • info: Anonyme Benutzer können keine Weiterleitungen für Bilder erstellen
  • code: noimageredirect
    • info: Du darfst keine Weiterleitungen für Bilder erstellen
  • code: spamdetected
    • info: Deine Anfrage wurde zurückgewiesen weil sie ein Spam-Element enthält: ``wikitext''
  • code: filtered
    • info: Die Filterfunktion hat deine Anfrage zurückgewiesen
  • code: contenttoobig
    • info: Der Text den du gesendet hast überschreitet die maximale Artikelgröße von bytes Bytes
  • code: noedit-anon
    • info: Anonyme Benutzer können keine Seiten bearbeiten
  • code: noedit
    • info: Du hast keine Berechtigung Seiten zu bearbeiten
  • code: pagedeleted
    • info: Die Seite wurde gelöscht seit du den Zeitstempel geholt hast
  • code: emptypage
    • info: Das Erstellen neuer leerer Seiten ist nicht erlaubt
  • code: emptynewsection
    • info: Das Erstellen neuer leerer Abschnitte ist nicht erlaubt
  • code: editconflict
    • info: Es ist ein Bearbeitungskonflikt aufgetreten
  • code: revwrongpage
    • info: rrevid ist keine Versionsnummer der Seite ``pagename''
      • Tritt auf wenn eine ungültige revid für undo oder undoafter angegeben wird
  • code: undo-failure
    • info: Fehler beim Zurücksetzen wegen zwischenzeitlicher Bearbeitungen