API:Errors and warnings/de

From MediaWiki.org
Jump to: navigation, search
Tools clipart.png Diese Seite ist Teil der MediaWiki action API-Dokumentation.
MediaWiki APIAPI:Main page

MediaWiki action API

v · d · e

Wenn bei einer API-Anfrage ein Problem auftritt, liefert die API als Antwort einen Fehler oder eine Warnung. Warnungen treten bei nicht-kritischen Problemen wie z.B. ungültigen Parametern auf, während Fehler nur in kritischen Situationen zurückgegeben werden. Die Fehlermeldungen sind immer und in jedem Fall Englisch, egal welche Sprache die gerade bearbeitete MediaWiki-Version hat.

Warnungen[edit]

Warnungen werden in folgendem Format zurückgegeben:

<?xml version="1.0" encoding="utf-8"?>
<api>
  <warnings>
    <query>Warnhinweis
Noch eine Warnung</query>
    <info>Eine Warnung von prop=info</info>
  </warnings>
</api>

Wie im Beispiel gezeigt werden Warnungen in Gruppen zusammengefasst, die dem auslösenden Modul entsprechen. Mehrere Warnungen vom gleichen Modul werden durch einen Zeilenwechsel voneinander getrennt.

Warnungen, die von der Parameter-Prüfung erzeugt werden[edit]

Die folgenden Warnungen können zurückgegeben werden, wenn bei der Gültigkeitsprüfung der Parameter Unstimmigkeiten auftreten - die Warnungen können also von jedem Modul erzeugt werden. paramname wird hierbei durch den Namen des Fehler-verursachenden Parameter ersetzt.

  • Too many values supplied for parameter 'paramname': the limit is limit
    Zu viele Werte angegeben für den Parameter 'paramname': Der Grenzwert ist limit
  • Unrecognized value for parameter 'paramname': value
    Unbekannter Wert für den Parameter 'paramname': Wert
  • Unrecognized values for parameter 'paramname': value1, value2, value3
    Unbekannte Werte für den Parameter 'paramname': Wert1, Wert2, Wert3

Fehler[edit]

Fehlermeldungen werden in folgendem Format zurückgegeben:

<error code="code" info="info" />

Hierbei wird code durch einen kurzen, nicht zwingend eindeutigen Fehlercode und info durch eine etwas ausführlichere (und eindeutige) Fehlerbeschreibung ersetzt.

In der folgenden Dokumentation werden diese Informationen wiedergegeben als:

  • code: Fehlercode
    • info: Von der API gelieferte Information
    • deutsch: Deutsche Übersetzung / Erklärung der Fehlermeldung (Zusatz, nicht aus der API)

Parameter-Gültigkeitsprüfungsfehler[edit]

Die folgenden Fehlermeldungen können von jedem Modul bei der Gültigkeitsprüfung der eingehenden Parameter erzeugt werden. paramname wird hierbei durch den Namen des Fehler-verursachenden Parameter ersetzt.

  • code: multival_paramname
    • info: Only one of 'value1', 'value2', 'value3' is allowed for parameter 'paramname'
    • Deutsch: Nur einer der Werte 'Wert1', 'Wert2', 'Wert3' ist für den Parameter 'paramname' erlaubt
  • code: unknown_paramname
    • info: Unrecognized value for parameter 'paramname': value
    • Deutsch: Nicht erkannter Wert für den Parameter 'paramname': Wert
  • code: paramname
    • info: paramname may not be set to less than min (set to value)
    • Deutsch: Der Parameter paramname darf nicht kleiner sein als Minimum (gegeben: Wert)
  • code: paramname
    • info: paramname may not be set over max (set to value) for bots and sysops
    • Deutsch: Der Parameter paramname darf für Bots und Admins nicht größer sein als Maximum (gegeben: Wert)
  • code: paramname
    • info: paramname may not be set over max (set to value) for users
    • Deutsch: Der Parameter paramname darf für Benutzer nicht größer sein als Maximum (gegeben: Wert)
  • code: badtimestamp_paramname
    • info: Invalid value value for timestamp parameter paramname
    • Deutsch: Ungültiger Wert Wert für die Zeitangabe paramname
  • code: baduser_paramname
    • info: Invalid value value for user parameter paramname
    • Deutsch: Ungültiger Wert Wert für den Benutzernamen-Parameter paramname
  • code: invalidparammix
    • info: The parameters param1, param2, param3 cannot be used together
    • Deutsch: Die Parameter Name1, Name2 und Name3 können nicht zusammen benutzt werden
  • code: missingparam
    • info: One of the parameters param1, param2, param3 is required
    • Deutsch: Einer der Parameter Name1, Name2 oder Name3 muss gesetzt sein

