The version of the API which should be used. This
affects both parameter parsing, and the result. Version changes are
documented in a separate chapter.
If no version is specified, a warning message will be issued and
the services will default to version 1.
The services support data output in different formats.
By default, the answer is returned in JSON format, but it is also possible to
supported by specific services. Please see the documentation for the individual
services for more details. Note that the plain text and binary output method may also
include a CSV representation.
specify the parameters
For output in plain text and binary formats, please also specify
template parameter to select the desired format.
blob (for binary) or
Set this parameter to 1 to receive the XML or
unset, the output will be returned in compact form. This parameter is not
applicable to the plain text output format.
This parameter controls the desired charset of the
response. For XML and JSON output, characters which cannot be represented by
the desired charset, will be represented by the corresponding XML character
ø) or Unicode escape sequence (e.g.
\u00f8). For plain text output, those characters will be
approximated by one or more similarly looking characters, or substituted by a
question mark (
Accepted values: UTF-8, ISO-8859-1, ASCII
This parameter switches the output method to JSON-P
and allows to specify the method name that should receive the result. You can
choose this identifier freely to suit your needs.
Condition: only required for JSON-P output.
This parameter switches the output method to
(Only for plain text output) Specify the template that
should be used for the plain text output format. The list of available templates
can be found in the individual service documentation.
Accepted values: dependent on the called service.
Condition: only required for plain text output.
General Response Elements.
Every response will include this element. The value
will be set to
1 unless the API has to be changed in an
incompatible way (i.e. an element was removed, renamed or changed its type
– an addition may happen without increase in the version
|error (XML), errors (JSON)||
This element will only be included in the response if
errors occurred while processing your request. In this case, the response will
not contain further elements.
For the XML format, the element will be repeated as many times as
necessary, while for the JSON format, the messages are modeled as an array.
Type: String (XML), array of strings (JSON)