API:User group membership/de

From MediaWiki.org
Jump to navigation Jump to search

Token[edit]

MediaWiki version: 1.16

Um die Rechte eines Benutzers zu ändern, wird ein Benutzerrechtetoken benötigt. Dieses Token entspricht nicht dem Bearbeitungstoken, sondern hängt von dem Benutzer ab, dessen Rechte geändert werden sollen. Ein Benutzerrechtetoken kann folgendermaßen abgefragt werden:

Benutzer zu Gruppen hinzufügen und aus ihnen entfernen[edit]

Benutzer können mittels action=userrights zu Gruppen hinzugefügt und aus ihnen entfernt werden.

Parameter[edit]

  • user: Der Name des Benutzers, dessen Rechte geändert werden sollen.
  • token: Das Token, das durch die vorige Abfrage ausgegeben wurde. Achte darauf, das "+\" zu "%2B%5C" zu kodieren.
  • add: Eine per | getrennte Liste von der Gruppen, zu denen der Benutzer hinzugefügt werden soll. Gruppen, in denen der Benutzer bereits Mitglied ist und solche, deren Mitgliedschaft du nicht erteilen darfst, werden ignoriert.
  • remove: Eine per | getrennte Liste von der Gruppen, aus denen der Benutzer entfernt werden soll. Gruppen, in denen der Benutzer kein Mitglied ist und solche, deren Mitgliedschaft du nicht entziehen darfst, werden ignoriert.
  • reason: Grund für die Änderung (optional).

Beispiel[edit]

Hinweis: In diesem Beispiel werden alle Parameter der Einfachtheit halber in einer GET-Anfrage übergeben. action=userrights erfordert jedoch POST-Anfragen, GET-Anfragen werden einen Fehler verursachen.

Hinweis: Wenn du nicht berechtigt bist, Benutzer zu Gruppen hinzuzufügen oder aus ihnen zu entfernen, bekommst du keine Fehlermeldung, sondern ein Ergebnis mit leeren <added />- und <removed />-Tags angezeigt, da alle angegebenen Gruppen stillschweigend ignoriert werden.

Mögliche Fehler[edit]

Alle Fehler sind folgendermaßen formatiert:

<error code="code" info="info">
  • code: nouser
    • info: The user parameter must be set
    • Deutsch: Der user-Parameter muss gesetzt werden.
  • code: nosuchuser
    • info: User ``user'' doesn't exist
    • Deutsch: Der angegebene Benutzer existiert nicht.
      • Dies kann auftreten, wenn versucht wird, die Rechte eines anonymen Benutzers zu ändern.
  • code: notoken
    • info: The token parameter must be set
    • Deutsch: Der token-Parameter muss gesetzt werden.
  • code: badtoken
    • info: Invalid token
    • Deutsch: Das Token ist ungültig.
  • code: readonly
    • info: The wiki is in read-only mode
    • Deutsch: Das Wiki befindet sich im Nur-Lese-Modus.
      • Im Nur-Lese-Modus können keinerlei Änderungen vorgenommen werden.