dawguk/strava

A simple-to-use (single file!) library to easily interrogate the Strava v3 API

Strava v3 API Client

This is a single-file-library that you can use to interrogate the Strava v3 API. It handles authentication as well as whatever API calls you want to make (as long as they are valid), _(*1)

Usage

First off you need to construct a configuration array. The array should contain at least the following information:, _(*2)

• CLIENT_ID
• CLIENT_SECRET
• REDIRECT_URI
• ACCESS SCOPE

CLIENT_ID and CLIENT_SECRET should be taken from the My API Application section of the site. Valid ACCESS_SCOPE values can be found in the Strava API documentation, _(*3)

Optionally, you can supply the following addition configuration options:, _(*4)

• CACHE_DIRECTORY
• ACCESS_TOKEN

If CACHE_DIRECTORY isn't supplied, the library falls back to writing to /tmp, _(*5)

If ACCESS_TOKEN is supplied, we bypass authorization and token exchange - assuming the ACCESS_TOKEN is correct., _(*6)

Examples

To configure the client, you would define your parameters as follows:, _(*7)

<?php
$arrConfig = array(
   'CLIENT_ID' => 1354,
   'CLIENT_SECRET' => 'here is my client secret',
   'REDIRECT_URI' => 'http://localhost/example.php',
   'CACHE_DIRECTORY' => '/path/to/cache/dir/',
   'ACCESS_SCOPE' => 'write'
);

The following example GETs information about the authenticated athlete:, _(*8)

<?php
$objStrava = new \dawguk\Strava($arrConfig);
print_r($objStrava->get('athlete', array()));

The following example PUTs (updates) the weight information for the current athlete:, _(*9)

<?php
$objStrava = new \dawguk\Strava($arrConfig);
print_r($objStrava->put('athlete', array('weight' => 62.8)));

Notes

Currently the library will only store a single access token, so isn't ready for multi-user authentication. This is expected to change in the future, with token storage abstracted out., _(*10)

Now available on packagist.org ;D, _(*11)

References

http://strava.github.io/api/v3 is a good place to start., _(*12)