API:Data formats/ru

Ввод
API принимает входные данные через параметры, предоставляемые HTTP-запросом в формате  или. Каждый модуль и подмодуль обладает собственным набором параметров, которые перечислены в документации и в action=help. Их также можно получить через.

Кодировка
Все вводимые данные должны быть переданы в корректном коде UTF-8, в форме NFC. MediaWiki попытается преобразовать другие форматы. В ходе преобразования может возникнуть ошибка.

Параметры с списком значений
Параметры, которые принимают несколько значений, обычно передаются со значениями, разделенными символом вертикальной черты, например. 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..

Если параметр принимает несколько значений, это явно указано в документации к модулю.

Булевы параметры
Булевы параметры работают, как флажки HTML: если параметр указан в HTTP-запросе, он вне зависимости от значения считается истинным. Для указания ложного значения параметр следует полностью опустить. Лучший способ указать истинный параметр в HTTP-запросе — это использование ; завершающий знак   не допускает отбрасывания «пустого» параметра браузером или HTTP-библиотекой.

Временные отметки
Параметры, принимающие временные отметки, способны принять несколько форматов временных отметок:


 * формат ISO 8601:.
 * Внутренний формат временных отметок MySQL:.
 * Формат временных отметок Unix  (время, прошедшее с 1 января 1970 года, в секундах).
 * Формат временных отметок Unix  (время, прошедшее с 1 января 1970 года, в секундах).

Временные отметки в выходных данных всегда находятся в формате ISO 8601.

Выход
Стандартный формат и формат вывода по умолчанию в MediaWiki — JSON. Все остальные форматы не рекомендуется.

The output format should always be specified using  with yourformat being one of the following:

Ответ
Если не указано иное, все модули поддерживают вывод данных во всех обобщённых форматах. Для облегчения отладки все обобщённые форматы имеют форматирующие в HTML альтернативы с окончанием.

Параметры JSON
The following parameters can be used with  and  :



Additional notes

 * Выходные форматы XML и PHP устарели, но все еще используются. Клиентам, написанным на PHP, следует избегать использования формата PHP, поскольку он фундаментально небезопасен. Он поддерживается на данный момент только ввиду его популярности.
 * Существует большое количество библиотек и онлайн-ресурсов для преобразования ответов в формате JSON в другие форматы, например, JSON-CSV преобразовывает JSON в CSV.
 * Модули лент, наподобие ленты свежих правок, переопределяют стандартный формат вывода, вместо этого используя RSS или Atom, как указано в их параметре . В этих случаях формат, указанный в параметре   используется только при возникновении ошибки.

См. также

 * - Содержит форматы предупреждений и ошибок.