ksidenko/smartsheet-php-client

与 Smartsheet API 交互的 PHP 客户端库

dev-master 2015-11-08 05:21 UTC

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 服务客户端说明