README

该项目是对 Cdiscount/API-MarketPlace-SDK-PHP 父项目的更新。

主要变更包括在无需修改提供的 config.ini 文件的情况下，将用户名、密码、令牌 URL 和 cURL 选项传递到 API 功能中的能力。

进行这些更改的原因是为了更好地支持 Laravel 等框架，并阻止用户直接编辑 vendor 目录中的文件。

1.1 - 最小要求

• Apache 2.2
• Php 5.6

2.1- 在您的根项目文件夹中克隆 Git 仓库

SDK 结构如下

• config/ : 配置文件
• samples/ : 样例文件夹
• sdk/ : Cdiscount SDK 内容（不要修改此文件夹中的任何文件）

2.2- 在 sdk 文件夹的根路径中运行 'composer update' 命令以下载 Zend Framework 依赖项

3 - 插入您的 API 凭据

3.1 - 要求

要使用 Cdiscount Marketplace API 和 Cdiscount Marketplace SDK，您首先需要遵循 Cdiscount Marketplace API 网站上描述的步骤。

以下是一些部分

• 请求创建账户。
• 设置账户

3.2 - 更新配置文件

按照插入 API 凭据的程序操作

• 打开配置文件夹
• 打开 config.ini 文件
• 设置 api 模式：'preprod' 或 'prod'
• 打开 preprod.config.ini 文件或 prod.config.ini 文件（如果您将模式设置为 'prod'）
• 设置您的 api 用户名
• 设置您的 api 密码

4 - 使用 SDK

4.1 - 使用端点

SDK 包含以下端点

• 卖家
• 出价
• 讨论
• 产品
• 订单
• 中继

所有 SDK 方法都在 MarketPlace API 网站上进行了描述，因为它们的名称与 Cdiscount Marketplace API 方法相同。

对于每个方法，都有一个 PHP 文件，其中包含调用相应 API 函数的示例。

例如，要调用 GetSellerInformation API 方法，请打开包含在 Seller 文件夹中的 GetSellerInformation.php 文件，并按照示例步骤操作。

4.2 - CDSApiClient 对象

CDSApiClient 允许您调用 API。

CDSApiClient 对象包含所有端点。它还会为您创建一个获取令牌的 API 调用。

不要每次调用 API 时都创建一个新的 CDSApiClient！

您可以使用（必须使用）相同的 CDSApiClient 来执行所有 API 调用。

以下是一个如何为多个 API 调用使用相同的 CDSApiClient 的示例

$client = new \Sdk\ApiClient\CDSApiClient(); $token = $client->init(); if ($token == null || !$client->isTokenValid()) { echo "生成令牌时出现问题"; die; } $offerPoint = $client->getOfferPoint(); $offerListResponse = $offerPoint->getOfferList(null); /** 在此处解析 $offerListResponse **/ $sellerPoint = $client->getSellerPoint(); $sellerResponse = $sellerPoint->getSellerInformation(); /** 在此处解析 $sellerResponse **/

5 - 更新 SDK

从 CDiscount Marketplace API 网站下载新的 SDK Zip 文件

用新的替换 SDK 文件夹

使用新的文件夹替换供应商文件夹

注意事项

在示例中，参数 error_reporting 设置为 '-1'。不要在生产模式下使用。