inhaleexhale/healthgraphapi

基于iamstuartwilson的StravaAPI仓库的HealthGraph API的PHP实现

0.0.3 2017-09-14 19:59 UTC

This package is not auto-updated.

Last update: 2024-09-29 03:47:09 UTC


README

一个简单的PHP类,用于与Runkeeper的HealthGraph API交互。从Iamstuartwilson/strava分叉而来。

Build Status Minimum PHP Version

概述

该类仅包含帮助向API发送数据和从API接收数据的方法。

请阅读API文档以查看可用的端点。

目前不支持文件上传

安装

使用Composer

$ composer require iamstuartwilson/strava

或者

InhaleExhale/runkeeper-php添加到您的composer.json

{
    "require" : {
        "iamstuartwilson/strava" : "~1.3"
    }
}

手动安装

HealthGraphApi.php复制到您的项目中,并在下一节中按照说明在您的应用程序中require它。

入门

包含类,并使用您的注册应用程序client_idclient_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测试用例