README

描述

MPAPI客户端是一个工具，旨在帮助互联网商场合作伙伴轻松连接到商场环境（如Mall.cz或Mall.sk）的市场目录和订单处理。

获取MPAPI客户端

我们建议使用Composer。一旦安装了Composer，您可以在项目根目录中执行以下命令以获取mpapi-client库：composer require mallgroup/mpapi-client

要检查安装是否成功，请转到vendor文件夹。您应该在那里看到mallgroup文件夹。请确保您已包含自动加载器

require_once '/path/to/your-project/vendor/autoload.php';

实现

通过MPAPI客户端连接您的商店尽可能简单，但我们期望您对PHP5有一些基本了解。您需要连接到位于/vendor/mallgroup/mpapi/src/Services的所有服务，如/vendor/mallgroup/mpapi/Example中的示例文件所示。服务提供从商场环境接收数据以及发送、更新或删除数据的函数。

您的客户端ID

我们在商场中使用两种不同的环境：测试和生产。您将为每个环境获得两个不同的客户端ID，这样您就可以在不影响生产环境交易的情况下测试数据。您需要一个客户端ID作为MPAPI客户端的参数：$mpapiClient = new Client('yourTestClientId');

记录器

MPAPI客户端实现了一个记录器接口，使用简单的PSR记录器来记录错误和所有重要事件。您可以选择实现任何现成的日志库，例如[monolog] (https://packagist.org.cn/packages/monolog/monolog)，如下例所示，或者您将实现自己的日志记录。 $logger = new Logger('yourLoggerName'); $logger->pushHandler(new StreamHandler('./elog.log', Logger::INFO)); $mpapiClient->setLogger($logger);

更多内容请参阅/path/to/your-project/vendor/mallgroup/mpapi-client/Example/LoggerExample.php。

实现的基本示例

<?php
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use MPAPI\Services\Client;
use MPAPI\Services\NameOfService; // replace this with relevant service name

// include your composer dependencies
require __DIR__ . '/../vendor/autoload.php';

$mpapiClient = new Client('yourTestClientId');

$logger = new Logger('yourLoggerName');
$logger->pushHandler(new StreamHandler('./elog.log', Logger::INFO));

// set logger into MP API client
$mpapiClient->setLogger($logger);

// create instance of the required service
$exampleService = new NameOfService($mpapiClient);
...

有关如何使用特定服务的更多示例，请参阅以下链接

• 产品 – 创建、更新、删除或获取数据。
• 变体 – 创建、更新、删除或获取数据。
• 可用性 – 更新产品或变体。
• 定价 - 更新产品或变体的定价。
• 供应延迟 – 创建、更新、删除或获取产品或变体的供应延迟。
• 订单 - 获取特定订单的信息，获取所有开放或未确认订单的订单ID，更改订单状态。
• 合作伙伴配送 - 获取、创建或更新合作伙伴配送。
• 配送定价 - 获取、创建、更新或删除配送定价级别。
• 标签 - 获取可用标签列表。
• 分类 - 获取所有分类，通过短语或前缀搜索标题，获取特定分类的可用参数。
• 品牌 - 获取所有品牌，通过短语搜索标题。
• 合作伙伴 - 管理合作伙伴供应延迟。