koobar/laravel-fortnox

Fortnox API 客户端 for Laravel

v0.1.3 2023-12-01 12:18 UTC

This package is auto-updated.

Last update: 2024-08-30 01:44:58 UTC


README

简化了与 Fortnox API 的集成。

请注意!此软件包尚不支持 Fortnox API 中所有可用的资源

要求

  • Laravel 6 或更高版本
  • PHP 8.0 或更高版本
  • 有效的客户端 ID(来自 Fortnox)
  • 有效的客户端密钥(来自 Fortnox)
  • 有效的刷新令牌(来自 Fortnox)

安装

您可以通过 Composer 安装此软件包

composer require kfoobar/laravel-fortnox

.env 配置

FORTNOX_CLIENT_ID=
FORTNOX_CLIENT_SECRET=
FORTNOX_REFRESH_TOKEN=

Fortnox 授权

为了使用 Fortnox API,您需要一个有效的刷新令牌。要获取刷新令牌,您需要通过 Fortnox 的 OAuth2 授权码流授予集成访问权限。在这个过程中,您将分配一个 授权码,您可以使用它来交换一对令牌

访问令牌 - 用于验证所有 API 请求 - 只在 1 小时内有效,并需要使用刷新令牌进行刷新。只要您有一个有效的刷新令牌,此软件包就会处理此过程。

刷新令牌 - 用于更新访问令牌 - 有效期为 30 天。如果它过期,您需要重新执行 OAuth2 授权流程。

每次更新您的访问令牌时,您都将分配一个新的刷新令牌,该令牌有效期为另外 30 天。因此,定期更新令牌非常重要,以确保刷新令牌不会过期。

您可以使用以下命令更新您的令牌

php artisan fortnox:refresh

访问令牌和刷新令牌都存储在您应用程序的缓存中。在清除缓存或更改缓存驱动程序时,请记住这一点。

说明

即将推出...

贡献

欢迎贡献!

许可

MIT 许可证(MIT)。有关更多信息,请参阅 许可文件