Créez l’espace société
Connectez-vous ou inscrivez-vous, puis ouvrez API et intégrations comme propriétaire ou administrateur.
Company API v1 · exemples exécutables
Effectuez votre premier appel API par société en cinq minutes.
Créez une clé avec le minimum de droits, vérifiez la société sélectionnée par cette clé, puis reliez salariés, présences et feuilles de temps à un logiciel de paie, ERP ou RH.
Avant de lancer les exemples
Choisissez uniquement les scopes nécessaires
Commencez par organization:read et ajoutez le plus petit ensemble indiqué dans les parcours ci-dessous.
Copiez le secret une seule fois
Conservez la valeur tc_live_… dans un gestionnaire de secrets ou une variable d’environnement. Ne la placez jamais dans une URL, un bundle navigateur ou un dépôt de code.
Lancez une première requête
Définissez le secret dans votre shell, puis appelez l’endpoint de la société. Une réponse 200 confirme l’authentification et le contexte société.
cURL
export TOTEMCLOCK_API_KEY='tc_live_replace_me'
curl --fail-with-body https://totemclock.com/api/v1/organization \
-H "Accept: application/json" \
-H "X-API-Key: $TOTEMCLOCK_API_KEY"Node.js 18+
const response = await fetch(
'https://totemclock.com/api/v1/organization',
{ headers: {
Accept: 'application/json',
'X-API-Key': process.env.TOTEMCLOCK_API_KEY
}}
);
if (!response.ok) throw new Error(`TotemClock ${response.status}`);
console.log(await response.json());Python 3
import json, os, urllib.request
request = urllib.request.Request(
"https://totemclock.com/api/v1/organization",
headers={
"Accept": "application/json",
"X-API-Key": os.environ["TOTEMCLOCK_API_KEY"],
},
)
with urllib.request.urlopen(request) as response:
print(json.load(response))Télécharger les exemples exécutables paie, ERP et RH →
Télécharger le client JavaScript requis →
Choisissez le parcours avec le minimum de droits
| Parcours | Séquence des endpoints | Scopes requis | Démarrer |
|---|---|---|---|
| Export vers la paie | GET /organization → GET /employees → GET /exports/timecards.csv | organization:read · employees:read · exports:read | Créer la clé paie |
| Import des pointages ERP | GET /employees → POST /punches avec un externalId stable | employees:read · punches:write | Créer la clé ERP |
| Tableau de bord RH | GET /organization → GET /employees → GET /sites → GET /schedules → GET /timecards | organization:read · employees:read · sites:read · schedules:read · timecards:read | Créer la clé RH |
Pour les nouvelles tentatives de l’ERP, conservez le même externalId pour le même pointage. TotemClock traite une requête identique comme le même événement de la société au lieu de créer un doublon.
Poursuivez avec le contrat complet
Utilisez Swagger pour consulter les schémas et envoyer des requêtes autorisées, ou importez la collection Postman avec des variables secrètes.