API:Data formats/pt-br

Entradas
A API recebe sua entrada através de parâmetros fornecidos pela string de consulta ou de uma entidade POST em application/x-www-form-urlencoded ou formato multipart/form-data. Cada módulo (e cada submodulo action=query) tem seu próprio conjunto de parâmetros, listado na documentação em action=help, e pode ser recuperado por meio de action=paraminfo.

Codificando
Todas as entradas devem ser válidas em UTF-8, na forma equivalencia Unicode O MediaWiki tentará converter outros formatos. Isso pode resultar em um erro.

Múltiplos parâmetros
Alguns parâmetros aceitam vários valores, separados por um caractere de pipe. Por exemplo, para enviar os três valores

,, and   para o parâmetro  , deve adicionar   na consulta. Se um parâmetro aceita vários valores é listado explicitamente em  e. A documentação não distingue explicitamente os parâmetros de vários valores, mas as descrições desses parâmetros geralmente estão nos moldes de "Uma lista de ..." ou "Uma lista separada por canal de ...".

If you need to submit a list of values where some of the values contain a pipe character (which should be rare - most multivalue parameters are lists of page titles or usernames, neither of which can contain pipes), you can use the unit separator character instead:  (where   stands for U+001F) will submit the three values ,   and. (Note that there is an extra  at the beginning. This is mandatory to avoid ambiguity around submitting a single value containing a pipe.)

Valores boleanos
Boolean parameters work like HTML checkboxes: if the parameter is specified in the HTTP request, regardless of value, it is considered true. 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.

Timestamps
Os parâmetros que usam valores de data e hora aceitam vários formatos:


 * formato ISO 8601:
 * 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)

In the output, timestamps are always in ISO 8601 format.

Saídas
MediaWiki API has historically supported a number of different formats, but this has significantly complicated further development. We would like to standardize on just one JSON format. For now, MediaWiki discourages, but still supports two additional generic output formats (XML and PHP). You should always specify the format with the input (request) parameter  and a lowercase value. 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. Todos os formatos JSON são depreciados. XML and PHP are still supported, but all others have been removed in either MediaWiki 1.26 or 1.27; see the table below. All new API users should use JSON. 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.

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.

The default format changed in MediaWiki 1.25 to ; it was   in earlier MediaWiki releases.

Note that while the pretty-print formats are all indented and separate syntactic elements with newlines, the non-pretty formats don't do this.

There are many conversion libraries and online converters to convert JSON responses to other formats—for example, JSON-CSV converts to Comma-Separated Values

parametros JSON
and  aceitam os seguintes parâmetros adicionais:


 * Specify  for to get json (and php) format responses in a  cleaner format. This also encodes most non-ASCII characters as UTF-8.
 * Specify  for to get json (and php) format responses in a  cleaner format. This also encodes most non-ASCII characters as UTF-8.
 * Specify  for to get json (and php) format responses in a  cleaner format. This also encodes most non-ASCII characters as UTF-8.

Restrição de retorno
When using JSON in callback mode, a number of things are disabled for security:


 * Tokens cannot be obtained (so state-changing actions aren't possible)
 * The client is treated as an anonymous user (i.e. not logged in) for all purposes, even after logging in through action=login
 * This means that things that require additional rights, such as, won't work unless anonymous users are allowed to use them

Exemplos
it may be useful to add the '&indexpageids' parameter, to parse the json if the pageid ("736") is not known before the result.