API:Block/de

From MediaWiki.org
Jump to: navigation, search
Tools clipart.png Diese Seite ist Teil der MediaWiki-API-Dokumentation.
Sprache: English  • Deutsch • 日本語
MediaWiki API

Schnellübersicht:

v · d · e
MediaWiki Version: 1.12

Contents

Token [edit]

Um einen Benutzer zu (ent)sperren, braucht man ein (Ent)Sperrtoken. Dieses Token ist dasselbe wie das Edittoken und für alle Sperren gleich, ändert sich aber mit jeder Neuanmeldung. Ein (Ent)Sperrtoken bekommt man auf folgende Weise:

Anfordern eines Sperrtokens

api.php?action=query&prop=info&intoken=block&titles=User:Bob
Result
The following content has been placed in a collapsed box for improved usability. 
<?xml version="1.0"?>
<api>
  <query>
    <pages>
      <page ns="2" title="User:Bob" missing="" starttimestamp="2008-10-27T12:15:36Z"
        blocktoken="101089c295402adff96016ca002480c8+\" />
    </pages>
  </query>
</api>
The above content has been placed in a collapsed box for improved usability.

Anfordern eines Entsperrtokens

api.php?action=query&prop=info&intoken=unblock&titles=User:Bob
Result
The following content has been placed in a collapsed box for improved usability. 
<<?xml version="1.0"?>
<api>
  <query>
    <pages>
      <page ns="2" title="User:Bob" missing="" starttimestamp="2008-10-27T12:15:36Z"
        unblocktoken="101089c295402adff96016ca002480c8+\" />
    </pages>
  </query>
</api>
The above content has been placed in a collapsed box for improved usability.

Benutzer sperren [edit]

Benutzer können mit action=block gesperrt werden.

Parameter [edit]

  • user: Der Benutzername, die IP-Addresse oder die IP-Range, die gesperrt werden soll.
  • token: Das Token, das in der vorherigen Anfrage geholt wurde. Dabei sollte man darauf achten, dass das + als %2B codiert wird.
  • gettoken: Ist dieses Flag gesetzt, erhält man ein Sperrtoken.
  • expiry: Zeitstempel für das Ende der Sperre. Relative Angaben wie 5 months oder 2 weeks werden auch angenommen. Ist der Wert auf infinite, infinity, neveroder gar nicht gesetzt, endet die Sperre nie.
  • reason: Die Begründung für die Sperre (optional).
  • anononly: Ist dieses Flag gesetzt, werden nur anonyme Bearbeitungen von der gesperrten IP geblockt, sodass der gesperrte Benutzer sich anmelden oder registrieren muss, um Bearbeitungen durchführen zu können.
  • nocreate: Ist dieses Flag gesetzt, wird das Anlegen neuer Benutzer von der gesperrten IP verhindert.
  • autoblock: Ist dieses Flag gesetzt, wird die Sperre automatisch auf die IP-Addresse, von der aus der Benutzer sich das letzte mal anmeldete, und alle weiteren, unter denen er sich anmeldet, ausgeweitet.
  • noemail: Ist dieses Flag gesetzt, kann der Benutzer keine E-Mails mehr über Special:Emailuser versenden.

Beispiel [edit]

Wichtig: In diesem Beispiel werden zur einfachen Darstellung alle Parameter als GET-Parameter übergeben. Die API selbst erwartet aber eine POST-Anfrage. Ansonsten wird ein Fehler geliefert.

Sperre Bob für eine Woche, sperre Anlegen neuer Benutzer und E-Mail-Versand

api.php?action=block&user=Bob&expiry=1%20day&reason=Zeit%20vorbei&nocreate&noemail&token=bffd6f4fbd23ed07254ec3cec8fa69da%2B\
Result
The following content has been placed in a collapsed box for improved usability. 
<?xml version="1.0" encoding="utf-8"?>
<api>
  <block
    user="Bob"
    userID="147"
    expiry="20070906231113"
    reason="Zeit vorbei"
    nocreate=""
    noemail=""
  />
</api>
The above content has been placed in a collapsed box for improved usability.

Mögliche Fehler [edit]

Zusätzlich zu dem normalen Kram:

  • nouser
    • Der Parameter user ist nicht gesetzt (muss gesetzt sein)
  • notoken
    • Der Parameter token ist nicht gesetzt (muss gesetzt sein)
  • permissiondenied
    • Du darfst keine Benutzer sperren
      • Auf den meisten Wikis dürfen Administratoren sperren, aber andere Wikis können striktere Regeln haben
  • invalidrange
    • Die IP-Range ist ungültig
  • rangedisabled
    • Das Sperren von IP-Ranges ist abgeschaltet
  • invalidip
    • Die IP-Addresse ist ungültig
  • invalidexpiry
    • Das Sperrende ist ungültig
  • alreadyblocked
    • Der Benutzer, den du sperren wolltest, ist schon gesperrt
  • pastexpiry
    • Das Sperrende liegt in der Vergangenheit
  • cantblock
    • Du darfst keine Benutzer sperren
  • canthide
    • Du darfst keine Benutzernamen im Sperrlog verstecken
      • Dieses Feature muss explizit in der LocalSettings.php aktiviert werden.
  • cantblock-email
    • Du darfst den E-Mail-Versand durch das Wiki nicht sperren

Benutzer entsperren [edit]

Benutzer können mit action=unblock entsperrt werden.

Parameter [edit]

  • id: Die ID der Sperre, die du rückgängig machen willst. IDs können durch list=blocks ermittelt werden.
  • user: Der Benutzer, die IP-Addresse oder die IP-Range, die du entsperren willst.
  • token: Das Token, das in der vorherigen Anfrage geholt wurde. Dabei sollte man darauf achten, dass das + als %2B codiert wird.
  • gettoken: Ist dieses Flag gesetzt, erhält man ein Sperrtoken.
  • reason: Der Grund für die Entsperrung (optional).

Beispiel [edit]

Bob entsperren und sich entschuldigen

api.php?action=unblock&user=Bob&token=bffd6f4fbd23ed07254ec3cec8fa69da%2B\&reason=Entschuldigung%20Bob
Result
The following content has been placed in a collapsed box for improved usability. 
<?xml version="1.0" encoding="utf-8"?>
<api>
  <unblock
    id="17"
    user="Bob"
    reason="Entschuldigung Bob"
  />
</api>
The above content has been placed in a collapsed box for improved usability.

Mögliche Fehler [edit]

Zusätzlich zu dem normalen Kram:

  • notarget
    • Einer der Parameter id und user muss gesetzt sein, keiner ist gesetzt
  • notoken
    • Der Parameter token ist nicht gesetzt (muss gesetzt sein)
  • idanduser
    • Nur einer der Parameter id und user darf gesetzt sein, beide sind gesetzt
  • blockedasrange
    • info: Die IP-Addresse wurde als IP-Range gesperrt und kann auch nicht einzeln entsperrt werden
  • cantunblock
    • Die angegebene Sperre wurde nicht gefunden. Vielleicht wurde der Benutzer schon entsperrt?
  • permissiondenied
    • info: Du darfst keine Benutzer entsperren
      • Auf den meisten Wikis dürfen Administratoren entsperren, aber andere Wikis können striktere Regeln haben
Retrieved from "http://www.mediawiki.org/w/index.php?title=API:Block/de&oldid=688474"