POST api/2.0/crm/task
Для этой функции требуется аутентификация.
Описание
Создает задачу с указанными в запросе параметрами (название, описание, срок выполнения и т.д.).
Параметры
| Название | Описание | Тип | Пример |
| title
sent in body
|
Название задачи | строковый | текст |
| description
sent in body
|
Описание задания
необязательно
|
строковый | текст |
| deadline
sent in body
|
Срок выполнения задачи | Date and Time | Roundtrip format: 2008-04-10T06-30-00.000Z |
| responsibleId
sent in body
|
Идентификатор ответственного за выполнение задачи | guid | 9924256A-739C-462b-AF15-E652A3B1B6EB |
| categoryId
sent in body
|
Идентификатор категории задачи | номер | 1234 |
| contactId
sent in body
|
Идентификатор контакта
необязательно
|
номер | 1234 |
| entityType
sent in body
|
Связанный тип сущности
Допустимые значения: opportunity or case необязательно
|
строковый | текст |
| entityId
sent in body
|
Идентификатор связанной сущности
необязательно
|
номер | 1234 |
| isNotify
sent in body
|
Уведомляет ответственного о задаче
необязательно
|
логический | истина |
| alertValue
sent in body
|
Период времени в минутах для напоминания ответственному о задаче
необязательно
|
номер | 1234 |
Пример
POST api/2.0/crm/task
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json
{
"title": "some text",
"description": "some text",
"deadline": "2008-04-10T06-30-00.000Z",
"responsibleId": "9924256A-739C-462b-AF15-E652A3B1B6EB",
"categoryId": 1234,
"contactId": 1234,
"entityType": "some text",
"entityId": 1234,
"isNotify": true,
"alertValue": 1234
}
Возвращает
Задача
Пример ответа
application/json
{
"status": 0,
"response": {
"createBy": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "Mike Zanyatski",
"title": "Manager",
"avatarSmall": "url to small avatar",
"profileUrl": ""
},
"created": "2022-10-09T20:03:09.6137431Z",
"title": "Send a commercial offer",
"deadLine": "2022-10-09T20:03:09.6137431Z",
"responsible": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "Mike Zanyatski",
"title": "Manager",
"avatarSmall": "url to small avatar",
"profileUrl": ""
},
"category": {
"imagePath": "path to image",
"title": "Appointment",
"description": "",
"sortOrder": 2,
"id": 30
},
"canEdit": true,
"id": 0
}
}
text/xml
<result>
<status>0</status>
<response>
<createBy>
<id>00000000-0000-0000-0000-000000000000</id>
<displayName>Mike Zanyatski</displayName>
<title>Manager</title>
<avatarSmall>url to small avatar</avatarSmall>
<profileUrl></profileUrl>
</createBy>
<created>2022-10-09T20:03:09.6137431Z</created>
<title>Send a commercial offer</title>
<deadLine>2022-10-09T20:03:09.6137431Z</deadLine>
<responsible>
<id>00000000-0000-0000-0000-000000000000</id>
<displayName>Mike Zanyatski</displayName>
<title>Manager</title>
<avatarSmall>url to small avatar</avatarSmall>
<profileUrl></profileUrl>
</responsible>
<category>
<imagePath>path to image</imagePath>
<title>Appointment</title>
<description></description>
<sortOrder>2</sortOrder>
<id>30</id>
</category>
<canEdit>true</canEdit>
<id>0</id>
</response>
</result>