Skip to main content
GET
cURL
Возвращает массив результатов всех формул для указанного item_set в рамках проекта.

Параметры URL

  • project_id (int, path, обязательный) - ID проекта (для валидации принадлежности item_set)
  • item_set_id (int, path, обязательный) - ID item set, для которого нужны результаты

Headers

Описание полей ответа

Возвращается массив объектов с результатами формул:
  • id (integer) - Уникальный идентификатор записи
  • id_formula (integer) - ID формулы из таблицы object.project_formula
  • id_project_item_set_output (integer) - ID project item set processing output
  • id_item_set (integer) - ID item set
  • result (float, nullable) - Результат вычисления (null если была ошибка)
  • error (string, nullable) - Текст ошибки (null если вычисление успешно)
  • created_at (datetime, ISO 8601) - Дата и время создания записи
  • updated_at (datetime, ISO 8601) - Дата и время последнего обновления
  • formula (object) - Объект с информацией о формуле:
    • name (string) - Название формулы
    • text (string) - Текст формулы
    • is_default (boolean) - Флаг, указывающий является ли формула формулой по умолчанию

Пример ответа

Примечания

  • Если вычисление успешно: result содержит число, error = null
  • Если произошла ошибка: result = null, error содержит описание ошибки
  • Каждая формула = отдельная запись в массиве

Логика работы

Когда создаются записи

Записи в таблице output.formula_output создаются автоматически при записи в отчет:
  1. Заполнение отчета Google Sheets
  2. Вычисление формул
  3. Сохранение результатов - для каждой формулы создается отдельная запись:
    • Если вычисление успешно: result = число, error = null
    • Если произошла ошибка: result = null, error = текст ошибки

Структура данных

Принцип: Одна запись = один результат одной формулы для одного item_set Item Set 456 + 3 формулы = 3 записи в таблице

Коды ошибок

Authorizations

API-Access-Key
string
header
required

API-ключ для доступа к эндпоинтам

Path Parameters

project_id
integer
required

ID проекта (для валидации принадлежности item_set)

item_set_id
integer
required

ID item set, для которого нужны результаты

Response

Успешный ответ - возвращает массив результатов всех формул для указанного item_set

id
integer
required

Уникальный идентификатор записи

id_formula
integer
required

ID формулы из таблицы object.project_formula

id_project_item_set_output
integer
required

ID project item set processing output

id_item_set
integer
required

ID item set

created_at
string<date-time>
required

Дата и время создания записи

updated_at
string<date-time>
required

Дата и время последнего обновления

formula
object
required

Объект с информацией о формуле

result
number | null

Результат вычисления (null если была ошибка)

error
string | null

Текст ошибки (null если вычисление успешно)