VARICA
digital proposal bureau
VARICA / Документация v2

Таблицы в v2

Как передавать строковые данные для таблиц через rows.*, как сервис понимает количество строк и что делать со значениями, в которых есть запятые.

МетодGUIDE Endpointrows.* АвторизацияСправка Входmultipart/form-data ВыходHTML
01 / Раздел

Общий принцип

Во внешнем методе создания страницы таблицы передаются не отдельным JSON-объектом, а набором полей `rows.<mask>`.

Каждое такое поле содержит список значений для строк. Разделитель строк жёстко фиксирован: `|`.

02 / Раздел

Почему не запятая

  • Запятые часто встречаются в деньгах и числах: `100,20`.
  • Запятые встречаются и в обычном тексте.
  • Поэтому разделителем строк выбран `|`, а не запятая.
03 / Раздел

Правила заполнения

  • Обычные поля шаблона передаются как `data.`.
  • Табличные поля шаблона передаются как `rows.`.
  • Если в одном `rows.*` три значения, а в другом пять, сервис создаёт пять строк.
  • Если значений в колонке меньше, недостающие ячейки остаются пустыми.
  • Если в таблице есть обычная маска без префикса `tables.`, она не разворачивает строки и работает как одиночная ячейка.
04 / Раздел

Пример запроса

multipart/form-data
curl -X POST "http://varica.ru/api/v2/pages" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -F "template_id=54" \
  -F "source_entity_id=SOURCE_ENTITY_ID" \
  -F "data.bud_full=100 765" \
  -F "data.bud_m=2 343" \
  -F "data.bud_t=102" \
  -F "data.compan_name=Название компании Рога и копыта" \
  -F "data.data_kp=01.02.2026" \
  -F "data.price=10000" \
  -F "data.resp=Я" \
  -F "data.terms_of_delivery=Доставка" \
  -F "rows.tables.count=1|2|3" \
  -F "rows.tables.name=первый|второй|третий" \
  -F "rows.tables.position_price=100|200|1" \
  -F "rows.tables.price_kg=3,2|5,7|8,1"
05 / Раздел

Как это читать

  • `rows.tables.name=первый|второй|третий` -> в колонке будет 3 строки.
  • `rows.tables.price_kg=3,2|5,7|8,1` -> запятые остаются частью значения, а не разделителем.
  • `rows.tables.position_price=100|200|1` -> число строк определяется по количеству частей после split по `|`.
06 / Раздел

Для ИИ и интегратора

Краткая инструкция
Табличные поля во внешнем API передаются как rows.<mask>.
Разделитель строк только |.
Запятые внутри значений допустимы.
Обычные поля передаются как data.<mask>.