Уведомления¶

Непрочитанные уведомления¶

URI: /BumsCommonApiV01/Informer/notifications.api|xml

Непрочитанные уведомления - это то, что выводится при нажатии на «синий баблик» в Мегаплане в нижней панели справа.

Важно: в списке будут только те уведомления, которые связаны с задачами, проектами или сотрудниками, т.к. в API поддерживается работа только с этими сущностями.

Входные параметры¶

Поле	Тип	Поумолчанию	Описание
Group	bool	false	Группируем уведомления о новых комментариях по subject
TimeUpdated	string	Дата/время в одном из форматов ISO 8601	Возвращать только те объекты, которые были изменены после указанный даты
Limit	integer	Выбираем количество уведомлении
Offset	integer	Указываем, с какого уведомления по счету необходимо их получить

Выходные данные (массив уведомлений с полями)¶

Поле	Тип	Описание
Id	integer	ID уведомления
Subject	object(Id,Name,Type)		Предмет уведомления (см. пояснение ниже)
Content	string или object(Subject,Text,Author)		Содержимое уведомления (см. пояснение ниже)
TimeCreated	datetime		Время создания уведомления

Subject - это модель данных, с которой связано уведомление (задача, проект, сотрудник или комментарий). Если, например, уведомление о том, что задача отклонена, то в Subject будет идентификатор задачи. Subject содержит следующие аттрибуты:

Id - идентификатор модели
Name - название модели
Type - тип модели (task/project/employee/comment).

Структура Content зависит от типа Subject. Для всех типов, кроме комментариев, это простой текст уведомления. В случае с комментариями Content содержит следующие аттрибуты:

Subject - предмет комментирования (задача или проект) с вложенной структурой, аналогичной Subject в самом уведомлении и добавляется параметор UnreadComments (количество непрочитаных комментариев )
Text - текст комментария
Author - автор комментария (Id и Name)

Пример ответа в JSON-формате¶

{
  "status":
  {
    "code":"ok",
    "message":null
  },
  "data":
  {
    "notifications":
    [
      {
        "Id":680,
        "Name":"",
        "Subject":
        {
          "Id":55,
          "Name":"Простой комментарий к тестовой задаче",
          "Type":"comment"
        },
        "Content":
        {
          "Subject":
          {
            "Id":1000043,
            "Name":"Тестовая задача",
            "Type":"task",
            "UnreadComments":2
          },
          "Text":"Простой комментарий к тестовой задаче",
          "Author":
          {
            "Id":1000018,
            "Name":"Иванов Иван"
          }
        },
        "TimeCreated":"2011-02-16 20:57:37"
      },
      {
        "Id":680,
        "Name":"",
        "Subject":
        {
          "Id":1000043,
          "Name":"Тестовая задача",
          "Type":"task"
        },
        "Content":"Николаев Николай назначил вас ответственным по задаче Тестовая задача.",
        "TimeCreated":"2011-02-16 20:57:37"
      }
    ]
  }
}

Пример ответа в XML-формате¶

<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>
    <code>ok</code>
    <message></message>
  </status>
  <data>
    <notifications>
      <item>
        <id>680</id>
        <name></name>
        <subject>
          <id>55</id>
          <name>Простой комментарий к тестовой задаче</name>
          <type>comment</type>
        </subject>
        <content>
          <subject>
            <id>1000043</id>
            <name>Тестовая задача</name>
            <type>task</type>
            <unreadComments>2</unreadComments>
          </subject>
          <text>Простой комментарий к тестовой задаче</text>
          <author>
            <id>1000018</id>
            <name>Иванов Иван</name>
          </author>
        </content>
        <time_created>2011-02-16 20:57:37</time_created>
      </item>
      <item>
        <id>650</id>
        <name></name>
        <subject>
          <id>1000043</id>
          <name>Тестовая задача</name>
          <type>task</type>
        </subject>
        <content>Николаев Николай назначил вас ответственным по задаче Тестовая задача.</content>
        <time_created>2011-02-16 15:50:00</time_created>
      </item>
    </notifications>
  </data>
