Login English

Entwickler, sei gegrüßt! Die mite.api freut sich auf deine Hacks. Welche Funktionen wie zur Verfügung stehen, erfährst du hier im Dokumentationsbereich.

Zeiteinträge gruppieren

GET /time_entries.xml?group_by=#{groups}

Beim Zugriff auf /time_entries können die Ergebnisse mittels des Parameters group_by gruppiert werden. Dieser kann folgende Werte enthalten:

customer
Kunde
project
Projekt
service
Leistung
user
Benutzer
day
Tag
week
Kalenderwoche
month
Monat
year
Jahr

Mehrere Parameter können kombiniert werden. Ein Komma trennt die verschiedenen Parameter (bspw.: »project,user«). Die Reihenfolge entscheidet über die Sortierung der Ergebnisse.

GET /time_entries.xml?group_by=user
Response : 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<time-entry-groups type="array">
   <time-entry-group>
      <minutes type="integer">6</minutes>
      <revenue nil="true"></revenue>
      <user-id type="integer">1</user-id>
      <user-name>Sebastian Munz</user-name>
      <time-entries-params>
         <user-id>1</user-id>
      </time-entries-params>
   </time-entry-group>
</time-entry-groups>

Die Ausgabe enthält neben den Summen der Arbeitszeit und des Umsatzes die gemeinsamen Werte der Gruppe, beispielsweise die user-id und den user-name, wenn nach dem Benutzer gruppiert wurde. Zusätzlich werden unter time-entries-params alle Parameter zum Aufruf der einzelnen Zeit-Einträge aufgelistet.

Es ist möglich, die ausgegebene Liste mit denselben Parametern wie unter Zeiten zusätzlich zu filtern.