Tempo API Reference

Overview

¡Cuidado!

This document is currently under revision! We are getting close to releasing a large upgrade to Tempo, and that will bring with it a few changes and additions to the API. Changes are noted within and tagged ‘Beta’ for your reference. Keep an eye on our blog for updates and deploy dates.

Introduction

We have exposed an Application Programming Interface (API) so that anyone who is so inclined can create alternative interfaces to Tempo or integrate Tempo with an external service. This document describes how to connect to the API and what resources and methods are available.

Requirements

  • Since the API lives alongside the web interface, you must tell it that you want data and not HTML.
  • To work with XML data, supply the headers ‘Accepts: application/xml’ and ‘Content-Type: application/xml’ with each request.
  • JSON data is now supported as well (use ‘application/json’ in the headers)
  • Every request must be authenticated over HTTP Basic Authentication. This simply means providing your Tempo login and password along with each request.
Here’s an example of such a request, using curl: 
curl -X GET -H 'Accept: application/xml' -H 'Content-Type: application/xml' \
  --user mylogin:mypassword https://app.keeptempo.com/entries

Since all Tempo accounts support SSL, it would be prudent of you to connect using https when accessing the API to protect your password from prying eyes.

RESTful Resources

All end-points in our API are REST-style resources, supporting the usual set of GET, PUT, POST and DELETE operations at RESTful URLs. This means you should be able to use a framework like ActiveResource to interact with our API.

Note: As of 17-FEB-09, we’ve gone back to including “type” attributes in our XML output. You don’t need to include type attributes on your incoming data (except in some instances, see the context search section below), but it can’t hurt for non-string data.

Getting Help

We’re putting a significant amount of work into improving our API and the documentation to encourage our customers to use it. If you run into any trouble, if you need to be pointed in the right direction, or if you just want us to check out what you’ve got going on, please send us an email: support AT zetetic.net