</response>

Пометить уведомление как прочитанное¶

URI: /BumsCommonApiV01/Informer/deactivateNotification.api|xml

Входные параметры¶

Параметр	Тип	Описание
Ids	array		Массив идентификаторов уведомлений. Обязательный параметр

Выходные данные¶

Отсутствуют

Предупреждения¶

Список запросов¶

URI: /BumsCommonApiV01/Informer/approvals.api|xml

Предупреждения (запросы) - это то, что выводится при нажатии на иконку «восклицательный знак» справа в нижней панели Мегаплана.

Важно: в списке будут только те предупреждения, которые связаны с задачами и проектами, т.к. в API поддерживается работа только с этими сущностями.

Входные параметры¶

Параметр	Тип	Допустимые значения	Значение по умолчанию	Описание
ShowActions	bool	Нужно ли показывать в списке возможные действия над задачей

Выходные данные (массив предупреждений с полями)¶

Поле	Тип	Описание
Tasks	array		Список задач, см. структуру в списоке задач
Projects	array		Список проектов, см. структуру в списке проектов

Для каждой задачи или проекта добавляется дополнительный ключ Message, содержащий сообщение по предупреждению, которое должен увидеть пользователь.

Пример ответа в JSON-формате¶

{
  "status":
    {
      "code" : "ok",
      "message" : null
    },
  "data":
    {
      "Tasks":
        [
          {
            "Id" : 1000005,
            "Name" : "Заполнить   личную   карточку",
            "Status" : "assigned",
            "Deadline" : "",
            "Owner" :
              {
               "Id" : 1000001,
               "Name" : "Тестов тест"
              },
            "Responsible" :
               {
                 "Id":1000006,
                 "Name" : "Тестов Тест"
               },
            "Favorite" : "1",
            "TimeCreated" : "2011-02-08 20:49:10",
            "Message": "Вам назначена задача «Проверка ссылок»"
          }
        ]
      "Projects":
        [
          {
            "Id" : 1000041,
            "Name" : "Проект 2",
            "Status" : "done",
            "Deadline" : "",
            "Owner" :
             {
               "Id" : 1000006,
               "Name" : "Боткин Бот"
             },
            "Responsible":
             {
               "Id" : 1000007,
               "Name" : "Тестов Тест"
             },
            "Favorite" : "",
            "TimeCreated" : "2011-02-09 18:40:12",
            "Message": "Проект «Обновление сайта» завершен"
          }
        ]
    }
}

Пример ответа в XML-формате¶

<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>
    <code>ok</code>
    <message></message>
  </status>
  <data>
    <tasks>
      <item>
        <id>1000005</id>
        <name>Заполнить   личную   карточку</name>
        <status>assigned</status>
        <deadline></deadline>
        <owner>
          <id>1000001</id>
          <name>Тестов тест</name>
        </owner>
        <responsible>
          <id>1000006</id>
          <name>Тестов Тест</name>
        </responsible>
        <favorite>1</favorite>
        <time_created>2011-02-08 20:49:10</time_created>
      </item>
    </tasks>
    <projects>
      <item>
        <id>1000041</id>
        <name>Проект 2</name>
        <status>done</status>
        <deadline></deadline>
        <owner>
          <id>1000006</id>
          <name>Боткин Бот</name>
        </owner>
        <responsible>
          <id>1000007</id>
          <name>Тестов Тест</name>
        </responsible>
        <favorite>1</favorite>
        <time_created>2011-02-09 18:40:12</time_created>
      </item>
    </projects>
  </data>
</response>

Количество запросов¶

URI: /BumsCommonApiV01/Informer/approvalsCount.api|xml

Входные параметры¶

Отсутствуют

Выходные данные¶

Поле	Тип	Описание
Count	integer	Количество запросов