brannow/

myra-web-api

myracloud.com api 的 PHP 实现

1.0.2 2023-03-22 07:24 UTC

This package is auto-updated.

Last update: 2024-09-22 11:16:06 UTC


README

这是什么?

这个库在 guzzlehttp/guzzle 上实现了一个最小的 API 层,以访问 Myracloud Web API。

您可以使用 WebApi 类访问一系列预定义的端点,或者使用签名中间件与您自己的 GuzzleHttp/Guzzle 实例一起使用,以透明地处理请求的认证和签名。

当使用端点时,请记住这些是非常薄的抽象,因此它们将返回包含结果数据的普通数组。Guzzle 或 API 的错误和异常必须在您的代码中处理。

为了获得更多灵活性,您可以使用 GuzzleHttp/Guzzle 实例直接访问 API 端点。在这种情况下,您可以将签名中间件附加到处理认证头,如 WebApi::_construct() 中所示。

$signature = new Signature($secret, $apiKey);
$stack->push(
 Middleware::mapRequest(
     function (RequestInterface $request) use ($signature) {
         return $signature->signRequest($request);
     }
 )
);

安装

通过 Composer

composer require myra-security-gmbh/web-api