wedesignit/bol.com-openapi-php-client

bol.com 开放 API 的客户端库

v4.0.1 2017-04-20 12:17 UTC

This package is auto-updated.

Last update: 2024-09-14 20:50:56 UTC


README

注意:此存储库基于此原始存储库: https://github.com/devbolcom/bolcom-openapi-php-client 它包含一些更新的代码,这阻止了原始存储库正常工作

随着时间的推移,这个库将得到改进。可以通过提出问题来提出请求。

关于语义版本控制的一些建议

此库的主要版本代表它所工作的 bol API 版本。目前这是 API v4,因此所有标签都是 v4.x.x

库的原始描述

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

如果您想为此库做出贡献。您可以在本存储库上执行 Fork 和 Pull request。

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

  • 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.3.2(或更高版本)

安装和运行示例

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

开发者文档

http://developers.bol.com/documentatie/handleiding/

基本示例

请参阅 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 "wedesignit/bol.com-openapi-php-client" "~4.0"

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

运行测试

APP_KEY=YOUR_APP_KEY phpunit