Itecho ERP

Задачи

⚠ DELETE не поддерживается. Route::resource('tasks', ...)->except(['destroy']) — маршрут удаления не зарегистрирован. Запрос DELETE /api/tasks/{id} вернёт 405 Method Not Allowed.

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

Метод
GET
URL
https://api.gigma.ru/api/tables/tasks
Авторизация
Bearer token
Headers
Authorization: Bearer {token}

Параметры запроса

  • query — поисковая строка (min: 3 символа)
  • date_from — фильтр по дате (от)
  • date_to — фильтр по дате (до)
  • creator_id[] — массив ID создателей задачи
  • executor_id[] — массив ID исполнителей задачи
  • order_id[] — массив ID заказов
  • task_status_id[] — массив ID статусов (GET /api/task_statuses): 1=В работе, 2=Просрочена, 3=Выполнена
  • page — текущая страница
  • per_page — кол-во элементов на странице

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

https://api.gigma.ru/api/tables/tasks?task_status_id[]=1&executor_id[]=5

Ответ

При успешном действии возвращается HTTP код 200.

{
    "columns": [
        {"id": 1, "table_id": 3, "order": 0, "key": "id", "has_icon": 0, "text": "№"},
        {"id": 2, "table_id": 3, "order": 1, "key": "name", "has_icon": 0, "text": "Название"},
        {"id": 3, "table_id": 3, "order": 2, "key": "executor", "has_icon": 1, "text": "Исполнитель"},
        {"id": 4, "table_id": 3, "order": 3, "key": "status", "has_icon": 0, "text": "Статус"},
        {"id": 5, "table_id": 3, "order": 4, "key": "started_at", "has_icon": 0, "text": "Начало"},
        {"id": 6, "table_id": 3, "order": 5, "key": "finished_at", "has_icon": 0, "text": "Срок"}
    ],
    "tasks": [
        {
            "id": 12,
            "name": "Позвонить клиенту",
            "executor": {
                "icon": "https://api.gigma.ru/storage/uploads/default.svg",
                "value": "Иванов Алексей"
            },
            "status": {
                "icon": "https://api.gigma.ru/storage/uploads/default.svg",
                "value": "В работе"
            },
            "started_at": "16.05.2026 09:00",
            "finished_at": "16.05.2026 18:00"
        }
    ],
    "pagination": {
        "total": 1,
        "per_page": 10,
        "current_page": 1,
        "last_page": 1,
        "from": 1,
        "to": 1
    }
}
Описание полей ответа
  • columns — массив столбцов таблицы
  • tasks — массив задач
  • pagination — объект пагинации

Получение списка задач (JSON)

Метод
GET
URL
https://api.gigma.ru/api/tasks
Авторизация
Bearer token
Headers
Authorization: Bearer {token}

Параметры запроса

Те же фильтры, что и в табличном представлении.

Ответ

При успешном действии возвращается HTTP код 200.

{
    "tasks": [
        {
            "id": 12,
            "name": "Позвонить клиенту",
            "started_at": "2026-05-16T09:00:00.000000Z",
            "finished_at": "2026-05-16T18:00:00.000000Z",
            "create_everyday": false,
            "duration": "9 ч",
            "executor": {
                "id": 5,
                "name": "Иванов Алексей"
            },
            "creator": {
                "id": 1,
                "name": "Полищук Артём"
            },
            "status": {
                "id": 1,
                "name": "В работе"
            },
            "order": {
                "id": 42,
                "name": "Заказ №42"
            },
            "object": null,
            "notifications": [],
            "stage": null,
            "progress": null
        }
    ],
    "tasksCount": 1
}

Получение выбранной задачи

Метод
GET
URL
https://api.gigma.ru/api/tasks/{id}
Авторизация
Bearer token
Headers
Authorization: Bearer {token}

Параметры запроса

Параметры не передаются.

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

https://api.gigma.ru/api/tasks/12

Ответ

При успешном действии возвращается HTTP код 200.

