API:Errors and warnings/de

Wenn bei einer API-Abfrage etwas schief geht, wird ein Fehler oder eine Warnung ausgegeben (obwohl die HTTP-Antwort normalerweise trotzdem  ist). Bei nicht schwerwiegenden Bedingungen wie ungültigen Parametern werden Warnungen ausgegeben, während Fehler nur bei schwerwiegenden Bedingungen ausgegeben werden.

Warnungen
Warnungen werden nach dem Namen des Moduls gruppiert, das sie verursacht hat. Mehrere Warnungen desselben Moduls werden durch eine neue Zeile getrennt. Im Legacy-Modus der Fehlerformatierung (siehe unten), welcher der Standard ist, werden Warnungen im folgenden Format ausgegeben:

( wird durch   ersetzt, wenn   genutzt wird.)

Wenn eine Nicht-Legacy-Option zur Fehlerformatierung genutzt wird, werden Warnungen im selben Format ausgegeben wie Fehler. Mit ist das Format beispielsweise: ( will be replaced with   when    is used.)



Error formats
Since MediaWiki 1.29 errors are localizable, and available in multiple formats. An error (or warning) is expected to consist of a message, an error code (an arbitrary string, usually generated from the message key; see also below), and optional extra data (an associative array). An API response with errors will look like this:

The  key in the output above will be missing if there is no extra data to display.

The way the error message in the output above is returned to the client is controlled by the  API parameter. The various error formats available are:

For the formatting modes which involve message lookup (,  and  ) the API parameter   can be used to set the language (only needed when different from the content language) and   to set whether the MediaWiki: namespace can be used to override default error messages.

Error codes are also returned in the  response HTTP header, separated by commas when there are multiple errors.

For an example error response or to test your client's error handling, visit https://en.wikipedia.org/w/api.php?action=blah&errorformat=plaintext&format=jsonfm&formatversion=2

When  is not set (or set to  ), errors will be displayed in the legacy format instead.

Legacy format
In the legacy error format, there is always at most one error; additional ones are discarded. The response looks like this:

The extra data in the output above is spliced into the object instead of being under the  key.

Error messages in documentation
Error messages are documented in this wiki as shown below, which corresponds to the json error response in above:

The various error messages are:



Standard-Fehlermeldungen
Einige generische Fehlermeldungen werden von den Modulen gemeinsam genutzt. Wenn ein Modul diese Fehler ausgeben kann, wird dies ausdrücklich im Abschnitt erwähnt.



Zusätzliche Anmerkungen

 * Alle oben genannten Ausgaben von Fehlern und Warnungen nutzen . Für   wird das Feld   durch   ersetzt.