Standard-Fehlermeldungen[edit]

Einige typische Fehlermeldungen können von mehreren Modulen erzeugt werden. Wenn ein Modul diese Fehler erzeugen kann, wird gezielt darauf in der Modul - Beschreibung im Abschnitt Mögliche Fehler hingewiesen.

  • code: unknownerror
    • info: Unknown error
    • Deutsch: Unbekannter Fehler. Dies ist MediaWikis Version eines Blue Screen of Death und bezeichnet einen unerwarteten Ausnahmezustand. Wer diesen Fehler bekommt, sollte entweder die Anfrage wiederholen, bis eine eindeutige Fehlermeldung oder ein Resultat vorliegt, oder - bei reproduzierbarem Auftreten eines solchen Fehlers - die Entwickler benachrichtigen.
  • code: unknownerror
    • info: Unknown error errorcode
    • Deutsch: Unbekannter Fehler errorcode. Im Vergleich zur vorherigen Meldung heisst dies nur, dass das Modul einen bislang nicht definierten Fehler ausgelöst hat.
  • code: unsupportednamespace
    • info: Pages in the Special namespace can't be edited
    • Deutsch: Artikel / Seiten im Namensraum namespace können nicht bearbeitet werden
  • code: protectednamespace-interface
    • info: You're not allowed to edit interface messages
    • Deutsch: Dir fehlt die Berechtigung, GUI-Nachrichten / Systemtexte zu bearbeiten
  • code: protectednamespace
    • info: You're not allowed to edit pages in the ``namespace'' namespace
    • Deutsch: Du darfst keine Seiten im Namensraum namespace bearbeiten.
  • code: customcssjsprotected
    • info: You're not allowed to edit custom CSS and JavaScript pages
    • Deutsch: Du darfst keine personalisierten CSS und JS - Seiten bearbeiten
  • code: cascadeprotected
    • info: The page you're trying to edit is protected because it's included in a cascade-protected page
    • Deutsch: Die Seite, die du bearbeiten willst, ist kaskadierend geschützt.
  • code: protectedpage
    • info: The ``right'' right is required to edit this page
    • Deutsch: Du brauchst das right-Recht, um diese Seite bearbeiten zu dürfen
  • code: permissiondenied
    • info: Permission denied
    • Deutsch: Zugriff verweigert
  • code: confirmemail
    • info: You must confirm your e-mail address before you can edit
    • Deutsch: Du benötigst eine bestätigte EMail - Adresse, bevor du Seiten bearbeiten kannst
  • code: blocked
    • info: You have been blocked from editing
    • Deutsch: Du wurdest gesperrt
  • code: autoblocked
    • info: Your IP address has been blocked automatically, because it was used by a blocked user
    • Deutsch: Deine IP-Addresse wurde automatisch gesperrt, weil sie von einem gesperrten Benutzer genutzt wurde.
  • code: ratelimited
    • info: You've exceeded your rate limit. Please wait some time and try again
    • Deutsch: Du hast eine Abfrage - Grenze überschritten. Bitte warte einen Augenblick und versuche es erneut
  • code: readonly
    • info: The wiki is currently in read-only mode
    • Deutsch: Das Wiki ist zur Zeit nur lesbar
  • code: badtoken
    • info: Invalid token
    • Deutsch: Falscher token (üblicherweise ein sicheres Zeichen dafür, dass man das Bearbeitungs- oder Verschiebe-Token nicht angefordert hat oder es nicht sauber übergeben hat)
  • code: missingtitle
    • info: The page you requested doesn't exist
    • Deutsch: Die angeforderte Seite existiert nicht.
  • code: hookaborted
    • info: The modification you tried to make was aborted by an extension hook
    • Deutsch: Die gewünschte Änderung wurde von einer Erweiterung abgebrochen.
  • code: nosuchuser
    • info: The user you specified doesn't exist
    • Deutsch: Der angegebene Benutzer existiert nicht
  • code: invalidtitle
    • info: Bad title ``title''
    • Deutsch: Ungültiger Titel title
  • code: invaliduser
    • info: Invalid username ``username''
    • Deutsch: Ungültiger Benutzername username
Sprache:Project:Language policy English  • Deutsch • español • français • 日本語 • 한국어