project.timer.start

This method starts a timer. A project id is needed for SUBERNOVA to know which timer to start.

The project id can be retrieved from project.get method.

If the timer is already running in your SUBERNOVA account, you can still call this method, the timer will not be restarted but would only return the current timer values (hours, minutes and seconds) instead.

Call this method via the following URL:

https://app.subernova.com/api/1.0/project.timer.start

Parameters

These are the parameters you can pass with the call:

api_key
Your API key for authentication. This can be found in your account settings.
id
This is the id of the project your timer is attached to.

Response

Success

<?xml version="1.0" encoding="utf-8"?>
  <method request="project.get">
      <project>
         <timer_hour>12</timer_hour>
         <timer_minute>35</timer_minute>
         <timer_seconds>40</timer_seconds>
         <timer_running>1</timer_running>
      </project>
  </method>

SUBERNOVA's timer runs irregardless of whether the app is closed. Once this method is called, the <timer_running> tag will display 1 to confirm that the timer has started running. The current timer hours, minutes and seconds will also be returned in XML format. Your custom application's timer should display this latest timer values before it starts running.

If you already called project.get method and has already displayed the current timer values in your custom application's timer, then you can start running your custom application's timer.


Error (no data passed)

This short message will be returned if no data were passed with the call.

Error: No data were passed.

Error (timer not started)

This short message may be returned if SUBERNOVA's server is down or for some reason the timer cannot be started, which is pretty rare.

Error: Timer not started.

Error (invalid API key)

This short message will be returned if the API key passed with the call is invalid.

Error: API key is invalid.

Error (account expired)

This short message will be returned if your account has expired.

Error: Account expired.

Help

If you have any questions regarding our API or found a bug, please send us a support request.