ПланФикс API: Проекты
Материал из Planfix
Список функций позволяющий манипулировать с проектами.
progect.add Создать проект
project.update Обновить данные по проекту
project.get Получить информацию о проекте
Запрос на получение информации о проекте
<?xml version="1.0" encoding="UTF-8"?>
<request method="project.get">
<account><!-- имя аккаунта --></account>
<sid><!-- ключ сессии, полученный после аутентификации --></sid>
<id><!-- идентификатор проекта --></id>
</request>
Ответ:
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<project>
<id></id>
<title></title>
<description></description>
<!-- Автор проекта -->
<owner>
<id></id>
<name></name>
</owner>
<!-- контрагент -->
<client>
<id></id>
<name></name>
</client>
<!-- статус проекта -->
<status></status>
<hidden>{true|false}</hidden><!-- Скрытый -->
<HasEndDate>{true|false}</HasEndDate>
<EndDate><!-- Дата завершения проекта --></EndDate>
<BeginDate><!-- дата создания проекта --></BeginDate>
<IsOverdued><!-- просроченный ли проект --></IsOverdued>
<!-- осталось 25% времени до завершения или прошло 75% отведенного времени на выполнение его -->
<IsCloseToDeadline>{true|false}</IsCloseToDeadline>
</project>
</response>
В противном случае будет возвращен ответ с ошибкой. Статус имеет следующие значения:
- DRAFT - черновик
- COMPLETED - завершен
- ACTIVE - активен
project.getList Список проектов
Возвращаемые ошибки
- 2001 - запрошенный проект не существует