README

这是一个 PHP 的 Shopee 合作伙伴 API 客户端。

要求

• PHP >= 7.1
• Composer
• Guzzle

安装

执行以下命令以获取软件包

$ composer require freeflygit/shopee-php

用法

创建 Shopee 客户端实例，然后使用它访问 Shopee 合作伙伴 API。

<?php

use Shopee\Client;

require __DIR__ . '/vendor/autoload.php';

$client = new Client([
    'secret' => getenv('SHOPEE_PARTNER_KEY'),
    'partner_id' => getenv('SHOPEE_PARTNER_ID'),
    'shopid' => getenv('SHOPEE_SHOP_ID'),
]);

示例

获取商品详情

$response = $client->item->getItemDetail(['item_id' => 1978]);

或者，您也可以在请求中使用参数模型。

$parameters = (new \Shopee\Nodes\Item\Parameters\GetItemDetail())
    ->setItemId(1978);
$response = $client->item->getItemDetail($parameters);

Webhook

使用 webhook 接收传入的推送通知

<?php

/**
 * Push Mechanism (WebHook)
 *
 * @see  https://open.shopee.com/documents?module=63&type=2&id=55
 */

use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use Shopee\SignatureGenerator;
use Shopee\SignatureValidator;
use Slim\Factory\AppFactory;

require __DIR__ . '/vendor/autoload.php';

$app = AppFactory::create();
$signatureGenerator = new SignatureGenerator(getenv('PARTNER_KEY'));
$signatureValidator = new SignatureValidator($signatureGenerator);

$app->post('/webhook', function (Request $request, Response $response) use ($signatureValidator) {
    // Verify push content
    if (!$signatureValidator->isValid($request)) {
        error_log('Invalid authorization signature');
        return $response;
    }

    // TODO here to handle your business logic

    // HTTP response must with status code 2xx and empty body
    return $response;
});

$app->run();

许可证

有关许可证权利和限制，请参阅 LICENSE 文件（BSD 3-Clause）。