ksidenko / smartsheet-php-client
与 Smartsheet API 交互的 PHP 客户端库
dev-master
2015-11-08 05:21 UTC
Requires
- php: >=5.4.0
- guzzlehttp/guzzle: ~5.0
- guzzlehttp/guzzle-services: *
- guzzlehttp/log-subscriber: *
- guzzlehttp/retry-subscriber: *
Requires (Dev)
- phpunit/phpunit: ~4.0
This package is not auto-updated.
Last update: 2024-10-02 18:47:47 UTC
README
用于与 Smartsheet API 交互的 PHP 客户端。
随着我们需要的功能,我们慢慢构建了这个客户端。最初,我们只需要用它来管理用户账户。
该客户端基于 Guzzle PHP HTTP 客户端构建。Guzzle 提供了一种简单的方法来创建 API 客户端,通过以 Swagger 类似的形式描述 API,无需自行实现每个方法。因此,添加对更多 Smartsheet API 的支持相对简单。如果您想提交拉取请求添加另一个功能,请这样做。如果您不知道如何操作,请向我们询问,我们可能会为您添加它。
Smartsheet API 认证
Smartsheet 支持用户生成令牌或 OAuth 2.0 进行授权。然而,该客户端仅支持用户生成令牌方法。有关更多信息,请参阅 http://www.smartsheet.com/developers/api-documentation#h.y2e83x6xwscl。
安装
使用 Composer 安装非常简单。将 "ksidenko/smartsheet-php-client", "dev-master"
添加到您的 composer.json
文件中,然后更新。
使用方法
示例
<?php use Smartsheet\Client; $client = new Client([ 'access_token' => '1234567890', ]); $user = $client->getUser(['id' => 123456789]); echo $user['email']; // example@domain.org $newUser = $client->addUser([ "email" => "test_user@domain.org", "name" => "test user", "firstName" => "test", "lastName" => "user", "admin" => false, "licensedSheetCreator" => false, "resourceManager" => false, ]); echo $user['result']['id']; // 1234567890
Guzzle 服务客户端说明
- Jeremy Lindblom 的演示: https://speakerdeck.com/jeremeamia/building-web-service-clients-with-guzzle-1
- Jeremy Lindblom 的示例: https://github.com/jeremeamia/sunshinephp-guzzle-examples
- 源代码注释中的参数文档: https://github.com/guzzle/guzzle-services/blob/master/src/Parameter.php