如何高效集成BigCommerceAPI？使用bigcommerce/api客户端简化电商平台开发

<pre class="brush:php;toolbar:false;">composer require bigcommerce/api
composer update

<pre class="brush:php;toolbar:false;">use Bigcommerce\Api\Client as Bigcommerce;

// 对于新安装的单点应用，你可以通过getAuthToken获取access_token
// 假设你已经通过OAuth流程获得了code、context等参数
/*
$object = new \stdClass();
$object->client_id = 'YOUR_CLIENT_ID';
$object->client_secret = 'YOUR_CLIENT_SECRET';
$object->redirect_uri = 'https://app.com/redirect';
$object->code = $request->get('code'); // 从请求中获取
$object->context = $request->get('context'); // 从请求中获取
$object->scope = $request->get('scope'); // 从请求中获取

$authTokenResponse = Bigcommerce::getAuthToken($object);
$accessToken = $authTokenResponse->access_token;
$storeHash = str_replace('stores/', '', $authTokenResponse->context); // 从context中提取store_hash
*/

// 如果你已经有了auth_token和store_hash，直接配置即可
Bigcommerce::configure([
    'client_id'  => 'YOUR_CLIENT_ID', // 你的BigCommerce应用客户端ID
    'auth_token' => 'YOUR_AUTH_TOKEN', // 从OAuth流程获取的访问令牌
    'store_hash' => 'YOUR_STORE_HASH'  // 你的商店哈希值
]);

// 测试连接是否成功
$ping = Bigcommerce::getStoreTime();
if ($ping) {
    echo "成功连接到BigCommerce商店，当前时间: " . $ping->format('H:i:s') . "\n";
} else {
    echo "连接失败！\n";
    $error = Bigcommerce::getLastError();
    echo "错误信息: " . $error->message . "\n";
}

<pre class="brush:php;toolbar:false;">// 获取所有商品
$products = Bigcommerce::getProducts();
foreach ($products as $product) {
    echo "商品ID: {$product->id}, 名称: {$product->name}, 价格: {$product->price}\n";
}

// 获取特定页码的商品，并进行过滤
$filter = ['page' => 2, 'limit' => 10, 'is_featured' => true];
$featuredProducts = Bigcommerce::getProducts($filter);
echo "第二页的特色商品：\n";
foreach ($featuredProducts as $product) {
    echo "  - {$product->name}\n";
}

<pre class="brush:php;toolbar:false;">// 获取ID为11的商品，并更新其名称和价格
$productToUpdate = Bigcommerce::getProduct(11);
if ($productToUpdate) {
    $productToUpdate->name = '全新 MacBook Air 2024';
    $productToUpdate->price = 1299.99;
    $productToUpdate->update();
    echo "商品ID 11 已更新。\n";
}

// 也可以直接通过ID和字段数组更新
$fields = [
    'name'  => 'MacBook Pro 2024',
    'price' => 1999.99
];
Bigcommerce::updateProduct(12, $fields);
echo "商品ID 12 已更新。\n";

<pre class="brush:php;toolbar:false;">$newBrandFields = [
    'name' => 'Innovative Tech Co.'
];
$newBrand = Bigcommerce::createBrand($newBrandFields);
if ($newBrand) {
    echo "新品牌 '{$newBrand->name}' (ID: {$newBrand->id}) 已创建。\n";
}

<pre class="brush:php;toolbar:false;">// 假设要删除ID为22的分类
Bigcommerce::deleteCategory(22);
echo "分类ID 22 已删除。\n";

<pre class="brush:php;toolbar:false;">Bigcommerce::failOnError(); // 配置为在出错时抛出异常

try {
    // 尝试获取一个不存在的商品，这会触发一个错误
    $nonExistentProduct = Bigcommerce::getProduct(99999);
    echo "获取到不存在的商品: " . $nonExistentProduct->name . "\n"; // 这行不会执行
} catch (Bigcommerce\Api\Error $error) {
    echo "捕获到API错误！\n";
    echo "错误代码: " . $error->getCode() . "\n";
    echo "错误消息: " . $error->getMessage() . "\n";
}