jolicode/harvest-php-api

Harvest API 的最新 PHP 客户端

v7.0.0 2024-03-29 11:17 UTC

README

example workflow

Harvest 是一款时间跟踪和发票工具。

此 PHP SDK 使用 JanePHP 以及从 HTML 文档生成的 Harvest OpenAPI 规范 自动生成。这意味着

  • 所有 API 端点和参数都得到支持。请参阅 可用端点列表;
  • 当文档更改时,很容易更新库并保持最新。

API 已通过 Harvest API 文档中提供的示例进行测试。

安装

此库基于 PSR-7PSR-18 构建。因此,您需要安装一些这些接口的实现。

如果您的项目中还没有 PSR-18 客户端或 PSR-7 消息工厂,或者您不知道或不在乎使用哪个,只需安装一些默认的

composer require symfony/http-client nyholm/psr7

现在您可以安装 Harvest 客户端了

composer require jolicode/harvest-php-api

使用方法

首先,您需要检索一个访问令牌。请参阅 Harvest 关于 OAuth2 授权流程 的文档。

然后,使用提供的工厂创建客户端

// $harvestClient contains all the methods to interact with the API
$harvestClient = JoliCode\Harvest\ClientFactory::create(
  $accessToken,
  $harvestAccountId
);

$clients = $harvestClient->listClients([
  'is_active' => true,
])->getClients();

dump($clients);

需要更多示例或文档?请参阅 文档,其中列出了所有可用方法。

故障排除

在使用此库时遇到问题?需要缺少的功能?请毫不犹豫地 提交问题 并与我们分享。

更多文档

您可以使用以下方式查看当前和过去的版本:

最后是一些元文档

许可证

此库受 MIT 许可证的许可 - 详细信息请参阅 LICENSE 文件。