API:Protect/de

Diese Seite ist Teil der deutschen Übersetzung der MediaWiki-API-Dokumentation.

Sprache:	English  • Deutsch

MediaWiki-API

• Erste Schritte (en)
• FAQ (en)
• Datenformate (en)
• Fehlermeldungen (en)
• API-Benutzung einschränken (en)
• Authentifizierung
  • Login (en)
  • Logout (en)
• Abfragen (en)
  • Meta-Informationen (en)
  • Eigenschaften (en)
  • Listen (en)
• Vorlagen expandieren und wiedergeben (en)
• Den Seiten-Cache leeren (en)
• Parameter-Informationen (en)
• Bearbeiten (en)
  • Seiten anlegen/ändern (en)
  • Seiten verschieben (en)
  • Rollback (en)
  • Seiten löschen (en)
  • Gelöschte Änderungen wiederherstellen (en)
  • Seiten (ent-)sperren (en)
  • Benutzer (ent-)sperren (en)
  • Seiten (nicht mehr) beobachten (en)
  • E-Mails verschicken (en)
  • Änderungen kontrollieren (en)
  • Artikel importieren (en)
  • Benutzerrechte ändern (en)
  • Bilder hochladen (en)
• MediaWiki-Erweiterungen, welche die API erweitern (en)
• Interne API-Nutzung und Erweiterungen (en)
• Vermischtes (en)
• Implementation (en)
• Bekannte API-Nutzer (en)

MediaWiki version:

1.12

Token

Um den Seitenschutz einer Seite zu verändern braucht man ein Seitenschutz-Token. Dies ist der gleiche wie der Edit-Token und derselbe für alle Seiten, er ändert sich allerdings bei jedem Login. Einen Seitenschutz-Token kann man folgendermaßen erhalten:

Einen Seitenschutz-Token erhalten

api.php ? action=query & prop=info & intoken=protect & titles=Hauptseite

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page
        pageid="1"
        counter="20"
        length="470"
        protecttoken="58b54e0bab4a1d3fd3f7653af38e75cb+\" 
      />
    </pages>
  </query>
</api>

Seiten schützen (aka Seiten sperren)

Seiten können mit action=protect geschützt werden.

Parameter

• title: Zu schützende Seite.
• token: Der in der vorigen Abfrage erhaltene Token. Das abschließende +\ muss als %2B%5C urlencoded sein.
• protections: Eine durch ‚|‘ getrennte Liste von Seitenschutzen, formatiert als Aktion=Benutzergruppe, z. B. edit=autoconfirmed|move=sysop
  • Um einen Seitenschutz aufzuheben, muss man all als Benutzergruppe angeben, z. B. edit=all|move=sysop
  • Wird eine Aktion ausgelassen, wird der dazugehörige Wert nicht verändert, d. h. edit=syop lässt den Verschiebeschutz unberührt.
• expiry: Eine durch ‚|‘ getrennte Liste von Timestamps im GNU Timestamp-Format, welche die Dauer der Seitenschutze angeben. Die erste Timestamp wird auf den ersten Schutz in protections angewandt, die zweite auf den zweiten u.s.w. Die Timestamps infinite, indefinite und never erzeugen einen nie endenden Seitenschutz. Du kannst auch Timestamps wie next Monday 16:04:57 oder 9:28 PM tomorrow (in Englischer Sprache) verwenden, für Einzelheiten siehe die verlinkte GNU-Seite.
  • Die Nummer der Timestamps muss der Nummer der Seitenschutze entsprechen, wenn nicht, wird ein Fehler zurückgegeben.
    • Um Rückwärts-Kompatibilität zu wahren, besteht bei dieser Regel eine Ausnahme: Wird nur eine einzige Timestamp angegeben, gilt diese für alle Seitenschutze
  • Wird der Parameter nicht gesetzt ist dies gleichbedeutend mit infinite
