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
Parameter, die Werte für Zeitstempel übernehmen, akzeptieren mehrere Zeitstempel-Formate:


 * ISO-8601-Format:.
 * Internes Zeitstempel-Format von MySQL:.
 * UNIX-Zeitstempel-Format  (Anzahl von Sekunden seit dem 1. Januar 1970).
 * UNIX-Zeitstempel-Format  (Anzahl von Sekunden seit dem 1. Januar 1970).

Zeitstempel werden immer im ISO-8601-Format ausgegeben.

Ausgabe
Das Standard-Ausgabeformat in MediaWiki ist JSON. Von allen anderen Formaten wird abgeraten.

Das Ausgabeformat sollte immer durch Nutzung von  mit yourformat als einem der folgenden Formate spezifiziert werden:



Antwort
Sofern nichts anderes angegeben ist, erlauben alle Module die Datenausgabe in allen generischen Formaten. 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.