Lister les saisies de temps avec l'API Teamwork.com
Liste les saisies de temps auxquelles l'utilisateur connecté a accès, avec les minutes, la personne, la tâche et si elles sont facturables. Paginez avec page, à partir de 1, tant que meta.page.hasMore dans la réponse est true.
- Identifiant
- teamwork_list_time_entries
L'appel
POST https://connect.reportei.com/api/tools/teamwork_list_time_entries/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"startDate": "<startDate>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| startDate | string | Non | Only entries from this moment on, as an ISO 8601 date-time. |
| endDate | string | Non | Only entries up to this moment, as an ISO 8601 date-time. |
| projectIds | string | Non | Comma-separated project ids from List projects. |
| taskIds | string | Non | Comma-separated task ids from List tasks. |
| assignedToUserIds | string | Non | Comma-separated user ids from List people: only the time logged by them. |
| billableType | string | Non | Billable filter.Valeurs : all, billable, nonbillable |
| orderBy | string | Non | Field to sort by.Valeurs : date, dateupdated, project, task, user, billable, timespent |
| orderMode | string | Non | Sort order.Valeurs : asc, desc |
| page | integer | Non | Page to fetch, starting at 1. |
| pageSize | integer | Non | Items per page, 50 by default and up to 500. |
Connexions possibles
Votre client connecte son compte Teamwork.com une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/teamwork, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
À la connexion, votre client indique aussi {site} : l'adresse de son compte sur l'API de l'app.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/teamwork_list_time_entries. Il devient la définition de tool de votre agent sans conversion.
Autres tools Teamwork.com
- Lister les projetsGETListe les projets auxquels l'utilisateur connecté a accès, 50 par page par défaut. Paginez avec page, à partir de 1, tant que meta.page.hasMore dans la réponse est true.
- Lister les listes de tâchesGETListe les listes de tâches d'un projet. Les tâches sont créées dans une liste. Paginez avec page, à partir de 1, tant que meta.page.hasMore dans la réponse est true.
- Lister les tâchesGETListe les tâches auxquelles l'utilisateur connecté a accès, dans tous les projets ou par projet, liste de tâches ou responsable, 50 par page par défaut et sans les tâches terminées sauf demande contraire. Paginez avec page, à partir de 1, tant que meta.page.hasMore dans la réponse est true.
- Obtenir une tâcheGETRenvoie une tâche avec description, statut, priorité, dates, assignés, estimation et progression.
- Créer une tâchePOSTCrée une tâche dans une liste de tâches. Nécessite task avec un name. Les dates sont au format yyyy-MM-dd.
- Mettre à jour une tâchePATCHMet à jour les champs envoyés d'une tâche et conserve les autres. Pour terminer une tâche, utilisez Complete task. Les dates sont au format yyyy-MM-dd.
- Terminer une tâchePUTMarque une tâche comme terminée. C'est la route que Teamwork documente pour terminer les tâches, dans l'API v1.
- Supprimer une tâcheDELETESupprime une tâche et ses sous-tâches.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