• reason: Der Grund für den Seitenschutz/die Aufhebung des Seitenschutzes (optional)
• cascade: Wenn gesetzt, werden Seiten, die in die geschützte Seite eingebunden sind, auch geschützt. Falls für das Bearbeiten der Seite weniger Nutzerrechte als für das Schützen von Seiten benötigt werden (z. B. edit=autoconfirmed), wird dieser Parameter ohne Fehlermeldung ignoriert, um zu verhindern, dass Nutzer, die keine Seiten schützen können sollen, trotzdem Seiten schützen, indem sie sie in eine Seite mit kaskadierendem Seitenschutz einbinden.

Beispiele

Beachte: In diesem Beispiel werden alle Parameter der Einfachheit wegen als GET-Anforderung gesendet. Jedoch muss action=protect mit einer POST-Anforderung gesendet werden, GET-Anforderungen liefern einen Fehler zurück.

Die Hauptseite mit edit=autoconfirmed, move=sysop kaskadierend schützen; ersteres am 24. Oktober 2007 um 16:07:54, zweiteres nie auslaufend

api.php ? action=protect & title=Hauptseite & protections=edit=autoconfirmed|move=sysop & expiry=20071024160754 & cascade & token=58b54e0bab4a1d3fd3f7653af38e75cb%2B\

<?xml version="1.0" encoding="utf-8"?>
<api>
  <protect title="Hauptseite" reason="" cascade="">
      <protections>
        <protection edit="autoconfirmed" expiry="24-10-2007T16:07:54Z" />
        <protection move="sysop" expiry="infinite" />
      </protections>
  </protect>
</api>

Seitenlöschbuch vor dem Erstellen schützen, auslaufend in zwei Monaten

api.php ? action=protect & title=Seitenlöschbuch & protections=create=sysop & expiry=2%20months & reason=Soll%20erstmal%20nicht%20angelegt%20werden & token=58b54e0bab4a1d3fd3f7653af38e75cb%2B\

<?xml version="1.0" encoding="utf-8"?>
<api>
  <protect title="Seitenlöschbuch" reason="Soll erstmal nicht angelegt werden">
    <protections>
      <protection create="sysop" expiry="2008-03-08T16:34:30Z" />
    </protections>
  </protect>
</api>

Fehler

Zusätzlich zu den üblichen Fehlern:

• code: notitle
  • info: The title parameter must be set
    • Der Parameter title muss gesetzt werden
• code: notoken
  • info: The token parameter must be set
    • Der Parameter token muss gesetzt werden
• code: noprotections
  • info: The protections parameter must be set
    • Der Parameter protections muss gesetzt werden
• code: invalidexpiry
  • info: Invalid expiry time “expiry”
    • Ungültige Ablaufzeit
      • Das bedeutet, dass die Timestamp falsch formatiert war oder das Datum nicht existiert (wie November 31 oder 24:05)
• code: pastexpiry
  • info: Expiry time “expiry” is in the past
    • Die Ablaufzeit liegt in der Vergangenheit
• code: toofewexpiries
  • info: number expiry timestamps were provided where number were needed
    • Es wurden Zahl Timestamps angegeben, notwendig wären Zahl
      • (Der englische Name des Fehlers ist eine Fehlbenennung: der Fehler wird auch erzeugt, wenn man zu viele Timestamps angibt)
• code: cantedit
  • info: You can't protect this page because you can't edit it
    • Seitenschutz kann nicht gesetzt werden, da du die Seite nicht bearbeiten darfst
• code: create-titleexists
  • info: Existing titles can't be protected with 'create'
    • Bereits bestehende Seiten können nicht mit „create“ vor der Anlage geschützt werden.
• code: missingtitle-createonly
  • info: Missing titles can only be protected with 'create'
    • Fehlende Seiten können nur mit „create“ geschützt werden.
• code: protect-invalidaction
  • info: Invalid protection type “type”
    • Ungültiger Seitenschutz „Typ“
• code: protect-invalidlevel
  • info: Invalid protection level “level”
    • Ungültige Seitenschutzgruppe „Benutzergruppe“