Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
API Documentation for Freckle Time Tracking
Branch: master
Pull request Compare This branch is 314 commits behind cheerful:alpha.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
data
README.mkdn
entries.mkdn
projects.mkdn
tags.mkdn
users.mkdn

README.mkdn

Freckle Restful API

General

The API for a freckle account can only be accessed via the accounts full URL. So each API request has to be made to http://myfreckle.letsfreckle.com/api/ where myfreckle is the account's subdomain.

An authtoken is needed for accessing the API. The token identifies the user and can be obtained from the users personal settings page. It has to be sent for each request in either one of this two ways:

  • as query parameter named token

    e.g curl http://myfreckle.letsfreckle.com/api/projects.xml?token=10ee9d50a2f540518c5d1f9448e43f96056af626

  • as a custom HTTP header X-FreckleToken

    e.g curl -H "X-FreckleToken:10ee9d50a2f540518c5d1f9448e43f96056af626" http://myfreckle.letsfreckle.com/api/projects.xml

Note: To simplify authentication on mobile devices, the token can be received with the api_auth_token call, see the users section for more information.

API Test Account

Testaccount data:

Domain: apitest.letsfreckle.com Token: lx3gi6pxdjtjn57afp8c2bv1me7g89j

Note: The data from this test account will be regularly wiped, so don't rely on it.

Data Formats

In the examples XML will be used as data format. However, the API calls will mostly also accept and respond to JSON.

Contents

  • Entries
    • create a single entry
    • bulk import entries
  • Projects
    • list available projects
  • Tags
    • list available tags
  • Users
Something went wrong with that request. Please try again.