Zeiteinträge

Attribute

Die Repräsentation des Zeiteintrags enthält neben den wichtigsten Eigenschaften ausserdem:
  • Projekt (Project)
  • Kunde (Customer)
  • Leistung (Task)
  • Zugewiesener Mitarbeiter (User)
Die Attribute remote_service, remote_id und remote_url werden durch die MOCO-Browser-Extension gefüllt und enthalten Informationen zum Ticket oder Task eines Systems wie JIRA, Trello, Wunderlist, Basecamp, Asana, etc.

{
    "id": 982237015,
    "date": "2017-06-06",
    "hours": 1.25,
    "description": "Analyse Rahmenbedingungen und Abhängigkeiten",
    "billed": false,
    "billable": false,
    "tag": "",
    "remote_service": "trello",
    "remote_id": "9qzOS8AA",
    "remote_url": "https://trello.com/c/9qzOS8AA/123-konzept",
    "project": {
        "id": 944587499,
        "name": "Website Relaunch",
        "billable": false
    },
    "task": {
        "id": 658636,
        "name": "Konzeption",
        "billable": false
    },
    "customer": {
        "id": 760253684,
        "name": "Beispiel AG"
    },
    "user": {
        "id": 933590696,
        "firstname": "Nicola",
        "lastname": "Piccinini"
    },
    "hourly_rate": 150
}


GET activities

Abruf aller Zeiteinträge:

curl -X GET \
  https://{domain}.mocoapp.com/api/v1/activities \
  -H 'authorization: Token token={api-key}'
  -d 'from=2017-06-01&to=2017-06-10'

Die Antwort liefert ein Array mit vollständigen Projektinformationen (siehe Attribute).

Zusätzlich sind folgende Parameter möglich:
  • from* – "2017-05-01"
  • to* – "2017-05-31" (max. 30 Tage Differenz zu from)
  • user_id – 123
  • project_id – 345


GET activities/{id}

Abruf eines einzelnen Zeiteintrags:

curl -X GET \
  https://{domain}.mocoapp.com/api/v1/activities/{123} \
  -H 'Authorization: Token token={api-key}'

Die Antwort ist die Repräsentation eines einzelnen Zeiteintrags.


POST activities

Erstellen eines Zeiteintrags:

Der Eintrag wird immer für den User mit dem zugehörigen Authorization-Token erstellt.

curl -X POST \
  https://{domain}.mocoapp.com/api/v1/activities \
  -H 'authorization: Token token={api-key}' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'date=2017-06-11&description=Analyse Rahmenbedingungen&project_id=123456&task_id=234567&hours=1.0'

Pflichtfelder sind mit Stern (*) markiert:
  • date* – "2017-06-11"
  • description* – "Analyse Rahmenbedingungen und Abhängigkeiten"
  • project_id* – 123456 (ID eines zugewiesenen Projekts)
  • task_id* – 234567 (ID einer aktiven Leistung)
  • hours* – 1.0
  • billable – true/false (Standard: true bzw. je nach Projektvorgabe)
  • tag – "RMT-123" (manuelle Vergabe von Tags)


PUT activities/{id}

Aktualisieren eines Zeiteintrags:

curl -X PUT \
  https://{domain}.mocoapp.com/api/v1/activities/{123} \
  -H 'authorization: Token token={api-key}' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'hours=2.0'

Felder sind analog zur Erstellung.


DELETE activities/{id}

Das Löschen eines Zeiteintrags ist nur möglich, solange dieser noch nicht verrechnet oder gesperrt ist.

curl -X DELETE \
  https://{domain}.mocoapp.com/api/v1/activities/{123} \
  -H 'authorization: Token token={api-key}'


POST activities/disregard

Markieren von Zeiteinträgen als "bereits abgerechnet".

curl -X POST \
  https://{domain}.mocoapp.com/api/v1/activities/disregard \
  -H 'authorization: Token token={api-key}' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'activity_ids[]=47268&activity_ids[]=47269&reason=Kulanzleistung wie besprochen'

Pflichtfelder sind mit Stern (*) markiert:
  • reason*  "Kulanzleistung wie besprochen..."
  • activity_ids* – [123, 234, 345]
  • customer_id* – 123456 (ID des Kunden, dem die Einträge zugeordnet sind)
  • project_id – 234567 (ID des Projekts, dem die Einträge zugeordnet sind)


Mehr zu API...
30 Tage gratis

Account sofort startbereit. Voller Funktionsumfang. Ohne Zahlungsangaben.