inhaleexhale / healthgraphapi
基于iamstuartwilson的StravaAPI仓库的HealthGraph API的PHP实现
0.0.3
2017-09-14 19:59 UTC
Requires
- php: >=5.5
Requires (Dev)
- phpunit/phpunit: ~4.8
This package is not auto-updated.
Last update: 2024-09-29 03:47:09 UTC
README
一个简单的PHP类,用于与Runkeeper的HealthGraph API交互。从Iamstuartwilson/strava分叉而来。
概述
该类仅包含帮助向API发送数据和从API接收数据的方法。
请阅读API文档以查看可用的端点。
目前不支持文件上传
安装
使用Composer
$ composer require iamstuartwilson/strava
或者
将InhaleExhale/runkeeper-php添加到您的composer.json
{
"require" : {
"iamstuartwilson/strava" : "~1.3"
}
}
手动安装
将HealthGraphApi.php复制到您的项目中,并在下一节中按照说明在您的应用程序中require它。
入门
包含类,并使用您的注册应用程序的client_id和client_secret进行实例化
require_once 'HealthGraphApi.php'; $api = new InhaleExhale\HealthGraphApi( $clientId, $clientSecret );
然后您需要通过请求一个访问代码认证您的Strava账户[1]。您可以使用以下方法生成用于认证的URL
$api->authenticationUrl($redirect, $approvalPrompt = 'auto', $scope = null, $state = null);
当返回代码时,您必须将其交换为认证用户的访问令牌
$api->tokenExchange($code);
在发送任何请求之前,您必须设置从令牌交换返回的访问令牌或通过Strava的私有令牌
$api->setAccessToken($accessToken);
示例请求
获取任何运动员最近的100 KOMs
$api->get('athletes/:id/koms', ['per_page' => 100]);
发布新的活动 [2]
$api->post('activities', [ 'name' => 'API Test', 'type' => 'Ride', 'start_date_local' => date( 'Y-m-d\TH:i:s\Z'), 'elapsed_time' => 3600 ]);
更新运动员的体重 [2]
$api->put('athlete', ['weight' => 70]);
删除活动 [2]
$api->delete('activities/:id');
注意
1. 注册应用程序的账户将为您提供一个访问令牌,所以如果您只是测试端点和方法,可以跳过此步骤。
2. 这些操作在认证用户时需要将权限设置为write
历史版本
前一个版本 1.2.2
更新包括
- 可以访问HTTP响应头
- PHP 7兼容性
- Auth URL生成的基本PHPUnit测试用例