hdinnovations/laravel-polar-api

POLAR API 的 API 包装器。

v1.0.0 2024-09-24 17:10 UTC

This package is auto-updated.

Last update: 2024-09-24 21:16:19 UTC


README

Larastan Static Analysis Laravel Pint Pest Testing Suite Pest Type Coverage Packagist Version Packagist Downloads

Laravel Polar API 是一个 Laravel 包,它提供了一个对 polar.sh API 的 API 包装器。这个包通过提供一组方便的方法和类来简化与 Polar API 的交互过程。

安装

要安装此包,您可以使用 Composer

composer require hdinnovations/laravel-polar-api

配置

安装包后,您需要发布配置文件

php artisan vendor:publish --provider="HDInnovations\LaravelPolarApi\Providers\PolarApiServiceProvider"

此命令将在您的 config 目录中发布一个 polar-api.php 文件。您可以使用此文件来配置包。配置文件包含以下选项

  • base_url:POLAR API 的基本 URL。
  • token:用于验证请求到 POLAR API 的令牌(PAT)。

您还可以在 .env 文件中设置 POLAR_API_BASE_URLPOLAR_API_TOKEN 环境变量,这是推荐的。

使用文档

请参阅我们的 文档 获取有关如何使用此包及其支持的端点和参数的详细信息。

异常

此包抛出以下异常

  • HDInnovations\LaravelPolarApi\Exceptions\PolarApiNotFoundException:当请求的资源未找到时抛出。
  • HDInnovations\LaravelPolarApi\Exceptions\PolarApiUnprocessableEntityException:当请求无效时抛出。
  • HDInnovations\LaravelPolarApi\Exceptions\PolarApiValidationException:当请求验证失败时抛出。
  • HDInnovations\LaravelPolarApi\Exceptions\PolarApiUnauthorizedException:当请求未经授权时抛出。

测试

要运行测试,请使用以下命令

composer test

测试覆盖率

要生成测试覆盖率,请使用以下命令

composer test-coverage

静态分析

要运行静态分析,请使用以下命令

composer analyze

类型覆盖率

要检查类型覆盖率,请使用以下命令

composer test-type-coverage

许可证

此包是开源软件,采用 MIT 许可证

路线图

  • 支持所有 GET 请求
  • 支持所有 POST 请求
  • 支持所有 PUT 请求
  • 支持所有 DELETE 请求
  • 添加更多异常处理
  • 添加更多示例
  • 100% 测试覆盖率
  • 100% 类型覆盖率