webmasterskaya/php-unisender-api

维护者

详细信息

github.com/webmasterskaya/php-unisender-api

源代码

问题

安装: 0

依赖: 0

建议者: 0

安全: 0

星标: 0

关注者: 2

分叉: 0

开放问题: 0

dev-master 2024-02-28 15:38 UTC

Requires

MIT 088558828496a106faf299101ad602ef939cf2a2

This package is auto-updated.

Last update: 2024-09-28 17:00:22 UTC

README

PHP API 用于通过 API 集成 Unisender 邮件发送服务。通过 Unisender API 集成可以大大简化电子邮件营销任务的解决方案，允许完全抽象网络层并直接与 API 方法工作。

Unisender API 是一个专为开发者设计的特殊接口，允许将电子邮件发送功能几乎集成到任何公开的 Web 服务中。

电子邮件群发 API 允许管理联系人列表，创建和发送不同类型的消息，查看统计数据，并提供合作伙伴工作的功能。

可以在任何账户上免费使用 API。要获取电子邮件发送 API 的访问权限，需要一个可以复制到 个人账户 的密钥。

免责声明

您知道多少种处理 http api 的解决方案？可以无穷无尽地列举出许多执行相同功能的库：guzzlehttp/guzzle，php-http/curl-client，symfony/http-client，laminas/laminas-http 以及其他数十种！

您使用哪一种？您项目的依赖项使用哪一种？为了实现相同的 PSR，您在自己的项目中拖动了多少个库？

与互联网上大多数解决方案不同，这个库不强制您使用任何特定的 PSR-18 实现，这使得它更加灵活，并简化了在任何应用程序中的集成。

开始之前

SDK 使用 PSR-18 (HTTP-client) 规范。这意味着您的项目中应该注册实现此规范的类（例如，Guzzle）。

使用 psr-discovery 包自动发现依赖项。有关 自动依赖项发现 的详细信息。

安装

使用包管理器 Composer 进行安装。

composer require webmasterskaya/php-unisender-api

初始化

要开始使用，请创建客户端实例。

$client = new \Webmasterskaya\Unisender\Client(string $api_key[, ?array $options]);

参数

  • api_key (string): 您账户的 API 密钥。可以在 个人账户 中获取密钥。
  • options (array): 客户端设置数组。可选。默认为空数组。可用的字段
    • lang (string): 服务器 API 消息的语言（目前支持 ru，en，ua）。默认为 ru。

SDK 方法名称与 文档 中描述的 API 方法名称相同。

可用方法

自动依赖项发现

有关可自动发现的库列表，请参阅以下链接

如果在自动发现列表中没有您项目使用的库，则需要自行注册。有关详细信息，请参阅手动注册依赖库

手动注册依赖库

在Bitrix中注册HttpClient的示例

\PsrDiscovery\Implementations\Psr18\Clients::add(
    \PsrDiscovery\Entities\CandidateEntity::create(
        'bitrix/main',
        '~23',
        static function (string $class = '\Bitrix\Main\Web\HttpClient') {
            return new $class;
        }
    )
);

在Joomla中注册HttpClient的示例

\PsrDiscovery\Implementations\Psr18\Clients::add(
    \PsrDiscovery\Entities\CandidateEntity::create(
        'joomla/http',
        '~3',
        static function (string $class = '\Joomla\Http\Http') {
            return new $class;
        }
    )
);