Облік часу – будуйте на Flowtly

Використовуйте цей добірний знімок OpenAPI-схеми Flowtly, щоб планувати інтеграції, автоматизувати процеси та синхронізувати дані, на які спираються ваші команди.

Статус документації

Остання синхронізація: 2025-12-11 09:43 (версія застосунку 2.0.0)

Публікується лише частина сутностей. Запускайте обидві команди синхронізації, щоб оновити цю документацію після виходу нових можливостей Flowtly.

Облік часу

Синхронізуйте робочі логи з PM-інструментів у Flowtly.

Огляд сутності

Робочий час

Використовуйте записи WorkTime для завантаження, payroll і білінгу без повторного вводу годин командою.

Ендпоїнти

GET /api/employee_working_hours

Список робочих логів

Читайте колекції employee_working_hours з фільтрами за співробітником, проєктом або діапазоном часу.

POST /api/employee_working_hours

Створити робочий лог

Надішліть новий запис робочого часу з секундами, описом і посиланнями на співробітників/проєкти.

GET /api/employee_working_hours/{id}

Отримати робочий лог за ID

Перегляньте один запис робочого часу.

PATCH /api/employee_working_hours/{id}

Оновити робочий лог

Патчте тривалість у секундах, проєкт або нотатки при необхідності корекцій.

GET /api/employee-working-hours

List employee-working-hours

Retrieve employee-working-hours with pagination and filters.

POST /api/employee-working-hours

Create employee-working-hour

Create a new employee-working-hour entry.

GET /api/employee-working-hours/{id}

Get employee-working-hour

Fetch a single employee-working-hour by ID.

PATCH /api/employee-working-hours/{id}

Update employee-working-hour

Patch fields of an employee-working-hour entry.

DELETE /api/employee-working-hours/{id}

Delete employee-working-hour

Remove an employee-working-hour entry.

GET /api/work-times

List work-times

Retrieve work-time entries.

POST /api/work-times

Create work-time

Create a work-time record.

GET /api/work-times/{id}

Get work-time

Fetch a single work-time by ID.

PATCH /api/work-times/{id}

Update work-time

Patch a work-time record.

DELETE /api/work-times/{id}

Delete work-time

Delete a work-time record.

GET /api/employees/{id}/working-hours-stats/{date}

Get working-hours stats

Retrieve aggregated working-hours stats for an employee at a date.

Сценарії використання

Імпортуйте ретро-затверджені години з Asana, щоб PMO-дашборди у Flowtly були актуальні.
Надсилайте billable години з задачної дошки агентства у Flowtly для автоматичного інвойсингу.

Поля схеми

WorkTime
Поле Тип Опис
id integer Внутрішній ідентифікатор робочого логу.
employee string IRI співробітника, який подав час.
project string IRI проєкту, що отримує роботу.
date string Мітка часу, що вказує, коли була виконана робота.
seconds integer Тривалість у секундах.
description string | null Опціональна нотатка з описом активності.
createdAt string Коли запис створено у Flowtly.
updatedAt string Коли запис востаннє змінено.
deletedAt string | null Час мʼякого видалення, якщо є.
deleted boolean Check if the entity has been soft deleted.

Приклади

POST /api/employee_working_hours

Надіслати billable лог з Asana

Надсилає лог на 7.5 години (27 000 секунд) з вашого PM-інструмента, щоб Flowtly оновив метрики завантаження та білінгу.

Пейлоад запиту 
{
    "employee": "/api/employees/emp_102",
    "project": "/api/projects/aurora",
    "date": "2024-07-04T00:00:00+00:00",
    "seconds": 27000,
    "description": "Budget review for Aurora project"
}
Пейлоад відповіді 
{
    "@id": "/api/employee_working_hours/wkt_9001",
    "@type": "WorkTime",
    "id": 9001,
    "employee": "/api/employees/emp_102",
    "project": "/api/projects/aurora",
    "date": "2024-07-04T00:00:00+00:00",
    "seconds": 27000,
    "description": "Budget review for Aurora project",
    "createdAt": "2024-07-04T18:05:00+00:00",
    "updatedAt": "2024-07-04T18:05:00+00:00",
    "deleted": false
}
Whatsapp