Crea lo spazio aziendale
Accedi o registrati, poi apri API e integrazioni come titolare o amministratore.
Company API v1 · esempi eseguibili
Esegui la prima chiamata API aziendale in cinque minuti.
Crea una chiave con privilegi minimi, verifica l’azienda selezionata dalla credenziale e collega dipendenti, presenze e timesheet a software paghe, ERP o HR.
Prima di eseguire gli esempi
Seleziona solo gli scope necessari
Parti da organization:read e aggiungi il set minimo indicato nei flussi qui sotto.
Copia il segreto una sola volta
Salva il valore tc_live_… in un secret manager o in una variabile d’ambiente. Non inserirlo mai in URL, bundle browser o repository.
Esegui la prima richiesta
Imposta il segreto nella shell, poi chiama l’endpoint dell’azienda. Una risposta 200 conferma autenticazione e contesto aziendale.
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))Scegli il flusso di integrazione minimo
| Flusso | Sequenza endpoint | Scope necessari |
|---|---|---|
| Esportazione paghe | GET /organization → GET /employees → GET /exports/timecards.csv o /exports/timesheets.csv | organization:read · employees:read · exports:read |
| Import presenze ERP | GET /employees → POST /punches con externalId stabile → GET /employees/{employeeId}/days/{date} | employees:read · punches:write · timecards:read |
| Cruscotto operativo HR | GET /employees → GET /sites → GET /schedules → GET /timecards | employees:read · sites:read · schedules:read · timecards:read |
Per i tentativi ripetuti dall’ERP, mantieni lo stesso externalId per la stessa timbratura. TotemClock riconosce la richiesta identica come lo stesso evento aziendale invece di creare un duplicato.
Continua con il contratto completo
Usa Swagger per consultare gli schemi e inviare richieste autorizzate, oppure importa la collection Postman con variabili segrete.