Получение списка проектов через API: get_projects
Пример get_projects запроса
?action=get_projectsНеобязательные параметры:
- filter — состояние проекта, возможные значения: active, pending, archived
- extra — дополнительные данные по проекту, возможные значения (можно указывать через запятую, например extra=text,options,users):
text или html — описание в текстовом или html формате
options — ограничения проекта
users — участники команды проекта
Возвращаемые данные:
- id — ID проекта
- name — название проекта
- status — состояние проектастатус
- company — название папки, в которой размещен проект
- user_from и user_to — создатель проекта и руководитель проекта
- text — описание проекта в текстовом или html формате (если в запросе указан соответствующий параметр extra)
- date_added — дата и время создания
- date_closed — дата и время закрытия (если проект перемещен в архив) или дата и время предыдущего закрытия (если проект активный)
- date_start — дата начала проекта (если указано)
- date_end — дата окончания проекта (если указано)
- options — ограничения проекта со значениями 0/ 1 — отключено/включено (возвращаются, если в запросе указан параметр extra=options):
- options.allow_close — закрывать задания
- options.allow_give — передавать ответственность
- options.allow_term — изменять сроки задачи
- options.allow_limit — изменять предполагаемые затраты
- options.require_term — сроки
- options.require_tag — статусы и метки
- options.require_limit — предполагаемые затраты
- options.require_hidden — видимость
- options.deny_comments_edit — редактировать и удалять комментарии
- options.deny_task_edit — редактировать и удалять задачи
- options.deny_task_delete — удалять задачи
- options.time_require — не закрывать задачи без затрат
- options.time_today — только за текущий день
- options.timer_only — только с таймера
- max_time и max_money — плановые временные и финансовые затраты (если указаны)
- tags — массив в формате id: name для тегов проекта (если указаны)
- users — участники команды проекта (если в запросе указан соответствующий параметр extra)
Исполнитель может:
При постановке задач требовать PRO:
Пользователям запрещено PRO:
Настройка внесения затрат PRO:
Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:
{ "status": "ok", "data": [
{ "id": "PROJECT_ID_1", "name": "PROJECT_NAME", "page": "/project/PROJECT_ID/", "status": "active", "company": "FOLDER_NAME", "user_from": {
"id": "USER_ID", "email": "USER_EMAIL", "name": "USER_NAME" }, "user_to": {
"id": "USER_ID",
"email": "USER_EMAIL", "name": "USER_NAME" }, "text": "PROJECT_TEXT", "date_added": "YYYY-MM-DD HH:II", "date_start": "YYYY-MM-DD", "date_end": "YYYY-MM-DD",
"date_closed": "YYYY-MM-DD HH:II", "options": {
"allow_close": 0..1,
"allow_give": 0..1, "allow_term": 0..1, "allow_limit": 0..1, "require_term": 0..1, "require_tag": 0..1, "require_limit": 0..1, "require_hidden": 0..1, "deny_comments_edit": 0..1, "deny_task_edit": 0..1, "deny_task_delete": 0..1, "time_require": 0..1, "time_today": 0..1, "timer_only": 0..1
}, "max_time": 100, "max_money": 500, "users": [ { "id": "USER_ID",
"email": "USER_EMAIL", "name": "USER_NAME" }, { "id": "USER_ID",
"email": "USER_EMAIL", "name": "USER_NAME" }, {
"id": "USER_ID",
"email": "USER_EMAIL", "name": "USER_NAME" }, {
"id": "USER_ID",
"email": "USER_EMAIL", "name": "USER_NAME" } ] },
{
"id": "PROJECT_ID_2",
"name": "PROJECT_NAME",
... ... ...
}
]}
Эта статья была вам полезна?
Да, спасибо!
Нет