Данные, которые транслируются описываемыми шаблонами, могут отличаться от официальных курсов, установленных центральными банками, а также от рыночных курсов, транслируемых через другие информационные каналы. Не используйте их в случаях, когда ошибка может причинить вред или нанести ущерб.
Настоящая документация описывает совместную работу нескольких шаблонов.
Основной шаблон — {{Валютный курс}}, отвечающий за вывод данных в конечных статьях и списках (см. раздел «Примеры использования»).
Автоматически обновляемые шаблоны:
{{Валютный курс/Данные}} — шаблон, где собираются текущие котировки из открытых источников, которые затем использует шаблон {{Валютный курс}};
Все вместе они позволяют отображать в статьях, списках и других шаблонах текущий (автоматически обновляемый не реже одного раза в сутки) валютный курс практически по всем существующим валютам, имеющим код ISO 4217.
Курсы валютных пар рассчитываются автоматически на основе данных, собираемых и обновляемых роботомKrBot из трёх источников (см. раздел «Источники данных»):
Параметры выводимых курсов и отказ от ответственности
Выводимые настоящими шаблонами курсы основаны на открытых источниках и транслируются с округлением до четырёх значимых цифр. Они могут отличаться от официальных котировок, установленных центральными банками, они могут отличаться от курсов, транслируемых другими источниками информации. Не используйте их в случаях, когда ошибка может причинить вред или нанести ущерб.
К сожалению, используемые источники на дают полного набора валютных пар. Мы будем благодарны, если вы предложите источник с лучшими характеристиками.
Требования к источнику информации следующие — он должен:
Предоставлять информацию об актуальных курсах по соизмеримому (не менее 100 валют) или большему числу валют с частотой обновления не реже одного раза в неделю.
В полной мере соответствовать требованиям, предъявляемым к источникам, которые принято использовать для подготовки статей «Википедии».
Предоставлять удобный интерфейс для автоматического забора данных.
Шаблон «Валютный курс/Фиксированные курсы»
Данные шаблона {{Валютный курс/Фиксированные курсы}} (фиксированные курсы, а также курсы с очень узким коридором) приведены со ссылкой на сайты эмитентов или другие языковые разделы «Википедии», прежде всего английский. Данные источники не вполне удобны для автоматического отслеживания, поэтому мы будем признательны, если вы предложите более удачный источник.
В копии шаблона {{Валютный курс/Данные}} скорректируйте набор источников и их порядок. Например, для ukwiki вместо данных ЦБ РФ используются данные НБУ.
Получите для робота KrBot флаг бота в соответствующем проекте.
После этого нужно подождать, когда робот KrBot обновит шаблоны в ruwiki. Если одновременно с этим робот не обновил шаблоны в вашем проекте, то что-то пошло не так. Проверьте, всё ли в порядке с элементами на Викиданных. Убедитесь, что у робота есть флаг бота. Если всё в порядке, но шаблоны так и не обновляются, то обратитесь к участнику Ivan A. Krestinin.
Если нужно использовать ещё какие-либо источники по валютам, то пожалуйста найдите открытый источник актуальных данных. Крайне желательно, чтобы данные были в машиночитаемом формате (JSON, XML, CSV и т. п.) и были предназначены для использования внешними потребителями данных. Иначе механизм будет работать нестабильно. Пример источника: http://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml После нахождения такого источника обратитесь к участнику Ivan A. Krestinin.
How to copy the template to another wiki-project
Data update procedure supports multiple projects. Please make next steps to enable it in another project:
After this please wait for data update in ruwiki. Bot KrBot must update the templates in your project too. Check Wikidata elements and KrBot rights in case some troubles. Request assistance of Ivan A. Krestinin if needed.
Additional open datasources can be added too. The source must have some public API or machine-readable data format (JSON, XML, CSV and etc.) The data request protocol must be adopted for external usage. Source example: http://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml Please contact to Ivan A. Krestinin for implementing data copy algorithm.
