API:Block/de

Token
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:

Benutzer sperren
Benutzer können mit action=block gesperrt werden.

Parameter

 * : Der Benutzername, die IP-Addresse oder die IP-Range, die gesperrt werden soll.
 * : Das Token, das in der vorherigen Anfrage geholt wurde. Dabei sollte man darauf achten, dass das  als   codiert wird.
 * : Ist dieses Flag gesetzt, erhält man ein Sperrtoken.
 * : Zeitstempel für das Ende der Sperre. Relative Angaben wie  oder   werden auch angenommen. Ist der Wert auf ,  ,  oder gar nicht gesetzt, endet die Sperre nie.
 * : Die Begründung für die Sperre (optional).
 * : 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.
 * : Ist dieses Flag gesetzt, wird das Anlegen neuer Benutzer von der gesperrten IP verhindert.
 * : 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.
 * : Ist dieses Flag gesetzt, kann der Benutzer keine E-Mails mehr über Special:Emailuser versenden.

Beispiel
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.

Mögliche Fehler
Zusätzlich zu dem normalen Kram:


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

Benutzer entsperren
Benutzer können mit action=unblock entsperrt werden.

Parameter

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

Mögliche Fehler
Zusätzlich zu dem normalen Kram:


 * Einer der Parameter id und user muss gesetzt sein, keiner ist gesetzt
 * Der Parameter token ist nicht gesetzt (muss gesetzt sein)
 * Nur einer der Parameter id und user darf gesetzt sein, beide sind gesetzt
 * info: Die IP-Addresse wurde als IP-Range gesperrt und kann auch nicht einzeln entsperrt werden
 * Die angegebene Sperre wurde nicht gefunden. Vielleicht wurde der Benutzer schon entsperrt?
 * info: Du darfst keine Benutzer entsperren
 * Auf den meisten Wikis dürfen Administratoren entsperren, aber andere Wikis können striktere Regeln haben
 * info: Die IP-Addresse wurde als IP-Range gesperrt und kann auch nicht einzeln entsperrt werden
 * Die angegebene Sperre wurde nicht gefunden. Vielleicht wurde der Benutzer schon entsperrt?
 * info: Du darfst keine Benutzer entsperren
 * Auf den meisten Wikis dürfen Administratoren entsperren, aber andere Wikis können striktere Regeln haben
 * info: Du darfst keine Benutzer entsperren
 * Auf den meisten Wikis dürfen Administratoren entsperren, aber andere Wikis können striktere Regeln haben