API:Data formats/es

Entrada
La API toma su entrada a través de los parámetros proporcionados por la solicitud HTTP en formato  o. Cada módulo y submódulo tiene su conjunto propio de parámetros, los cuales están listados en la documentación y en $ayuda. También pueden ser recuperados a través de.

Codificando
Toda entrada debe ser válida UTF-8, en forma NFC. MediaWiki intentará convertir otros formatos, lo que puede provocar un error.

Parámetros de valores múltiples
Los parámetros que toman múltiples valores normalmente se envían con los valores separados usando el carácter de canalización, p.ej. . Si un valor contiene el carácter de canalización en sí mismo, usa U+001F (Separador de unidades) como separador y antepón el valor con U+001F, p.ej. .

Si un parámetro acepta valores múltiples es listado explícitamente en la documentación de su módulo.

Parámetros booleanos
Si se especifica un parámetro booleano en una solicitud HTTP, se considera verdadero independientemente de su valor. Para un valor falso, omitir el parámetro por completo. La mejor manera de especificar un parámetro verdadero en una solicitud HTTP es usar ; el   final, asegura que el navegador o la biblioteca HTTP no descarte el "vacío" "someParam".

Marcas de tiempo
Los parámetros que toman valores de marca de tiempo aceptan múltiples formatos de marca de tiempo:


 * Formato ISO 8601:.
 * MySQL's internal timestamp format:.
 * UNIX timestamp format  (número de segundos desde el 1 de enero de 1970).
 * UNIX timestamp format  (número de segundos desde el 1 de enero de 1970).

Timestamps are always output in ISO 8601 format.

Salida
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:

Response
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 parameters
The following parameters can be used with  and  :



Additional notes

 * 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.