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:.
 * Formato de marca de tiempo interno de MySQL:.
 * Formato de marca de tiempo interno de UNIX  (número de segundos desde el 1 de enero de 1970).
 * Formato de marca de tiempo interno de UNIX  (número de segundos desde el 1 de enero de 1970).

Las marcas de tiempo siempre salen en formato ISO 8601.

Salida
El formato de salida estándar y predeterminado en MediaWiki es JSON. Todos los demás formatos están desaconsejados.

El formato de salida siempre debe especificarse usando, siendo yourformat uno de los siguientes:



Respuesta
A menos que se especifique, todos los módulos permiten la salida de datos en todos los formatos genéricos. Para simplificar la depuración, todos los formatos genéricos tienen alternativas de "impresión bonita en HTML" con un sufijo, p.ej. .



Parámetros JSON
Los siguientes parámetros se pueden usar con  y  :





Notas adicionales
. En esos casos, el formato especificado en el parámetro solo se usa si hay un error.
 * Los formatos de salida XML y PHP están obsoletos pero todavía se usan. Los clientes con escritos en PHP deben evitar usar el formato PHP porque es fundamentalmente inseguro. Está mantenido por ahora sólo debido a su popularidad.
 * Hay muchas bibliotecas de conversión y convertidores en línea para convertir respuestas JSON a otros formatos—por ejemplo, JSON-CSV convierte a valores-separados por comas.
 * Los módulos feed como Alimentar cambios recientes anulan el formato de salida estándar, en lugar de usar RSS o Atom, según lo especificado por su parámetro



Véase también

 * - Contiene aviso y formatos de error.