Отримання даних по витратах часу та фінансів через API: get_costs
Приклад get_costs запиту
https://your—domain.com/api/admin/v2/?action=get_costs&hash=HASH
Повертає дані по внесених часових та фінансових витратах задач і підзадач
При відсутності параметра page будуть отримані витрати по всіх проектах акаунту
Необов'язкові параметри:
- page — повертає витрати зазначеного проекту/задачі/підзадачі (див. формат посилання)
- datestart і dateend — діапазон дат для пошуку даних у форматі DD.MM.YYYY (дати рахуються включно)
- is_timer — повертає тільки ті рядки витрат, в яких час:
1 — внесено з таймера
0 — внесено вручну
- filter — додатковий параметр для пошуку (список операторів для роботи з даними, які використовуються в filter, див. search_tasks)
можливі дані для використання
в filter (для методу get_costs):
- task=TASK_ID — повертає дані певної задачі/підзадачі по її ID (можна отримати через методи get_all_tasks або get_tasks) (Integer)
- project=PROJECT_ID — повертає дані по задачах певного проекту по його ID (можна отримати через метод get_projects) (Integer)
- comment — коментар користувача до витрат (String)
- dateadd або date_added — дата внесення витрат у форматі 'DD.MM.YYYY'
Повертаються наступні дані:
- id — унікальний номер рядка витрат
- comment — коментар користувача до витрат
- time — значення часових витрат
- money — значення фінансових витрат
- date — дата внесення витрат
- is_timer — спосіб внесення витрат часу
- user_from — інформація про співробітника, який вніс витрати
- task — масив даних по задачі/підзадачі, куди внесені витрати (значення параметрів аналогічні описаним в методі get_task)
- total — сумарні значення окремо за часових та фінансовими витратами, отриманими у відповіді
true — отримані з таймера
false — внесені вручну
Приклад JSON відповіді
При успішному виконанні запиту, відповідь буде містити статус ok і наступні дані:
{
"status": "ok",
"data": [
{
"id": "COSTS_ID_1",
"comment": "COSTS_COMMENT",
"time": "10:00",
"money": "100.00",
"date": "YYYY—MM—DD",
"is_timer": false,
"user_from": {
"id": "USER_ID",
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"task": {
"id": "TASK_ID",
"name": "TASK_NAME",
"page": "/project/PROJECT_ID/TASK_ID/",
"status": "active",
"priority": "0..10",
"user_from": {
"id": "USER_ID",
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"user_to": {
"id": "USER_ID",
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"project": {
"id": "PROJECT_ID",
"name": "PROJECT_NAME",
"page": "/project/PROJECT_ID/"
},
"date_added": "YYYY—MM—DD HH:II",
"date_start": "YYYY—MM—DD",
"date_end": "YYYY—MM—DD",
"time_end": "HH:II",
"max_time": 20,
"max_money": 500,
"tags": {
"TAG_ID": "TAG_NAME_1",
"TAG_ID": "TAG_NAME_2",
}
},
},
{
"id": "COSTS_ID_2",
"comment": "COMMENT_COSTS",
... ... ...
}
],
"total": {
"time": "HH:II",
"money": "10.01"
}
}
Ця стаття була вам корисною?
Так, дякую!
Ні