API:Data formats/ja

入力
APIは，入力を受け取る際， 又は 形式のHTTP要求が提供したパラメータを介します. 全モジュール及び下位モジュールは自身のパラメータ郡を持っており，文書及びaction=helpにて一覧できます. を介して取得することも可能です.

符号化
全ての入力は形式Cで正規化された妥当なUTF-8であるべきです. メディアウィキは他の形式への変換を試みますが，失敗に終わる恐れがあります.

複数値のパラメータ
Parameters that take multiple values are normally submitted with the values separated using the pipe character, e.g.. If a value contains the pipe character in itself, use U+001F (Unit Separator) as the separator and prefix the value with U+001F, e.g..

Whether a parameter accepts multiple values is listed explicitly in its module documentation.

真偽値のパラメーター
If a boolean parameter is specified in an HTTP request, it is considered true regardless of its value. For a false value, omit the parameter entirely. The best way to specify a true parameter in an HTTP request is to use ; the trailing   ensures the browser or HTTP library does not discard the "empty" someParam.

タイムスタンプ
Parameters that take timestamp values accept multiple timestamp formats:


 * ISO 8601 format:.
 * MySQL's internal timestamp format:.
 * UNIX タイムスタンプ形式  (1970年1月1日からの経過秒数).
 * UNIX タイムスタンプ形式  (1970年1月1日からの経過秒数).

Timestamps are always output in ISO 8601 format.

出力
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:

レスポンス
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 パラメーター
The following parameters can be used with  and  :



追加的な注記

 * XML and PHP output formats are deprecated but still in use. 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.
 * 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. In those cases, the format specified in the   parameter is only used if there's an error.

関連項目

 * - Contains warning and error formats.