DayCaptain’s REST API (working draft)

DayCaptain offers a REST API to manager a user’s information objects.

The API is usable with any technology that supports HTTP.

Categories

• Tasks

• Time events

• Day events

• Backlogs (TBD)

• Projects (TBD)

• Areas (TBD)

Authentication

To authenticate your user in the API calls, you have to include a Bearer token.

You generate a token in your user account (G+X) under the section API Tokens. The generated token is used as the Bearer token in the Authorization HTTP header, as seen below.

Example:

"Your token: 123[..]abc "
will be included as Authorization: Bearer 123[..]abc HTTP header in the request.

An example call that creates a new day task looks as follows (with curl):

curl 'https://daycaptain.com/2021-12-31/tasks' \
  -XPOST -i \
  -H "Authorization: Bearer <token>" \
  -H 'Content-Type: application/json' \
  -d '{"string":"Hello Captain"}'