Unternehmensbereich erstellen
Anmelden oder registrieren und anschließend API und Integrationen als Inhaber oder Administrator öffnen.
Company API v1 · ausführbare Beispiele
Den ersten unternehmensbezogenen API-Aufruf in fünf Minuten ausführen.
Erstellen Sie einen Schlüssel mit minimalen Rechten, prüfen Sie das dadurch ausgewählte Unternehmen und verbinden Sie Mitarbeiter-, Anwesenheits- und Timesheet-Daten mit Lohnsoftware, ERP oder HR.
Vor dem Ausführen der Beispiele
Nur benötigte Scopes auswählen
Mit organization:read beginnen und nur den kleinsten unten für den Ablauf genannten Satz ergänzen.
Geheimnis einmal kopieren
Den Wert tc_live_… in einem Secret Manager oder einer Umgebungsvariable speichern. Niemals in eine URL, ein Browser-Bundle oder ein Quellcode-Repository einfügen.
Eine erste Anfrage ausführen
Das Geheimnis in der Shell setzen und danach den Unternehmens-Endpunkt aufrufen. Eine 200-Antwort bestätigt Authentifizierung und Unternehmenskontext.
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))Ausführbare Beispiele für Lohnsoftware, ERP und HR herunterladen →
Erforderlichen JavaScript-Client herunterladen →
Integrationsablauf mit minimalen Rechten wählen
| Ablauf | Endpunktfolge | Erforderliche Scopes | Start |
|---|---|---|---|
| Lohnabrechnungsexport | GET /organization → GET /employees → GET /exports/timecards.csv | organization:read · employees:read · exports:read | Lohnschlüssel erstellen |
| ERP-Buchungsimport | GET /employees → POST /punches mit stabiler externalId | employees:read · punches:write | ERP-Schlüssel erstellen |
| HR-Betriebsübersicht | GET /organization → GET /employees → GET /sites → GET /schedules → GET /timecards | organization:read · employees:read · sites:read · schedules:read · timecards:read | HR-Schlüssel erstellen |
Bei ERP-Wiederholungen dieselbe externalId für dieselbe Buchung beibehalten. TotemClock behandelt die identische Wiederholung als dasselbe unternehmensbezogene Ereignis, statt ein Duplikat zu erstellen.
Mit dem vollständigen Vertrag fortfahren
Mit Swagger Schemas prüfen und autorisierte Anfragen senden oder die Postman-Collection mit geheimen Variablen importieren.