wedesignit / bol.com-openapi-php-client
bol.com 开放 API 的客户端库
v4.0.1
2017-04-20 12:17 UTC
Requires
- php: >=5.3.2
Requires (Dev)
- phpunit/phpunit: ~4
This package is auto-updated.
Last update: 2024-09-14 20:50:56 UTC
README
注意:此存储库基于此原始存储库: https://github.com/devbolcom/bolcom-openapi-php-client 它包含一些更新的代码,这阻止了原始存储库正常工作
- 卖家属性改进: devbolcom/bolcom-openapi-php-client#13
- 链接到目录的修复: devbolcom/bolcom-openapi-php-client#14
- 语义版本控制
随着时间的推移,这个库将得到改进。可以通过提出问题来提出请求。
关于语义版本控制的一些建议
此库的主要版本代表它所工作的 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(或更高版本)
安装和运行示例
- 通过 Fork、下载 zip 或安装 Composer 获取代码
- 将所有文件(保持目录结构)上传到 Web 服务器
- 编辑示例文件 "examples/Example.php",以添加正确的 AccessKeyID(在 https://developers.bol.com/inloggen/?action=register 请求此密钥)、响应格式(xml/json)和 debug_mode bool(0/1)
- 打开浏览器并调用您的 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