jolicode / harvest-php-api
Harvest API 的最新 PHP 客户端
v7.0.0
2024-03-29 11:17 UTC
Requires
- php: >=8.1
- jane-php/open-api-runtime: ^7.6
- php-http/client-common: ^1.9 || ^2.0
- php-http/client-implementation: *
Requires (Dev)
- jane-php/open-api-3: ^7.6
- nyholm/psr7: ^1.6
- symfony/http-client: ^5.4 || ^6.0 || ^7.0
- symfony/phpunit-bridge: ^5.4 || ^6.0 || ^7.0
- symfony/yaml: ^5.4 || ^6.0 || ^7.0
README
Harvest 是一款时间跟踪和发票工具。
此 PHP SDK 使用 JanePHP 以及从 HTML 文档生成的 Harvest OpenAPI 规范 自动生成。这意味着
- 所有 API 端点和参数都得到支持。请参阅 可用端点列表;
- 当文档更改时,很容易更新库并保持最新。
API 已通过 Harvest API 文档中提供的示例进行测试。
安装
此库基于 PSR-7 和 PSR-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 文件。