{
    "task": {
        "id": 12,
        "name": "Позвонить клиенту",
        "started_at": "2026-05-16T09:00:00.000000Z",
        "finished_at": "2026-05-16T18:00:00.000000Z",
        "created_at": "2026-05-16T08:00:00.000000Z",
        "create_everyday": false,
        "duration": "9 ч",
        "executor": {
            "id": 5,
            "name": "Иванов Алексей"
        },
        "creator": {
            "id": 1,
            "name": "Полищук Артём"
        },
        "status": {
            "id": 1,
            "name": "В работе"
        },
        "order": {
            "id": 42,
            "name": "Заказ №42"
        },
        "object": null,
        "notifications": [],
        "stage": null,
        "progress": null
    }
}
Описание полей ответа
  • id — первичный ключ
  • name — название задачи
  • started_at — дата/время начала
  • finished_at — дата/время срока выполнения
  • created_at — дата/время создания записи
  • create_everyday — повторять каждый день (boolean)
  • duration — строка длительности ("9 ч")
  • executor — объект исполнителя
  • creator — объект создателя задачи
  • status — объект статуса (GET /api/task_statuses)
  • order — объект связанного заказа
  • object — произвольная строка-метка объекта
  • notifications — массив отделов, получающих уведомление (GET /api/departments)
  • stage / progress — этап и прогресс (опционально)

Создание задачи

Метод
POST
URL
https://api.gigma.ru/api/tasks
Авторизация
Bearer token
Headers
Authorization: Bearer {token}

Параметры запроса

  • name (string, обязательно) — название задачи
  • started_at (datetime, обязательно) — дата/время начала, ISO 8601
  • finished_at (datetime, обязательно) — дата/время срока, ISO 8601, должна быть позже started_at
  • executor_id (int, обязательно) — ID исполнителя (GET /api/users)
  • order_id (int, обязательно) — ID заказа (GET /api/orders)
  • object (string, опционально) — произвольная метка объекта
  • create_everyday (boolean, опционально) — повторять задачу ежедневно
  • notifications (int[], опционально) — массив ID отделов для уведомлений (GET /api/departments)

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

{
    "name": "Позвонить клиенту",
    "started_at": "2026-05-17 09:00:00",
    "finished_at": "2026-05-17 18:00:00",
    "executor_id": 5,
    "order_id": 42,
    "create_everyday": false,
    "notifications": [1, 2]
}

Ответ

При успешном действии возвращается HTTP код 200.

{
    "task": {
        "id": 13,
        "name": "Позвонить клиенту",
        "started_at": "2026-05-17T09:00:00.000000Z",
        "finished_at": "2026-05-17T18:00:00.000000Z",
        "created_at": "2026-05-17T08:30:00.000000Z",
        "create_everyday": false,
        "duration": "9 ч",
        "executor": { "id": 5, "name": "Иванов Алексей" },
        "creator": { "id": 1, "name": "Полищук Артём" },
        "status": { "id": 1, "name": "В работе" },
        "order": { "id": 42, "name": "Заказ №42" },
        "object": null,
        "notifications": [
            { "id": 1, "name": "Технический" },
            { "id": 2, "name": "Коммерческий" }
        ],
        "stage": null,
        "progress": null
    }
}

Редактирование задачи

Метод
PUT
URL
https://api.gigma.ru/api/tasks/{id}
Авторизация
Bearer token
Headers
Authorization: Bearer {token}

Параметры запроса

Все поля опциональны. Можно обновить любое из них.

  • task_status_id (int) — ID нового статуса: 1=В работе, 2=Просрочена, 3=Выполнена
  • name (string) — название задачи
  • started_at (datetime) — дата/время начала, ISO 8601
  • finished_at (datetime) — дата/время срока, ISO 8601, после started_at
  • executor_id (int) — ID исполнителя
  • order_id (int) — ID заказа
  • object (string) — метка объекта
  • create_everyday (boolean) — ежедневное повторение
  • notifications (int[]) — массив ID отделов

Пример запроса (смена статуса)

{
    "task_status_id": 3
}

Ответ

При успешном действии возвращается HTTP код 200. Возвращаемый объект task аналогичен ответу GET /api/tasks/{id}.

© 2026 Itecho ERP