The (Unofficial) Concept 2 Online Logbook REST API

  1. Quick Start
  2. Frequently Asked Questions
  3. API Key
  4. Calling the API
  5. Response formats
  6. API Methods
  7. Roadmap

Quick Start

  1. Get an api key from http://powertwenty.com/c2logapi/1/accounts/register/.
  2. Open http://powertwenty.com/c2logapi/1/user/totalmeters?format=xml&api_key=xxx replacing xxx with your API key. Enter your Concept 2 Online Logbook user id and password when prompted.

Key

An API key is required to access the API. You can get your key by completing this simple registration form. Your key is displayed on the main api key page after confirming your email address.

Calling the API

Programmatically

The documentation for most api methods contains examples of calling them programmatically. Use basic authentication to provide the Concept 2 Online Logbook user name and password. The API will accept the normal basic-authentication string as a URL parameter ?authentication=YX......vdw== as an alternative to the standard authentication HTTP header.

Provide your API key in either a header called X-API-KEY or as a URL parameter '?api_key=xxxxxxxxxxxx'.

From a Browser

Append your API key to the URL using ?api_key=xxxxxxxxx.For example: http://powertwenty.com/c2logapi/1/currentseason/dates?api_key=xxxxxxxxx Use your Concept 2 Online Logbook user-name and password when prompted to login.

Response Formats

The default, preferred, and fully tested format is JSON.

Alternative formats are available on some methods. These are not tested as thoroughly as JSON. Specify them by appending ?format=X to the URL. X can be one of: xml, json, or pickle. Pickle returns pickled python objects representing the response data. Important note: some functions return only JSON data independent of this format.

For example: http://powertwenty.com/c2logapi/1/currentseason/dates?&api_key=xxxxxxxxxxxxx may return:

{
   "start": "2009-05-01 00:00:00",
   "end": "2010-04-30 00:00:00"
}
while http://powertwenty.com/c2logapi/1/currentseason/dates?format=xml&api_key=xxxxxxxx would return:
<response>
   <start>2009-05-01 00:00:00</start>
   <end>2010-04-30 00:00:00</end>
</response>

Workout Types

The list of acceptable values for the workout type field is:

  • standard
  • dynamic
  • slide
  • water
  • paddle
  • ski
  • snow

Methods

The current methods are:
  1. User's Total Meters
  2. User's Team
  3. Current-Season Dates
  4. Current-Season Summary
  5. Current-Season Workouts - Get All Workouts
  6. Current-Season Workouts - Add New Workout
  7. Current-Season Workouts - Delete All
  8. Current-Season Workout - Get One
  9. Current-Season Workout - Delete
  10. Historical Monthly Summaries - Get All Summaries
  11. Historical Monthly Summaries - Add New Summary
  12. Historical Monthly Summaries - Delete All
  13. Historical Monthly Summary - Delete an Existing Summary
  14. Historical Workouts - Years Archived
  15. Historical Workouts - Given Year
  16. Historical Workouts - Get All


Roadmap

Implemented

  • User's Total Meters
  • User's Team
  • Current-Season Dates
  • Current-Season Summary
  • Current-Season Workouts - Get All Workouts
  • Current-Season Workouts - Add New Workout
  • Current-Season Workouts - Delete All
  • Current-Season Workout - Get One
  • Current-Season Workout - Delete
  • Current-Season Workouts - RANK a workout
  • Historical Monthly Summaries - Get All Summaries
  • Historical Monthly Summaries - Add a Summmary
  • Historical Monthly Summaries - Delete All
  • Historical Monthly Summary - Get
  • Historical Monthly Summary - Delete
  • Historical Archived Workouts - Get

Roadmap

  • Historical Monthly Summaries - Add a Summmary
  • Historical Monthly Summaries - Delete All
  • Historical Monthly Summary - Get
  • Historical Monthly Summary - Delete
  • Current-Season Workouts - RANK a workout
  • Archived Workouts - retrieve
  • Current-Season Workouts - Show current RANKed workouts

 
 
Copyright © 2006-2014 by Power Twenty, LLC. All Rights Reserved.
Design by Interspire