Получение данных о затратах времени и денег через API: get_costs
Пример get_costs запроса
https://your-domain.com/api/admin/v2/?action=get_costs&hash=HASH
Возвращает затраты за период времени по задачам и подзадачам, их
исполнителя (параметр user_from).
- is_timer=true означает, что затраты были внесены с таймера
- is_timer=false означает, что затраты были внесены вручную
Необязательные параметры:
- datestart and dateend – диапазон дат для поиска данных.
- &add_tags=1 – включает в ответ информацию о статусах и метках
- &is_timer=1 – затраты по таймеру
- &is_timer=0 – затраты, внесенные вручную
- page – возвращает данные указанного проекта
- filter – дополнительный параметр для поиска (см. search_tasks)
Возможные данные для использования
в filter:
- task, project – id задачи или проекта (Integer)
- comment – комментарий пользователя к затратам (String)
- dateadd или date_added – дата внесения затрат в формате YYYY-MM-DD
Пример JSON ответа
{
"status": "ok",
"data": [
{
"id": "COSTS_ID",
"comment": "COMMENT_COSTS",
"time": "10:00",
"money": "100.00",
"date": "YYYY-MM-DD",
"is_timer": false,
"user_from": {
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"task": {
"id": "TASK_ID",
"name": "TASK_NAME",
"page": "/project/PROJECT_ID/TASK_ID/",
"status": "active",
"priority": "1",
"user_from": {
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"user_to": {
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"date_added": "YYYY-MM-DD HH:II",
"date_end": "YYYY-MM-DD",
"max_time": 20,
"max_money": 500
},
"project": {
"id": "PROJECT_ID",
"name": "PROJECT_NAME",
"page": "/project/PROJECT_ID/"
}
},
{
"id": "COSTS_ID",
"comment": "COMMENT_COSTS",
"time": "0:01",
"money": "0.33",
"date": "YYYY-MM-DD",
"is_timer": true,
"user_from": {
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"task": {
"id": "TASK_ID",
"name": "NAME_ID",
"page": "/project/PROJECT_ID/TASK_ID/",
"status": "active",
"priority": "1",
"user_from": {
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"user_to": {
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"date_added": "YYYY-MM-DD HH:II",
"date_end": "YYYY-MM-DD",
"max_time": 20,
"max_money": 500
},
"project": {
"id": "PROJECT_ID",
"name": "PROJECT_NAME",
"page": "/project/PROJECT_ID/"
}
],
"total": {
"time": "HH:II",
"money": "0.00"
}
}