Suivi du temps – plateforme développeur Flowtly

Utilisez cet instantané du schéma OpenAPI de Flowtly pour préparer vos intégrations, automatiser des workflows et synchroniser les données critiques.

Statut de la documentation

Dernière synchronisation : 2024-07-08 12:00 (version de l’app 2.0.0)

Seule une partie des entités est publique. Exécutez les deux commandes de synchronisation lorsque Flowtly publie de nouvelles fonctions.

Suivi du temps

Synchronisez les heures issues de vos outils projet vers Flowtly.

Vue d’ensemble

Temps de travail

Les entrées WorkTime alimentent l’utilisation, la paie et la facturation sans ressaisie des heures.

Endpoints

GET /api/employee_working_hours

Lister les temps de travail

Consulte les collections employee_working_hours filtrées par collaborateur, projet ou période.

POST /api/employee_working_hours

Créer un temps de travail

Enregistre une entrée WorkTime avec secondes, description et références employé/projet.

GET /api/employee_working_hours/{id}

Obtenir un temps de travail par ID

Consulte une entrée WorkTime précise.

PATCH /api/employee_working_hours/{id}

Mettre à jour un temps de travail

Corrige les secondes, le projet ou les notes d’une entrée.

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.

Cas d’usage

Importez les heures validées dans Asana pour garder les tableaux PMO de Flowtly à jour.
Envoyez les heures facturables d’une agence dans Flowtly pour générer automatiquement les factures.

Champs du schéma

WorkTime
Champ Type Description
id integer Identifiant de l’entrée de temps.
employee string IRI de l’employé qui a saisi les heures.
project string Projet auquel l’entrée est rattachée.
date string Date/heure d’exécution du travail.
seconds integer Durée en secondes.
description string | null Commentaire optionnel.
createdAt string Date de création dans Flowtly.
updatedAt string Dernière mise à jour.
deletedAt string | null Horodatage de suppression logique, le cas échéant.
deleted boolean Check if the entity has been soft deleted.

Exemples

POST /api/employee_working_hours

Envoyer un log facturable depuis Asana

Envoie une saisie de 7,5 heures (27 000 secondes) depuis l’outil projet pour que Flowtly mette à jour l’utilisation et la facturation.

Charge utile de la requête
{
    "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"
}
Charge utile de la réponse
{
    "@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