API et Intégrations TimeTrack
Intégrez TimeTrack avec Vos Outils Existants
API REST complète, webhooks en temps réel, documentation détaillée. Intégrez TimeTrack avec votre ERP, vos outils de facturation, ou vos systèmes RH.
API REST Complète
Endpoints Complets
Lecture et écriture des timesheets, projets (liste plafonnée à 200), utilisateurs et brief. Pas d'endpoint de validation. Les exports fichier sont des routes de session, pas des routes de clé API.
Documentation Détaillée
Documentation complète avec exemples de code dans plusieurs langages (JavaScript, Python, cURL).
Authentification Sécurisée
Authentification par token (API Key). Tokens révocables pour la sécurité. Rate limiting pour garantir la stabilité.
Exemples de Code
Récupérer les Timesheets (JavaScript)
const url = new URL("https://www.simpletimetrack.com/api/v1/timesheets")
url.searchParams.set("from", "2026-01-01")
url.searchParams.set("to", "2026-01-31")
url.searchParams.set("validated", "true")
url.searchParams.set("limit", "500")
const response = await fetch(url, {
headers: { Authorization: "Bearer ttk_YOUR_KEY" },
})
const { timesheets, nextCursor } = await response.json()Créer un Timesheet (Python)
import requests
url = "https://www.simpletimetrack.com/api/v1/timesheets"
headers = {
"Authorization": "Bearer ttk_YOUR_KEY",
"Content-Type": "application/json",
}
data = {
"userEmail": "ada@example.com",
"projectId": "project-123",
"date": "2026-01-15",
"hours": 8,
"description": "Développement",
}
# Scope write:timesheets. Refus si la ligne est déjà soumise ou validée.
response = requests.post(url, json=data, headers=headers)Modifier un timesheet non verrouillé (cURL)
curl -X PATCH "https://www.simpletimetrack.com/api/v1/timesheets/TIMESHEET_ID" \
-H "Authorization: Bearer ttk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"hours": 7.5, "description": "Ajustement"}'Webhooks en Temps Réel
Recevez des Notifications en Temps Réel
TimeTrack envoie des webhooks en temps réel lorsque des événements se produisent. Configurez vos URLs de callback pour recevoir ces notifications automatiquement.
Événements Disponibles
- timesheet.submitted
- timesheet.validated
- timesheet.rejected
- month.closed
- manager.brief
- webhook.test (essai depuis les paramètres)
Exemple de Webhook
{
"event": "timesheet.validated",
"timestamp": "2026-01-15T10:30:00.000Z",
"data": {
"count": 1,
"timesheetIds": ["ts-123"],
"validatedBy": "user-1",
"validatedByName": "Morgan",
"timesheets": [{
"id": "ts-123",
"date": "2026-01-15",
"hours": 8,
"billable": true,
"projectId": "project-456",
"projectName": "Alpha",
"clientName": "Acme",
"userId": "user-2",
"userName": "Ada",
"userEmail": "ada@example.com",
"validatedAt": "2026-01-15T10:30:00.000Z"
}]
}
}Intégrations Prêtes à l'Emploi
SAP + Power BI
Pas de connecteur SAP natif. Fichier d'équipe Power BI : export facturation validé (CSV/JSON) ou API paginée.
Zapier
Pas d'application Zapier native. Un Zap peut appeler l'API ou POST /api/v1/inbound/timesheets avec une clé Bearer ttk_.
Make
Pas de module Make natif. Un scénario HTTP peut utiliser la même API ou l'endpoint inbound.
Intégrations Personnalisées
Créez vos propres intégrations avec votre ERP, vos outils de facturation, ou vos systèmes RH via l'API REST.
Formats d'Export Disponibles
JSON
Format JSON structuré pour intégration avec vos applications. Idéal pour les développeurs.
CSV
Format CSV pour import dans Excel ou autres outils d'analyse. Compatible avec tous les tableurs.
API JSON
GET /api/v1/timesheets renvoie du JSON paginé. Il n'y a pas d'export XML.
Cas d'Usage d'Intégration
Intégration avec ERP
TimeTrack ne pousse pas les temps dans un ERP. Un manager télécharge l'export facturation validé, ou votre ERP lit GET /api/v1/timesheets et les webhooks timesheet.validated.
Intégration avec Outils de Facturation
TimeTrack ne génère pas les factures de vos clients dans un outil externe. Le fichier à importer est l'export facturation des temps validés.
Intégration avec Systèmes RH
Il n'y a pas de synchronisation automatique depuis un SIRH. POST /api/v1/users (scope write:users) peut créer un consultant ou un manager.
Questions Fréquentes
Qu'est-ce que l'API REST TimeTrack ?
L'API REST TimeTrack permet d'intégrer TimeTrack avec vos outils existants (ERP, outils de facturation, systèmes RH, etc.). L'API permet de lire et d'écrire des données timesheet, de gérer les projets, les consultants, et de recevoir des webhooks en temps réel.
Comment s'authentifier à l'API TimeTrack ?
L'API TimeTrack utilise l'authentification par token (API Key). Vous générez une clé API depuis votre tableau de bord et l'utilisez dans l'en-tête Authorization de vos requêtes. Les tokens peuvent être révoqués à tout moment pour la sécurité.
Quels sont les webhooks disponibles dans TimeTrack ?
Les événements envoyés sont timesheet.submitted, timesheet.validated, timesheet.rejected, month.closed et manager.brief. Signature HMAC dans X-TimeTrack-Signature. project.created n'est pas envoyé.
Peut-on intégrer TimeTrack avec Zapier ou Make ?
Il n'existe pas d'application Zapier ou Make native. Ces outils peuvent appeler l'API ou POST /api/v1/inbound/timesheets avec une clé Bearer ttk_.
Quels formats d'export sont disponibles via l'API ?
L'API renvoie du JSON paginé (500 lignes, nextCursor), pas de CSV ni de XML, et pas d'export programmé. Le CSV/JSON d'équipe est GET /api/exports/billing, réservé aux managers et admins.
L'API TimeTrack est-elle documentée ?
Le contrat est GET /api/v1/openapi sur www.simpletimetrack.com. Les exemples de cette page (JavaScript, Python, cURL) suivent ce contrat. Il n'y a pas de site de documentation séparé en plusieurs langues.
Y a-t-il des limites de taux (rate limiting) sur l'API ?
120 requêtes par minute et par clé, compteur en mémoire sur chaque instance. Ce n'est pas un plafond global ni un quota selon le plan. La réponse 429 envoie Retry-After, sans quota restant.
Intégrez TimeTrack avec Vos Outils
API REST complète, webhooks en temps réel, documentation détaillée. Commencez votre intégration dès aujourd'hui.
Essai gratuit 14 jours