Запрос

POST /task

Тело запроса

{
  "title": "task_title",
  "text": "task_text",
  "owner_id": owner_id,
  "project_id": project_id,
  "date_start": timestamp,
  "date_end": date_end,
  "remind_type": 2,
  "remind_method": ["sms", "email", "popup"],
  "lead_id": lead_id,
  "observers": [observer_id, observer_id],
  "labels": [label_id, label_id],
  "visibility": visibility
}

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

  • task_title - Название задачи - обязательное текстовое поле;
  • task_text - Информация о задаче - необязательное текстовое поле;
  • owner_id - Ответственный - обязательное поле. Id сотрудника, к которому нужно привязать задачу;
  • project_id - Проект - обязательное поле. Id проекта, в котором нужно создать задачу.
  • date_start - Дата начала задачи. Формат unix timestamp
  • date_end - Дата завершения задачи. Формат unix timestamp
  • remind_type - Время напоминания - необязательное поле.

    Может передаваться один из вариантов (числовое значение):

    без напоминания - 0 ,вовремя - 1 ,за час - 2 ,за неделю - 3 Если ничего не передано, сохранится вариант “без напоминания”

  • remind_method - Способ напоминания - необязательное поле. Но если “Время напоминания” не равно “без напоминания”, то способ напоминания должен быть обязательным.

    Может передаваться один или несколько из вариантов (массив строк):

    sms ,email ,call - звонок ,popup - всплывающее окно

  • lead_id - ID связанного лида - необязательное поле. ID лида, к которому нужно привязать задачу (как если бы она была создана из карточки лида)

  • observers - Кто может видеть задачу - необязательное поле. Cписок id сотрудников. Если ничего не передано, то задача должна быть видна всем сотрудникам.
  • labels - Метки - необязательное поле. Список id меток.
  • visibility - Кто может видеть задачу: 0 - только я, 1 - все, 2 - только указанные в observers сотрудники.

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

curl -H 'Content-Type: application/json' \
    -H 'token: someToken' \
    -X POST \
    -d '{ "contact_id": 9, "title": "Новая задача", "text": "тест", "owner_id": 9, "project_id": 649, "date_start": 1688896800, "date_end": 1688898600, "remind_type": 2, "remind_method": ["sms", "email", "popup"], "lead_id": 393989, "observers": [9, 19011], "labels": [158, 159], "visibility": 2 }' \
    https://direct.lptracker.ru/task

Пример ответа при успешном выполнении:

{
    "status": "success",
    "result": {
        "id": 3894,
        "title": "Новая задача",
        "text": "тест",
        "owner_id": 9,
        "project_id": 649,
        "date_start": 1688896800,
        "date_end": 1688898600,
        "remind_type": 0,
        "remind_method": "",
        "lead_id": 393989,
        "visibility": 2,
        "status": 0,
        "observers": [
            {
                "id": 9,
                "phone": "79161676999",
                "name": "Иванов Иван",
                "last_project_id": 649
            },
            {
                "id": 19011,
                "email": "polyanskiy@mail.ru",
                "phone": "79161234567",
                "name": "Мария Васильева",
                "job": "Менеджер",
                "avatar": "/img/icon/contacts-person.png"
            }
        ],
        "labels": [
            {
                "id": 158,
                "name": "Тестирование",
                "color": "F7F0C5"
            },
            {
                "id": 159,
                "name": "Работает",
                "color": "F7F0C5"
            }
        ]
    }
}

Описание модели задачи