REST-API · OpenAPI 3.1

Entwickler-API

Greife programmatisch auf deine Zeiteinträge, Kategorien und Kunden zu. Die evaluateMe-API ist REST, gibt JSON zurück und authentifiziert über einen Personal Access Token (Bearer).

Token pro Person

Handelt in deinem Namen, nie darüber hinaus. Jederzeit widerrufbar.

DE-Hosting

Falkenstein bei Hetzner, EN-16931-konform.

Business-Feature

Verfügbar ab dem Business-Tarif.

Token anlegen: Jedes Teammitglied erzeugt sich in der App unter Einstellungen → API selbst einen Personal Access Token, wählt dessen Berechtigungen und sendet ihn im Authorization: Bearer …-Header mit. Ein Token kann nie mehr als die Person, der er gehört. Org-Admins sehen zusätzlich alle Tokens der Organisation und können jeden davon widerrufen.

Token in der App anlegen Tarife ansehen

Schnellstart

Drei Aufrufe: Kategorie suchen, Zeit buchen, Tag gegenlesen.

export EVME_TOKEN="evme_…"
export EVME_API="https://api.evaluateme.de/api/v1"

# 1 · Kategorien holen
curl -s "$EVME_API/categories" \
  -H "Authorization: Bearer $EVME_TOKEN"

# 2 · Eine Stunde buchen
curl -s -X POST "$EVME_API/time-entries" \
  -H "Authorization: Bearer $EVME_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<id>","started_at":"2026-08-11T09:00:00+02:00","ended_at":"2026-08-11T10:00:00+02:00","comment":"API-Integration"}'

# 3 · Den eigenen Tag gegenlesen
curl -s "$EVME_API/time-entries?from=2026-08-11T00:00:00%2B02:00" \
  -H "Authorization: Bearer $EVME_TOKEN"

Für KI-Agenten

Ein Agent, der weiß, woran du gerade gearbeitet hast, kann den Eintrag selbst schreiben — das ist der Anwendungsfall, für den die persönliche Referenz existiert. Sie enthält Zeiterfassung, den Kategorienbaum, deinen Saldo und deine Abwesenheiten, aber weder Rechnungen noch Kunden noch org-weite Auswertungen: eine Werkzeugliste, die Rechnungen erwähnt, ist eine, in die ein Agent hineingreift.

Gib dem Agenten https://api.evaluateme.de/docs/api/personal.json als Spec und den Token über eine Umgebungsvariable — keine Installation, kein Zusatzdienst.
Wähle die Berechtigungen eng: time_entries:write und categories:write reichen fürs Tracken. Ein Token ohne den passenden Scope bekommt 403.
Setze ein Ablaufdatum. Ein Agenten-Token, das nach drei Monaten von selbst endet, ist eines weniger, an das später niemand mehr denkt.

Buchhaltungs-Integrationen und alles Org-weite laufen über dieselben Tokens und dieselbe API — dafür ist der Reiter „Vollständig" unten gedacht.