Skip to main content
GET
/
output
/
formulas
/
project
/
{project_id}
/
item-set
/
{item_set_id}
cURL
curl --request GET \
  --url https://api.spellit.ai/api/output/formulas/project/{project_id}/item-set/{item_set_id} \
  --header 'API-Access-Key: <api-key>'
[
  {
    "id": 1,
    "id_formula": 5,
    "id_project_item_set_output": 123,
    "id_item_set": 456,
    "result": 4.5,
    "error": null,
    "created_at": "2025-11-17T10:00:00Z",
    "updated_at": "2025-11-17T10:00:00Z",
    "formula": {
      "name": "total_score",
      "text": "AVG(score_i WHERE score_i != '')",
      "is_default": true
    }
  },
  {
    "id": 2,
    "id_formula": 6,
    "id_project_item_set_output": 123,
    "id_item_set": 456,
    "result": null,
    "error": "Division by zero",
    "created_at": "2025-11-17T10:00:01Z",
    "updated_at": "2025-11-17T10:00:01Z",
    "formula": {
      "name": "average_rating",
      "text": "SUM(rating) / COUNT(rating)",
      "is_default": false
    }
  },
  {
    "id": 3,
    "id_formula": 7,
    "id_project_item_set_output": 123,
    "id_item_set": 456,
    "result": 8.234567,
    "error": null,
    "created_at": "2025-11-17T10:00:02Z",
    "updated_at": "2025-11-17T10:00:02Z",
    "formula": {
      "name": "max_value",
      "text": "MAX(value_i)",
      "is_default": false
    }
  }
]
Возвращает массив результатов всех формул для указанного item_set в рамках проекта.

​
Параметры URL

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

​
Headers

API-Access-Key: {token}

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

Возвращается массив объектов с результатами формул:
  • 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) - Флаг, указывающий является ли формула формулой по умолчанию

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

[
  {
    "id": 1,
    "id_formula": 123,
    "id_project_item_set_output": 456,
    "id_item_set": 448,
    "result": 85.5,
    "error": null,
    "created_at": "2024-01-01T00:00:00",
    "updated_at": "2024-01-01T00:00:00",
    "formula": {
      "name": "total_score",
      "text": "AVG(score_i WHERE score_i != '')",
      "is_default": true
    }
  }
]

​
Примечания

  • Если вычисление успешно: 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 записи в таблице
idid_formulaid_item_setresulterror
154564.5null
26456null”Division by zero”
374568.2null

​
Коды ошибок

HTTP КодОписаниеРекомендуемое действие
200УспешноОбработать результаты
401Не авторизованОбновить/получить новый JWT токен
404Item set не найденПроверить корректность project_id и item_set_id
422Ошибка валидацииПроверить формат параметров (должны быть integer)
500Ошибка сервераПовторить запрос или обратиться в поддержку

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 если вычисление успешно)