janhenkes/teamleader-php-sdk

Teamleader API v2 PHP SDK

维护者

详细信息

github.com/janhenkes/teamleader-php-sdk

主页

源代码

问题

安装次数: 7,301

依赖项: 1

建议者: 0

安全性: 0

星标: 16

关注者: 6

分支: 25

开放问题: 3

2.9.8 2024-04-10 07:09 UTC

Requires

Requires (Dev)

MIT 7b3293ad3a527791cc452054fa81e0450c49d06d

Teamleader

This package is auto-updated.

Last update: 2024-09-23 07:29:11 UTC

README

这是 Teamleader API v2 的 PHP 封装。API 的文档可以在这里找到：[https://developer.focus.teamleader.eu/](https://developer.focus.teamleader.eu/)。请注意，Teamleader API v2 并不完整，一些实体和操作缺失。

目前我们支持以下实体，每个实体仅支持少量操作

  1. 公司（创建和更新，根据 ID 获取）
  2. 联系人（创建，更新，链接到公司，根据 ID 获取）
  3. 交易（创建，更新，移动，获取，根据 ID 获取）
  4. 交易阶段（获取）
  5. 交易来源（获取）
  6. 活动类型（获取）
  7. 事件（创建，更新，删除，获取，根据 ID 获取）
  8. 业务类型（获取）
  9. 标签（获取）
  10. 发票（获取，登记，登记付款，下载，文件）
  11. 贷项通知（获取）
  12. 付款条款（获取）
  13. 税率（获取）
  14. 预扣税税率（获取）
  15. 部门（获取）
  16. 用户（我，获取，根据 ID 获取）
  17. Webhook（获取，注册）
  18. 项目（获取，根据 ID 获取）
  19. 任务（获取，根据 ID 获取）
  20. 里程碑（获取，根据 ID 获取）
  21. 时间跟踪（获取，根据 ID 获取）
  22. 工作类型（获取）
  23. 产品类别（获取）
  24. 产品（创建，获取，根据 ID 获取）
  25. 自定义字段（获取）
  26. 报价（获取，根据 ID 获取，下载，文件）

Teamleader API v2 使用 OAuth2。这意味着您的应用程序需要在 Teamleader Marketplace 上注册（尽管可以保持它们为私有）。

如果您有任何反馈或问题，请通过 jan@jannesmannes.nl 联系我。

支持我们

您可以通过 捐赠 来支持我们。

我们感谢您从您的家乡给我们寄来明信片。您可以在我们的 联系方式页面 上找到我们的地址（受 @spatie 启发）。

示例

在示例目录中查看所有示例。

请求访问令牌

您只需要做一次，在获取访问令牌后，您可以使用刷新令牌在它过期后获取新的访问令牌。

<?php
require __DIR__ . '/../vendor/autoload.php';

require __DIR__ . '/credentials.php';

$redirectUrl = 'https://teamleader-php-sdk.dev/examples/acquire-access-token.php';

$connection = new \Teamleader\Connection();
$connection->setClientId( $clientId );
$connection->setClientSecret( $clientSecret );
$connection->setRedirectUrl( $redirectUrl );

$connection->acquireAccessToken();

创建公司

$company = $client->company( [
    'name' => 'Test API v2',
] )->save();

获取交易阶段

$dealPhases = $client->dealPhase()->get();

变更日志

2.9.3 (2021-12-21)

完整变更日志

  • 修复了 Guzzle 7 支持

2.9.2 (2021-11-23)

完整变更日志

  • 设置 API 版本

2.9.1 (2021-11-22)

完整变更日志

  • 更新了 Guzzle 依赖项

2.9.0 (2021-09-23)

完整变更日志

  • 将基本 URL 更改为 focus.teamleader.eu
  • 更新了实体字段

2.8.0 (2021-02-18)

完整变更日志

  • 改进了默认缓存处理程序

2.7.1 (2021-01-12)

完整变更日志

  • 将自定义字段添加到项目实体

2.7.0 (2020-11-11)

完整变更日志

  • 根据 ID 查找发票

2.6.0 (2020-09-25)

完整变更日志

向 @rQwk 致敬

  • 添加了报价端点

2.5.1 (2020-06-29)

完整变更日志

  • 更新了发票实体的 fillables

2.5.0 (2020-06-22)

完整变更日志

感谢 @kjellknapen

功能

  • 添加了发票下载和文件操作

2.4.0 (2020-06-08)

完整变更日志

感谢 @jurrienpiris

功能

  • 为交易实体的 fillable 属性添加了摘要

2.3.0 (2020-03-15)

完整变更日志

感谢 @marzsman

功能

  • 获取自定义字段

2.2.0 (2020-03-04)

完整变更日志

本次发行归功于 @kjellknapen 和 @PazkaL

功能

  • 书籍发票和登记付款
  • 获取产品类别
  • 获取产品

2.1.0 (2020-03-03)

完整变更日志

本次发行归功于 @cschalenborgh

功能

  • 获取交易改进
  • 获取项目
  • 获取任务
  • 获取里程碑
  • 获取时间跟踪
  • 获取工作类型

2.0.0 (2019-09-24)

完整变更日志

非常感谢 @Senjutsuu 和 @carakas 来自 @sumocoders 对以下大部分更改的贡献！

功能

  • 移动交易
  • 列出和注册网络钩子
  • 添加了仓库许可
  • 添加了旧ID到新ID迁移端点
  • 迁移到PHP 7.1
  • 添加了活动类型实体
  • 添加了事件实体
  • 向所有可存储实体添加了移除端点
  • 添加了业务类型实体
  • 添加了标签实体
  • 添加了发票实体
  • 添加了信用凭证实体
  • 添加了税率实体
  • 添加了付款条款实体
  • 添加了预扣税税率实体
  • 添加了部门实体
  • 添加了单元测试
  • 大量代码重构
  • 向实体添加了筛选、分页和排序属性
  • 添加了JSON序列化
  • 向实体添加了fetchAll方法
  • 添加了用户实体

修复

  • 更新了公司实体的过时属性
  • 修复了在没有缓存数据时从缓存获取数据的问题
  • 修复了Storable::update

1.2.0 (2018-08-23)

完整变更日志

功能

  • 添加了Contact->linkToCompany操作

1.1.1 (2018-08-23)

完整变更日志

功能

  • 添加了readme文件

修复

  • 切换回GuzzleHttp 6

1.1.0 (2018-08-22)

完整变更日志

功能

  • 添加了更多示例
  • 实现了FindAll操作
  • 添加了交易阶段实体
  • 添加了交易来源实体