Web service interface for online time tracking
Technical description for software developers
The time tracking systems provides a simple interface for software developers to clock in and out users. The interface is implemented as a web service and is suitable for connecting time clocks.
Requirements:
The web service must be activated in the time recording settings (Security tab) and a password must be set. Note: The same password is also used for the REST API.
Technical description
Please use THIS WSDL file.
The service can be reached at: https://www.goodtimetracking.com/goodtime-ws/PunchWS
A simple test client in Java as a zip file or tar file.
Description of the methods
Method punch
Stamps a user in or out.
Handling of very short time entries:
Clocking in and clocking out within the same minute is allowed (in contrast to the web interface).
In this case, the next minute is taken as the end time.
This procedure can result in overlaps between the generated time entries.
In such a case an OverlappingTimeEntryFault (see below) is triggered,
if "Allow overlapping timestamps" is switched off in the settings
(the recommended default setting).
Parameter:
String useremail String webservicepassword Return value
PunchEntryMethod getLastPunchentry
Returns the last time entry of a user.
Parameter:
String useremail String webservicepassword Return value:
PunchEntryMethod hello
This method is for testing and always returns the string "Hello!".
Typ PunchEntry
A time entry with a start time and an end time..
Fields:
String starttime String endtime Faults (Exceptions)
The following types of errors can occur:
AuthenticationFault OverlappingTimeEntryFaultServiceFault