, (*1)
StravaApi
The class simply houses methods to help send data to and receive data from the API. Please read the API documentation to see what endpoints are available., (*2)
There is no file upload support at this time., (*3)
Installation
With Composer
``` shell
composer require iamstuartwilson/strava, (*4)
Or add it manually to your `composer.json`:
``` json
{
"require" : {
"iamstuartwilson/strava" : "^1.4"
}
}
Manually
Copy StravaApi.php to your project and require it in your application as described in the next section., (*5)
Getting Started
Instantiate the class with your client_id and client_secret from your registered app:, (*6)
``` php
require_once 'StravaApi.php';, (*7)
$api = new Iamstuartwilson\StravaApi(
$clientId,
$clientSecret
);, (*8)
If you're just testing endpoints/methods you can skip the authentication flow and just use the access token from your [settings page](https://www.strava.com/settings/api).
You will then need to [authenticate](https://developers.strava.com/docs/authentication/) your strava account by requesting an access code. You can generate a URL for authentication using the following method:
``` php
$api->authenticationUrl($redirect, $approvalPrompt = 'auto', $scope = null, $state = null);
When a code is returned you must then exchange it for an access token and a refresh token for the authenticated user:, (*9)
``` php
$result = $api->tokenExchange($code);, (*10)
The token exchange result contains among other data the tokens. You can access them as attributes of the result object:
```php
$accessToken = $result->access_token;
$refreshToken = $result->refresh_token;
$expiresAt = $result->expires_at;
Before making any requests you must set the access and refresh tokens as returned from your token exchange result or via your own private token from Strava:, (*11)
``` php
$api->setAccessToken($accessToken, $refreshToken, $expiresAt);, (*12)
## Example oAuth2 Authentication Flow
`examples/oauth-flow.php` demonstrates how the oAuth2 authentication flow works.
1. Choose how to load the `StravaApi.php` – either via Composer autoloader or by manually *requiring* it.
2. Replace the three config values `CALLBACK_URL`, `STRAVA_API_ID`, and `STRAVA_API_SECRET` at the top of the file
3. Place the file on your server so that it's accessible at `CALLBACK_URL`
4. Point your browser to `CALLBACK_URL` and start the authentication flow.
The scripts prints a lot of verbose information so you get an idea on how the Strava oAuth flow works.
## Example Requests
Once successfully authenticated you're able to communicate with Strava's API.
All actions that change Strava contents (`post`, `put`, `delete`) will need the **scope** set to *write* in the authentication flow.
### Get Athlete Stats
``` php
$api->get('athletes/:id/stats');
List Athlete Activities
Some API endpoints support GET parameters:, (*13)
``` php
$api->get(
'athlete/activities',
[
'page' => 2,
'per_page' => 10,
]
);, (*14)
### Post a new activity
``` php
$api->post(
'activities',
[
'name' => 'API Test',
'type' => 'Ride',
'start_date_local' => date('Y-m-d\TH:i:s\Z'),
'elapsed_time' => 3600,
]
);
Update a athlete's weight
php
$api->put('athlete', ['weight' => 70]);, (*15)
Releases
See CHANGELOG.md., (*16)
Wallogit.com
