API:Data formats/de

Eingabe
Die API erhält ihre Eingaben über Parameter aus der HTTP-Abfrage im Format  oder. Jedes Modul und Submodul hat seine eigenen Parameter, die in der Dokumentation und in action=help aufgelistet sind. Sie können auch über erhalten werden.

Codierung
Alle Eingaben sollten gültiges UTF-8 in der NFC-Form sein. MediaWiki wird versuchen, andere Formate zu konvertieren, was zu einem Fehler führen kann.

Parameter mit mehreren Werten
Parameter, die mehrere Werte übernehmen, werden normalerweise übermittelt, indem die Werte durch das Pipe-Zeichen getrennt werden, z.B.. Wenn ein Wert selbst das Pipe-Zeichen enthält, nutze U+001F (Einheitentrenner) als Trennung und stelle dem Wert das Präfix U+001F voran, z.B..

Wenn ein Parameter mehrere Werte akzeptiert, ist dies explizit in seiner Modul-Dokumentation aufgeführt.

Boolesche Parameter
Wenn ein boolescher Parameter in einer HTTP-Abfrage spezifiziert wird, wird dieser unabhängig von seinem Wert als true angenommen. Für einen false-Wert lasse den Parameter komplett weg. Der beste Weg, um einen true-Parameter in einer HTTP-Abfrage zu spezifizieren, ist  zu nutzen; das folgende   stellt sicher, dass der Browser oder die HTTP-Bibliothek den "leeren" einParameter nicht verwirft.

Zeitstempel
Parameters that take timestamp values accept multiple timestamp formats:


 * ISO 8601 format :.
 * MySQL's internal timestamp format :.
 * UNIX timestamp format  ( number of seconds since January 1, 1970 ).
 * UNIX timestamp format  ( number of seconds since January 1, 1970 ).

Timestamps are always output in ISO 8601 format.

Ausgabe
The standard and default output format in MediaWiki is JSON. All other formats are discouraged.

The output format should always be specified using  with yourformat being one of the following:



Antwort
Unless specified, all modules allow data output in all generic formats. To simplify debugging, all generic formats have "pretty-print in HTML" alternatives with an  suffix, e.g..

JSON-Parameter
Die folgenden Parameter können mit  und   verwendet werden:



Zusätzliche Anmerkungen
Clients written in PHP should avoid using the PHP format because it is fundamentally insecure. It is maintained for now only due to its popularity. In those cases, the format specified in the  parameter is only used if there's an error.
 * XML and PHP output formats are deprecated but still in use.
 * There are many conversion libraries and online converters to convert JSON responses to other formats—for example, JSON-CSV converts to Comma-Separated Values.
 * Feed modules like Feed Recent Changes override the standard output format, instead using RSS or Atom, as specified by their  parameter.

Siehe auch

 * - Contains warning and error formats.