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.

Hinweis

Lesezeichen können über die mite.api von allen Benutzern ausschließlich gelesen, jedoch nicht angelegt und modifiziert werden. Wie unter der Weboberfläche sind Team-Lesezeichen für Zeiterfasser nicht sichtbar, sie sehen nur ihre eigenen. Alle anderen Rollen können auf ihre eigenen sowie alle Team-Lesezeichen zugreifen.

Alle Lesezeichen auflisten

GET /time_entries/bookmarks.xml

Listet alle Lesezeichen sortiert nach deren Namen auf.

Response : 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<bookmarks type="array">
   <bookmark>
      ...
   </bookmark>
   <bookmark>
      ...
   </bookmark>
</bookmarks>

Einzelnes Lesezeichen anzeigen

GET /time_entries/bookmarks/{id}.xml

Gibt ein einzelnes Lesezeichen zurück.

Response : 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<bookmark>
  <account-id type="integer">1</account-id>
  <created-at type="datetime">2010-01-11T12:00:00+01:00</created-at>
  <id type="integer">1</id>
  <name>'Website Konzeption' diese Woche</name>
  <updated-at type="datetime">2010-01-11T12:00:00+01:00</updated-at>
  <user-id type="integer">1</user-id>
  <query>project_id=2&amp;at=this_week</query>
  <type>time_entries</type>
</bookmark>

Team-Lesezeichen unterscheiden sich von benutzerspezifischen dadurch, dass sie nur einem Account aber keinem Benutzer zugeordnet sind. Das Attribut user_id steht bei ihnen auf nil.

Das query-Attribut enthält die eigentlichen Daten des Lesezeichens, die Parameter der Filterung. Um die gefilterten Zeiten aufzurufen werden diese Parameter einfach an die URL angehängt:

GET /time_entries.xml?project_id=2&amp;at=this_week

Alternativ kann ein Lesezeichen auch direkt benutzt werden:

GET /time_entries/bookmarks/{id}/follow.xml
Response : 302

Der Request wird so automatisch auf '/time_entries.xml?{query}' weitergeleitet, und die gefilterten Zeiten so direkt ausgegeben.