F.A.Q.

What is RoundBee?

Roundbee is a time/task tracking JSON API. Website you are currently on is a demo-client of Roundbee JSON API.

What is demo?

Demo is time/task tracking application based on Roundbee JSON API.

What functions are implemented?

Using this Demo Application you can add/edit/delete Projects and Tasks, track time by starting and stopping Activities.

Also you can generate Reports for Day, Task or Project using Reports section.

What objects and functions are available?

Main three objects are Activity, Task and Project.

Activity is a main time tracking object. Activities may be linked to Tasks. Tasks can be grouped to Projects. All three objects can be listed, created, edited and deleted.

Activity can be started and stopped. API tracks summary time per Activity.

Should I be registered in order to use the API?

Yes, you should have User login and password in order to interact with API. Once logged in, User gets session key which is used with every request.

Why I cannot find Signup or Register page?

API is designed such way that only Subscriber can add new users.

You can apply to become a Subscriber and create unlimited number of users. Small donation for BETA access to api.roundbee.com is welcome.

Who are Subscribers?

Subsciber is a company or an individual who has administrative access to API and pays for the service. Subscriber can create unlimited number of Users.

How can I register as User?

You can not. Only Subscribers can create Users using Subscriber's interface.

But how user can access API?

RoundBee time tracking API is still in Beta. If you want to join the project and get early access to API, please sign up on Roundbee Website, providing some information about yourself and how you wish to use the API. If your request will be approved, you will receive User Account. Please specify if you require Subscriber's credentials and extended access to the API.

How service is paid?

Every User interaction with the API is called a 'pass'. Logging in, reading list of Tasks, starting or stopping Activity is a 'pass'. Subscribers buys 'passes' in packages, which are stored with Subscriber's account. Every pass made by User is deducted from Subscriber's account. Packages sold for example can have 10000 passes, which is approximately enough for month of usage for company of 5 people. When Subscriber account goes low on passes count, email notification will be sent, inviting to buy additional package. Once passes count is 0 or less (it's possible to work into some negative pass count), Subscriber and Users registered by Subscriber will not be allowed to do API requests.

What's a Pass ?

Pass is a payment unit.

  • Each interaction with API costs User 1 Pass
  • Subscriber's account is debited for all User's interactions with the API

Who's User ?

End-User of RoundBee API

  • Actually uses API
  • Has Activities, Tasks, Projects
  • Created and granted access to API by Subscriber

How can I become a Subscriber?

Please register with a form here: Google Forms. FOR BETA PERIOD ONLY: while in BETA, the API is operating on donations. Donations will be spent on server equiplent. Not all applied will get Subscriber account. Early Subscribers will get discounts and benefits after API goes live.

What can I do when I get Subscriber access?

You can create unlimited number of Users. Then you can use API for time/task tracking. For example you can build your own mobile application or integrate RoundBee API with corporate systems in order to add time/task tracking capabilities to existing application.

Is there existing tool or app that is using RoundBee API?

This Demo application roundbee.com is a showcase featuring implementation of the API. This Demo application can be used for actual time/task tracking, but it has only basic features. Main idea is that YOU decide what to do with RoundBee API, and what application to build around it.

What are building blocks of API ?

  1. Tidbit: Ti(me) Bit, smallest time interval, user starts and stops tidbits
  2. Activity: the work you do, can have many Tidbits, as Activity can be started and stopped
  3. Task: bunch of Activities
  4. Project: bunch of Tasks or Activities

I want to build better application! Where can I find API reference?

API reference is available on docs.roundbee.com

Part of the API documentation about Authentification is only available for Subscribers.

This Demo is only built to show capabilities of the API, we encourage you to build your own time tracking application using RoundBee API, or integrate RoundBee API into existing application.