README

使用浏览API，您可以通过关键词和分类搜索创建丰富多样的商品供买家浏览。

API版本：v1.18.4

要求

PHP 8.1及以上版本
启用ext-json和ext-curl扩展

安装与使用

使用composer安装此包

composer require sapientpro/ebay-browse-sdk-php

入门指南

请按照安装步骤进行操作，然后运行以下命令

<?php
use SapientPro\EbayBrowseSDK\Configuration;
use SapientPro\EbayBrowseSDK\Api\ItemApi;
use SapientPro\EbayBrowseSDK\Models\CompatibilityPayload;

// Configure OAuth2 access token for authorization: api_auth
$config = Configuration::getDefaultConfiguration()->setAccessToken('YOUR_ACCESS_TOKEN');

$apiInstance = new ItemApi(
config: $config
);
// you can create and fill a Model class that implements EbayModelInterface using fromArray() method
// exception will be thrown if a property does not exist in the model class
$body = CompatibilityPayload::fromArray([]);

try {
$result = $apiInstance->checkCompatibility($body);
print_r($result);
} catch (Exception $e) {
echo 'Exception when calling InventoryItemApi->bulkCreateOrReplaceInventoryItem: ', $e->getMessage(), PHP_EOL;
}

创建模型

某些SDK方法需要$body变量作为参数。它指的是实现EbayModelInterface的模型类。创建模型类有几种方法

fromArray()

您可以使用fromArray()方法创建模型类。如果模型类中不存在该属性，它将抛出异常。

如果模型具有实现EbayModelInterface类型的属性，您必须使用fromArray()方法创建该类的实例。在这个例子中，属性price的类型是ConvertedAmount，它也实现了EbayModelInterface。

Item::fromArray([
    'price' => ConvertedAmount::fromArray([
        'value' => '6.90',
        'currency' => CurrencyCodeEnum::USD
    )]
])

fromPlainArray()

也可以从普通的关联数组创建模型。上一个例子可以重写如下

Item::fromPlainArray([
    'price' => [
        'value' => '6.90',
        'currency' => CurrencyCodeEnum::USD
    ]
])

fromJson()

也可以从JSON字符串创建模型。

Item::fromJson('{"price": {"value": "6.90", "currency": "USD"}}')

API端点文档

所有URI相对于https://api.ebay.com/buy/browse/v1

模型文档

授权

api_auth

类型: OAuth
流程: clientCredentials
令牌URL: https://api.ebay.com/identity/v1/oauth2/token
作用域:
https://api.ebay.com/oauth/api_scope/buy.item.bulk: 批量检索eBay商品。
https://api.ebay.com/oauth/api_scope: 查看eBay的公共数据

sapientpro / ebay-browse-sdk-php

维护者

详细信息