REST API

Model

It's important to understand object model that aTimeLogger (and TimeTrack in future) operates.

Type is type of activity. It can be Work, Study, Sleep, etc. Type has the following fields: name, color, image, order. Types can be grouped.

Group has the same fields as Type but it can contain other types or groups and it cannot be logged.

Activity is something you are doing (or did). Activity has the following fields: type, state, start_date, intervals, comment. Tracked time is stored in intervals field.

Interval has the following fields: activity, from, to.

Activities tab displays activities (that are in paused or running state) and types. History tab displays intervals. Types tab display Groups and Types.

When user presses on type on Activity tab activity is created with state=running and start_date=current date. If you press pause activity state is changed to paused and interval added.

Endpoint

Authentication endpoint is https://app.atimelogger.com

API endpoint is https://app.atimelogger.com/api/v2

Authentication

Everything is simple here - just pass your username/password with every request. Base64 of username:password should be put into Authorization header with 'Basic ' used as prefix, e.g 'Basic dXNlcm5hbWU6cGFzc3dvcmQ='

Methods

GET /types

Optional parameters: offset, limit.

Returns list of types

GET /types/{type_guid}

Returns type by guid.

GET /activities

Returns list of current activities.

GET /intervals

Optional parameters: offset, limit, from (time in seconds since 1970), to (time in seconds since 1970), types (type guids separated by comma)

Returns list of time intervals for selected period and types.

Please note that groups are not supported in types param. If you pass them they will be simply ignored.