README

这是一个 Best Buy 开发者 API 的高级别 PHP 客户端。

入门指南

1. 在 https://developer.bestbuy.com/ 注册开发者 API 密钥
2. 安装包

   • 使用命令行
     composer require bestbuy/bestbuy

   • 使用 composer.json
     在您的 composer.json 文件的 require 部分添加 "bestbuy/bestbuy": "^1.0"

     "require": {
       "bestbuy/bestbuy": "^1.0"
     }

3. 使用包。有几种方式可以将密钥提供给 Client
   • 设置环境变量 BBY_API_KEY 为您的密钥并调用方法
     $bby = new \BestBuy\Client();
   • 在调用方法时作为字符串发送密钥
     $bby = new \BestBuy\Client('YOURKEY');
   • 在调用方法时作为对象的一部分发送密钥
     $bby = new \BestBuy\Client(['key' => 'YOURKEY']);

文档

• 门店可用性
• 产品类别
• 开箱产品
• 产品信息
• 产品推荐
• 产品评论
• 门店
• 版本

门店可用性

$bby->availability(int|int[]|string $skus, int|int[]|string $stores, [array $responseConfig = []]);

1. 单个 SKU/门店编号
   $bby->availability(6354884, 611);
2. SKU/门店编号的数组
   $bby->availability([6354884, 69944141], [611, 281]);
3. 有效的 SKU/门店查询
   $bby->availability('name=Star*', 'area(55347, 25)');

产品类别

$bby->categories(string $search = '', [array $responseConfig = []]);

1. 所有类别
   $bby->categories();
2. 单个类别
   $bby->categories('cat00000');
3. 类别查询
   $bby->categories('name=Home*');

开箱产品

$bby->openBox(int|int[]|string $search = '', [array $responseConfig = []]);

1. 所有开箱产品
   $bby->openBox();
2. 单个产品
   $bby->openBox(6354884);
3. 产品的数组
   $bby->openBox([6354884, 69944141]);
4. 查询
   $bby->openBox('category.id=cat00000');

产品信息

$bby->products(int|string $search = '', [array $responseConfig = []]);

1. 所有产品
   $bby->products();
2. 单个产品
   $bby->products(6354884);
3. 产品查询
   $bby->products('name=Star*');

产品推荐

$bby->recommendations(string $type, int|string $categoryIdOrSku = null, [array $responseConfig = []]);

1. 趋势或最常查看的产品
   $bby->recommendations(\BestBuy\Client::RECOMMENDATIONS_TRENDING);
$bby->recommendations(\BestBuy\Client::RECOMMENDATIONS_TRENDING, 'cat00000');
   
2. 类似或也查看的产品
   $bby->recommendations(\BestBuy\Client::RECOMMENDATIONS_SIMILAR, 6354884);

产品评论

$bby->reviews(int|string $search = '', [array $responseConfig = []]);

1. 所有评论
   $bby->reviews();
2. 单个评论
   $bby->reviews(69944141);
3. 评论查询
   $bby->reviews('comment=purchase*');

门店

$bby->stores(int|string $search = '', [array $responseConfig = []]);

1. 所有门店
   $bby->stores();
2. 单个门店
   $bby->stores(611);
3. 门店查询
   $bby->stores('name=eden*');

版本

$bby->version();