REST-API · OpenAPI 3.1

Entwickler-API

Greife programmatisch auf deine Zeiteinträge, Kategorien und Kunden zu. Die evaluateMe-API ist REST und gibt JSON zurück. Als Schlüssel dient ein Personal Access Token, den du als Bearer-Token im Authorization-Header mitschickst.

Token pro Person

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

DE-Hosting

Falkenstein bei Hetzner, Rechenzentrum mit aktuellem BSI-C5-Testat.

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. Genau deshalb gibt es die persönliche Referenz. Sie enthält Zeiterfassung, den Kategorienbaum, deinen Saldo und deine Abwesenheiten. Rechnungen, Kunden und org-weite Auswertungen fehlen mit Absicht: 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.

Kunden, Rechnungen (lesend) und alles Org-weite laufen über dieselben Tokens und dieselbe API. Dafür ist der Reiter „Vollständig" unten gedacht. Der Buchhaltungs-Export bleibt in der App.