Для этой функции требуется аутентификация.
Описание
Добавляет новую веху, используя параметры (идентификатор проекта, название вехи, дедлайн и т.д.), указанные в запросе.
Параметры
Название | Описание | Тип | Пример |
id sent in url | Идентификатор проекта | численный | 1234 |
title sent in body | Название вехи | строковый | текст |
deadline sent in body | Дедлайн вехи | дата и время | Roundtrip format: 2008-04-10T06-30-00.000Z |
isKey sent in body | Указывает, является ли это ключевой вехой или нет | логический | true |
isNotify sent in body | Напоминает мне о том, что за 48 часов до наступления контрольной даты | логический | true |
description sent in body | Описание вехи | строковый | текст |
responsible sent in body | Ответственный за веху | guid | 9924256A-739C-462b-AF15-E652A3B1B6EB |
notifyResponsible sent in body | Уведомляет ответственный о действиях вехи или нет | логический | true |
Пример
POST api/2.0/project/1234/milestone
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json
{
"title": "some text",
"deadline": "2008-04-10T06-30-00.000Z",
"isKey": true,
"isNotify": true,
"description": "some text",
"responsible": "9924256A-739C-462b-AF15-E652A3B1B6EB",
"notifyResponsible": true
}
Возвращает
Добавленную веха
Пример ответа
application/json
{
"status": 0,
"response": {
"canEdit": true,
"canDelete": false,
"id": 10,
"title": "Sample Title",
"description": "Sample description",
"projectOwner": {
"id": 123,
"title": "Sample project",
"status": 0,
"isPrivate": false
},
"deadline": "2022-10-12T08:51:51.4895372Z",
"isKey": false,
"isNotify": false,
"activeTaskCount": 15,
"closedTaskCount": 5,
"status": 0,
"responsible": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "Mike Zanyatski",
"title": "Manager",
"avatarSmall": "url to small avatar",
"profileUrl": ""
},
"updatedBy": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "Mike Zanyatski",
"title": "Manager",
"avatarSmall": "url to small avatar",
"profileUrl": ""
},
"created": "2022-10-12T08:51:51.4895372Z",
"createdBy": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "Mike Zanyatski",
"title": "Manager",
"avatarSmall": "url to small avatar",
"profileUrl": ""
},
"updated": "2022-10-12T08:51:51.4895372Z"
}
}
text/xml
<result>
<status>0</status>
<response>
<canEdit>true</canEdit>
<canDelete>false</canDelete>
<id>10</id>
<title>Sample Title</title>
<description>Sample description</description>
<projectOwner>
<id>123</id>
<title>Sample project</title>
<status>0</status>
<isPrivate>false</isPrivate>
</projectOwner>
<deadline>2022-10-12T08:51:51.4895372Z</deadline>
<isKey>false</isKey>
<isNotify>false</isNotify>
<activeTaskCount>15</activeTaskCount>
<closedTaskCount>5</closedTaskCount>
<status>0</status>
<responsible>
<id>00000000-0000-0000-0000-000000000000</id>
<displayName>Mike Zanyatski</displayName>
<title>Manager</title>
<avatarSmall>url to small avatar</avatarSmall>
<profileUrl></profileUrl>
</responsible>
<updatedBy>
<id>00000000-0000-0000-0000-000000000000</id>
<displayName>Mike Zanyatski</displayName>
<title>Manager</title>
<avatarSmall>url to small avatar</avatarSmall>
<profileUrl></profileUrl>
</updatedBy>
<created>2022-10-12T08:51:51.4895372Z</created>
<createdBy>
<id>00000000-0000-0000-0000-000000000000</id>
<displayName>Mike Zanyatski</displayName>
<title>Manager</title>
<avatarSmall>url to small avatar</avatarSmall>
<profileUrl></profileUrl>
</createdBy>
<updated>2022-10-12T08:51:51.4895372Z</updated>
</response>
</result>