Target365 SDK

v1.8.13 2024-06-12 08:55 UTC

README

Strex AS 是一家挪威支付和 SMS 网关(Strex Connect)服务提供商。Strex 持有电子货币许可证,并每年处理超过 7000 万笔交易。Strex 在挪威拥有超过 4.2 百万客户,由挪威移动网络运营商(Telenor、Telia 和 Ice)拥有。Strex Connect 基于Target365 营销和通信平台。

PHP 的 Target365 SDK

License

入门

要开始,请点击此处: https://strex.no/strex-connect#Prispakker 并注册您的组织。有关 SDK,请发送电子邮件至 sdk@strex.no,其中包含您的 RSA 公钥(PEM 格式)。您可以使用 openssl 生成 RSA 公钥/私钥对,如下所示

openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:1024 -out private.pem

使用 openssl 将其转换为 pk8 格式,这是 PHP 使用的。

openssl pkcs8 -topk8 -inform pem -in private.pem -outform pem -nocrypt -out private.key

私钥文件 private.key 应该看起来像这样

-----BEGIN PRIVATE KEY-----
MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBAML6duyE7hL2XPEH
qiYtyghoj6pO21zGPwSaBKTCg6i3AeJ4Ob6pCnvYQA+rRfw/+aBfT+Rv3LTSmX2i
9bAsLQB0Q3y8zku2NmqE/yoqhb9GAhL3toMasBuJ3ifvUOXTajtGEKy++YkAkRBK
7Wi/bK/IQNZd9nsOtKxz5DXNELbHAgMBAAECgYAj6k8Nsk7IX2kvXOIStkyIz/nm
vS/bHwlsp5JDZzEpWsyWEt9QJ4Mu3N6wBDSYCpDI4cWtpo1ZIZH0epgXI4wGPv2j
a6ilWZywUdhFZw1AUc3qLRoapqIPliimLhxPWmV2OfvbA4LiNvWGsF/qTaqVQ/0V
ebj+JYjJdFQcTjqlwQJBAOpKQ/EyuzDlO7YVPmw0rAfVRfVqTIvzpZ3hGThztcnQ
igI3ftbGSOPUcter3/cX5ENrIGMP6hLsWqSKWECBwK0CQQDVC6mVkrit/VXby2Zp
8epgprGhrUHojNO7ojQQN1Mupr4AHUWr2Y3xJH1uXaOjafBc6uLK7Cri3eLru+iy
Ph/DAkBLG/fgEVV1fWfBHdpfMhucf0DoRmW30CpeDNXbBS1YP6SexU/CZtrjPy55
+b3ZJy2kd2lwmJ9/5YnBiiB0vaQZAkEAuTgPcrOBjfqu94zpd/hTTT3/NtGbeGNe
/UTywJpo3iknDJBmbxaQOfMAfcA5MSw8RXwMOmGCk4RW8Z2Hm9c44wJBAJvIcnMV
6b2G6pizPPjoPhV+eNruWTyFt5ralEmxDpqV3p4TP89KVvaBlkzlT28p1P9vp5bD
J6BLhdOAUfC3CMY=
-----END PRIVATE KEY-----

请注意,当在 PHP 中使用私钥时,必须删除所有换行符,以确保私钥在一行中。

使用以下 openssl 命令提取公钥

openssl rsa -in private.key -pubout -out public.key

然后,您可以发送 public.key 文件给我们。文件应该看起来像这样

-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDC+nbshO4S9lzxB6omLcoIaI+q
Tttcxj8EmgSkwoOotwHieDm+qQp72EAPq0X8P/mgX0/kb9y00pl9ovWwLC0AdEN8
vM5LtjZqhP8qKoW/RgIS97aDGrAbid4n71Dl02o7RhCsvvmJAJEQSu1ov2yvyEDW
XfZ7DrSsc+Q1zRC2xwIDAQAB
-----END PUBLIC KEY-----

有关 SDK 的更多详细信息,我们强烈建议您查看我们的 PHP 用户指南

Composer

composer require target365/sdk

Latest Stable Version

测试环境

我们的测试环境充当沙箱,尽可能地模拟真实 API。这可以用于在投入生产之前熟悉服务。请注意,模拟并不完美,不应被视为具有 100% 的准确性。

Url: https://test.target365.io/

生产环境

我们的生产环境是隔离的租户环境与共享公共环境的组合。如果您对隔离的租户环境感兴趣,请联系 sdk@strex.no

Url: https://shared.target365.io/

作者和维护者

Target365 (sdk@strex.no)

问题/错误/疑问

如果您有任何疑问或问题,请随时对此存储库提出问题。

私钥

Target365 PHP SDK 只允许 RSA 私钥。私钥应传递给 \Target365\ApiSdk\ApiClient 构造函数。密钥可以包含 -----BEGIN RSA PRIVATE KEY----- 部分。您必须在使用 PHP SDK 时从私钥中删除所有换行符。

贡献

欢迎新的贡献者加入此项目。如果您有兴趣贡献,请发送电子邮件至 sdk@strex.no

自动测试

自动测试使用 PHPUnit 框架。以下是运行自动测试的推荐步骤。

  • 克隆存储库。
  • 更改到存储库目录。
  • (可选)使用 vagrant 文件作为 tests/Vagrantfile
  • 运行 composer install
    • 运行 composer 将提示您输入一些必要的信息,这些信息将被存储在名为 tests/secrets.yml 的文件中。
    • 输入 private_key 时,将密钥作为一行字符串输入,并排除 -----BEGIN RSA PRIVATE KEY----- 部分。
  • 运行 PHPUnit。 ./vendor/bin/phpunit

许可证

此库采用 MIT 许可证发布。