billbee/foreign-systems-sdk

用于连接国外系统到Billbee的SDK

v1.0.0-beta 2024-07-31 10:04 UTC

This package is auto-updated.

Last update: 2024-08-31 15:28:33 UTC


README

这是即将推出的Billbee国外系统API的PHP SDK。

国外系统API将取代自定义商店API,因为它更灵活,并为开发者提供了更好的体验。

与自定义商店API的区别

自定义商店API支持的是,正如其名,只有网店和电商平台。国外系统API旨在支持其他系统。目前只支持网店和电商平台,但我们将未来支持物流系统、支付系统和其他系统。

为了实现这一点,我们将部分逻辑从我们的这边移到了实施者那边。我们发出的第一个API调用是一个配置调用。这个调用用于查询你端的所有支持功能以及配置细节,例如授权方式和HTTP头。

您的系统需要将ProvisioningDetails发布到我们发出的调用中给出的URL。

进一步的通信与旧的定制商店API非常相似。

安装

composer require billbee/foreign-systems-sdk

使用方法

这是最简单的实现方法

<?php

declare(strict_types=1);

require_once __DIR__ . '/../vendor/autoload.php';

use Billbee\ForeignSystemsSdk\Channel\Http\OrderRequestHandler;
use Billbee\ForeignSystemsSdk\Channel\Http\ProductRequestHandler;
use Billbee\ForeignSystemsSdk\Http\Abstraction\Request;
use Billbee\ForeignSystemsSdk\Http\RequestHandlerPool;
use Billbee\ForeignSystemsSdk\Provisioning\Http\ProvisioningRequestHandler;

$request = Request::createFromGlobals();

$pool = new RequestHandlerPool();
$pool->addHandler(new ProvisioningRequestHandler(new YourProvisioningDetailsRepository()));
$pool->addHandler(new OrderRequestHandler(new YourOrderRepository()));

$response = $pool->handle($request);

$response->send();

由于文档尚未最终确定,您可以查看旧文档,因为概念相当相似:[https://github.com/billbeeio/custom-shop-php-sdk/blob/master/docs/index.md](https://github.com/billbeeio/custom-shop-php-sdk/blob/master/docs/index.md)

此外,如果您需要从自定义商店SDK迁移到国外系统SDK的指导,我们提供了一个迁移指南,目前仅提供德语版本:[https://github.com/billbeeio/foreign-systems-sdk-php/blob/main/MIGRATION_GUIDE.md](https://github.com/billbeeio/foreign-systems-sdk-php/blob/main/MIGRATION_GUIDE.md)