Ctrlk
ДемоОфициальный сайт
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Форматы файлов и правила подготовки данных

Перед использованием модуля «Парсер курсов» — «Курсы из файла» необходимо подготовить файл с курсами в одном из поддерживаемых форматов.

Система автоматически скачивает файл по указанной ссылке, обрабатывает его содержимое, выполняет необходимые вычисления и обновляет курсы в обменном пункте.

Поддерживаемые форматы файлов

Система поддерживает следующие форматы файлов:

Возможность
TXT
CSV
JSON

Простые значения

Да

Да

Да

Математические формулы

Да

Да

Да

Проценты

Да

Да

Да

Ссылки на другие пары

Да

Нет

Нет

Алиасы

Да

Нет

Нет

Несколько пар в одной строке

Да

Нет

Нет

Автоматический расчёт обратных курсов

Да

Нет

Нет

Комментарии

Да

Нет

Нет

Для большинства проектов рекомендуется использовать формат TXT, так как он предоставляет максимальную гибкость и поддерживает все возможности файлового парсера.

Общие требования к файлам

Параметр
Значение

Максимальный размер файла

2 МБ

Кодировка

UTF-8

Поддерживаемые форматы

TXT, CSV, JSON

Тип ссылки

Публичная HTTP или HTTPS ссылка

Пустой файл

Не допускается

Если файл не соответствует указанным требованиям, система не сможет обработать его содержимое.

Правила именования валютных пар

Каждая валютная пара должна иметь корректное название.

Правильные примеры:

Допускаются:

  • латинские буквы;

  • цифры;

  • символ подчёркивания _.

Примеры:

Ограничения:

  • название должно начинаться с латинской буквы;

  • допускаются только латинские буквы, цифры и символ подчёркивания;

  • максимальная длина каждой части пары — 10 символов.

TXT-файл

TXT является основным и наиболее функциональным форматом.

Он поддерживает:

  • фиксированные значения;

  • математические выражения;

  • проценты;

  • ссылки на другие пары;

  • алиасы;

  • несколько пар в одной строке;

  • автоматическое создание обратных курсов.

Простые значения

Самый простой способ указать курс.

Пример:

Несколько пар в одной строке

Можно присвоить одно значение сразу нескольким парам.

Пример:

После обработки обе пары получат одинаковое значение.

Математические выражения

Поддерживаются следующие операции:

Операция
Символ

Сложение

+

Вычитание

-

Умножение

*

Деление

/

Скобки

( )

Пример:

Использование процентов

Система поддерживает работу с процентами.

Примеры:

Пример удержания комиссии 1.5%:

Использование других пар

Одна валютная пара может использовать значение другой пары.

Пример:

После обработки система автоматически рассчитает значение EUR относительно RUB.

Автоматический расчёт обратных курсов

Для получения обратного курса можно использовать существующую пару.

Пример:

Система автоматически определит обратную пару и рассчитает её значение.

Результат:

Пара
Значение

USD - RUB

91.6

RUB - USD

0.010917

Алиасы

Алиасы позволяют использовать короткие имена вместо длинных выражений.

Пример:

В данном примере вместо полного названия пары используется короткое имя MAIN.

Комментарии

В TXT-файлах можно использовать комментарии.

Поддерживаются следующие варианты:

Комментарии полностью игнорируются системой и используются только для удобства оформления файла.

Полноценный пример TXT-файла

CSV-файл

CSV используется для хранения курсов в табличном формате.

Каждая строка должна содержать две колонки:

  1. Валютная пара.

  2. Значение курса.

Пример:

JSON-файл

JSON используется для структурированного хранения данных.

Пример:

Каждый ключ представляет собой валютную пару, а значение содержит курс или формулу для его расчёта.

Что поддерживается

Возможность
Поддерживается

Простые значения

Да

Формулы

Да

Проценты

Да

Ссылки на другие пары

Да

Алиасы

Да

Несколько пар в одной строке

Да

Автоматический расчёт обратных курсов

Да

Комментарии

Да

Что не поддерживается

Следующие конструкции не будут обработаны системой или приведут к ошибке:

Пример
Причина

BTC = RUB

Неверный формат валютной пары

123 - BTC

Название должно начинаться с буквы

Файлы более 2 МБ

Превышен допустимый размер

Кодировка отличная от UTF-8

Не поддерживается

Внутренние ссылки сервера

Не допускаются

Циклические зависимости

Невозможно выполнить расчёт

Скорость обработки файлов

Для повышения производительности система скачивает каждый файл только один раз за цикл обновления.

Даже если один источник содержит десятки или сотни курсов, файл будет загружен один раз, после чего все значения будут использованы для обновления связанных курсов.

Это позволяет существенно снизить нагрузку на сервер и ускорить обновление данных.

Как начать использовать курсы из файла

1

Создайте файл

Создайте файл с курсами в одном из поддерживаемых форматов.

Например:

2

Разместите файл

Загрузите файл на сервер или в облачное хранилище.

Пример ссылки:

Ссылка должна быть прямой и доступной без авторизации.

3

Добавьте источник

Перейдите в раздел: «Парсер курсов» — «Курсы из файла»

Создайте новый источник и укажите ссылку на файл.

4

Добавьте необходимые курсы

Создайте курсы, названия которых полностью совпадают с названиями внутри файла.

5

Используйте курсы

После обновления курсы можно использовать:

  • в направлениях обмена;

  • в формулах;

  • в других связанных разделах системы.

Рекомендации

Для стабильной работы рекомендуется:

  • использовать формат TXT;

  • использовать кодировку UTF-8;

  • не превышать размер файла 2 МБ;

  • использовать понятные названия валютных пар;

  • периодически проверять доступность файла;

  • использовать комментарии для сложных файлов;

  • группировать связанные курсы по логическим блокам.

При соблюдении данных рекомендаций система сможет максимально быстро и корректно обрабатывать ваши курсы.

ПредыдущаяКурсы из файлаСледующаяКурсы конкурентов

Последнее обновление

Это было полезно?