Список

Примечание

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

Весь список с постраничной выдачей

POST https://do.freshoffice.ru/common/list/paging/2?columns=id,note

Query Parameters

Name Type Description
columns* String Список колонок
records_onpage Int Записей на странице, но не более 500
page Int Номер страницы
sorting_column String Колонка сортировки
sorting_direction Int Сортировка 0 Asc 1 Desc 
curl --location --request POST 'https://do.freshoffice.ru/common/list/paging/2?columns=id,note,status_id,date_start,user_id,company_id&records_onpage=50&page=1' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw 'null'

Columns

Имя Описание
id Идентификатор задачи
note Текст задачи
status_id Статус: 1 — в работе, 2 — выполнена
status Статус текстом
type_id Идентификатор вида задачи
type Вид задачи текстом
date_start Дата/время начала
date_finish Дата/время завершения
result Результат выполнения
user_id Идентификатор исполнителя
user_name Исполнитель
company_id Идентификатор контрагента
company_name Наименование контрагента
deal_id Идентификатор сделки
contact_id Идентификатор контактного лица
is_hot Признак срочной задачи
tags Теги

Фильтрация

Фильтры добавляются к запросу как query-параметры и сочетаются между собой:

  • company_id — код контрагента, только задачи одной компании: ?company_id=368132
  • deal_id — код сделки, только задачи одной сделки: ?deal_id=12345
  • user_ids — коды исполнителей, один или несколько: ?user_ids=37 или ?user_ids=1,3,5
  • date1 — с даты (формат YYYY-MM-DD): ?date1=2026-08-01
  • date2 — по дату (формат YYYY-MM-DD): ?date2=2026-08-31
  • tags — теги через запятую: ?tags=срочно

Пример — задачи одного контрагента за август:

curl --location --request POST 'https://do.freshoffice.ru/common/list/paging/2?columns=id,note,date_start&company_id=368132&date1=2026-08-01&date2=2026-08-31' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw 'null'

Примечание

Это общий паттерн: пагинация и фильтры работают одинаково во всех модулях универсального списка common/list/paging/{модуль} — подробное описание на странице списка сделок.

Быстрый список по контрагенту

GET https://do.freshoffice.ru/task/list?company_id=368132

Упрощённый метод без пагинации: возвращает все задачи одного контрагента. Чтобы получить только задачи, привязанные к конкретной сделке, добавьте deal_id:

GET https://do.freshoffice.ru/task/list?company_id=368132&deal_id=12345

Query Parameters

Name Type Description
company_id* Int ID контрагента
deal_id Int Только задачи этой сделки. Опционально 
curl --location --request GET 'https://do.freshoffice.ru/task/list?company_id=368132' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX'

Ответ

{
  "status": "success",
  "error": "",
  "code": null,
  "rows": 0,
  "pages": 0,
  "page": 0,
  "value": "[ { ...задача... }, { ...задача... } ]"
}
// value - JSON-массив задач
Предыдущая
Задачи
Следующая
Добавление