Support développeurs
Introduction
Cette page fournit toutes les informations nécessaires pour intégrer Timpo PRO dans vos applications, outils internes, CRM, ERP ou automatisations (Zapier, Make, n8n…).
Vous trouverez ici des exemples, des bonnes pratiques, des formats recommandés et les réponses aux questions techniques les plus fréquentes.
1. Formats recommandés
Format CSV
- Encodage recommandé : UTF‑8
- Séparateur recommandé : point‑virgule ( ; )
- Colonnes recommandées : nom, prénom, date, type d’événement
- Formats de date acceptés : AAAA‑MM‑JJ ou JJ/MM/AAAA
Format JSON (API)
Exemple minimal :
{ "file": "BASE64_DU_FICHIER_CSV" }
2. Bonnes pratiques d’intégration
1. Nettoyer les données avant envoi
- Supprimer les colonnes inutiles
- Éviter les caractères spéciaux
- Vérifier les formats de date
2. Utiliser des identifiants techniques
Pour faciliter les correspondances, utilisez un identifiant interne unique (ID client, ID salarié…).
3. Automatiser les imports
Timpo PRO peut être intégré dans des workflows automatisés via :
- Zapier
- Make
- n8n
- Scripts internes (cron, batch…)
3. Gestion des erreurs
Erreurs courantes
- 400 — Fichier invalide : format incorrect ou colonnes manquantes.
- 401 — Clé API invalide : vérifier l’en‑tête Authorization.
- 415 — Format non supporté : seul le CSV est accepté.
- 500 — Erreur interne : réessayer ou contacter le support.
Conseils
- Vérifier les formats de date
- Éviter les colonnes vides
- Limiter les caractères spéciaux
4. Sécurité & RGPD
Toutes les données envoyées via l’API sont :
- anonymisées en transit
- traitées uniquement le temps de l’analyse
- supprimées immédiatement après traitement
- jamais stockées
- jamais partagées
Pour plus d’informations, consultez :
5. Besoin d’aide ?
Notre équipe technique est disponible pour vous accompagner dans vos intégrations.