bolcom/bolcom-openapi-php-client

bol.com Open API 客户端库

2.3.0 2018-03-14 08:49 UTC

This package is not auto-updated.

Last update: 2024-09-24 02:08:37 UTC


README

Build Status Latest Stable Version Total Downloads Latest Unstable Version License

包含示例代码的客户端库,用于使用 bol.com Open API 版本 4。如果您需要 Open API 版本 3 的客户端/示例,可以使用 https://github.com/devbolcom/bolcom-openapi-php-client/tree/bolcom-openapi-php-client-v3

如果您想为此库做出贡献,可以在本仓库上进行Fork和Pull请求。

库包含以下请求,这些请求也包含在示例脚本中

  • Ping 请求
  • 产品请求
  • 推荐请求
  • 相关产品请求
  • 报价请求
  • 列表请求
  • 搜索请求
  • 会话请求
  • 购物车请求
  • 心愿单请求
  • setReferrer 请求(您需要从开发者中心团队请求扩展权限才能进行此请求)
  • 身份验证请求(您需要从开发者中心团队请求扩展权限才能进行此请求)

包含哪些文件

客户端

  • Request.php
  • 与服务器建立连接
  • 通过头部发送会话
  • Client.php
  • 示例代码执行请求
  • Accessories.php, Basket.php, BasketItem.php, BasketItemProduct.php, Category, CategoryRefinement.php, Offers.php, Product.php, ProductFamilies.php 和 Product.php
  • 用于获取对象的示例类

示例

  • Example.php
  • 运行应用程序的主类
  • index.php
  • 使用键、格式和 debug_mode 调用类 "Example",以及用于加载类的全局函数

最低要求

  • PHP 5.6(或更高版本)

安装和运行示例

  1. 通过Fork、下载zip或安装Composer获取代码
  2. 将所有文件(保持目录结构)上传到Web服务器
  3. 编辑示例文件 "examples/Example.php",添加正确的 AccessKeyID(在 https://partnerblog.bol.com/register/ 请求此密钥),响应格式(xml/json)和 debug_mode bool(0/1)
  4. 打开浏览器并调用您的 index.php 文件所在的URL

开发者文档

https://partnerblog.bol.com/documentatie/open-api/

基本示例

请参阅 examples/ 目录中的关键客户端功能示例。

function __autoload($className)
{
    $fileName = preg_replace('/^BolCom\\\\(\w+)/', 'src/bolcom/$1.php', $className);
    if (file_exists($fileName)) {
        return require_once $fileName;
    }
}

$apiClient = new BolCom\Client('YOUR_APP_KEY', 'json');
$response = $apiClient->getProduct('1002004010708531');
var_dump($response);

使用Composer

composer require "bolcom/bolcom-openapi-php-client" "~2.3"

当使用Composer时,类会自动加载。

运行测试

APP_KEY=YOUR_APP_KEY phpunit