eBay Commerce Network Publisher API Use Cases – eBay合作伙伴API使用示例及其中文说明

之前发布过 eBay Commerce Network Publisher API REST Option Reference 中文说明,如果还是不会请求eBay的服务器,

eBay Commerce Network Publisher Resource Center中的文档提供了这些API请求参数的使用案例,具体案例可以点此进入网站API Use Cases诸位可以对照着案例来看。

由于该处的条目说明,基本与开头提及的eBay API REST Option Reference页面中的条目说明一致,所以此处不再重复翻译。想要看中文版的,请点击文章开头的链接。

不过,为了方便自己使用URL,此处特意说明一下请求eBay Commerce Network API时的URL格式:

API Use Cases中的第一条内容为例:

http : // sandbox.api.ebaycommercenetwork. com/publisher/3.0/rest/GeneralSearch?apiKey=78b0db8a-0ee1-4939-a2f9-d3cd95ec0fcc&trackingId=7000610&visitorUserAgent&visitorIPAddress&keyword=nikon

其中:

1、http : // sandbox.api.ebaycommercenetwork. com/publisher/3.0/:此处为固定格式链接,每次请求eBay的API服务器均需要此部分,所以我们称之为固定连接(Static URL)。

2、rest:eBay的API服务器提供两种方式返回请求的数据,有REST、JSON格式,REST也就是常见的XML格式文件(Response)。

3、GeneralSearch:此处为API服务器的动作,具体是要展示某个产品的数据,还是搜索,还是请求一棵分类树,都是这里决定。你需要什么动作,可以在API REST Option Reference中查找,当然API Use Cases中查找是最为直观的方式(Ebay Action)。

4、apiKey:这部分及其等号后面下一个&与号之前的内容,为本次请求使用的apiKey,该key由eBay官方颁发,此处我们使用的是官方的演示账号(apiKey)。

5、visitorUserAgent:这部分为访问者的User Agent可以自定义,但需要符合常用的User Agent规范(visitorUserAgent)。

6、visitorIPAddress:这部分为访问者的IP地址,可以自定义,但需要符合IP地址的规范(visitorIPAddress)。

7、trackingId:这部分为本次请求发起人的API账户的trackingId,为了方便eBay知道这是谁发起的请求,结合apiKey进行佣金结算(trackingId)。

8、keyword或者其他字段如categoryId:此处根据上文(3)中的Ebay Action来决定填写内容,必填(keyword或者categoryId或者productId)。

综上所述,我们可以拼接为一个简单的字符串来说明问题:

$requestUrl = C(‘staticUrl’).C(‘response’).“/”.$this->ebayAction.“?”.“apiKey=”.C(‘apiKey’).“&visitorUserAgent”.$this->paramValue(“visitorUserAgent”).“&visitorIPAddress”.$this->paramValue(“visitorIPAddress”).“&trackingId=”.C(‘trackingId’).“&categoryId=”.C(‘categoryId’);

其中,paramValue检测是否有这个值,返回符合eBay API请求规范的URL部分。

OK,这就是eBay Commerce Network Publisher API REST Option Reference 中文说明兄弟篇,eBay Commerce Network Publisher API Use Cases – eBay合作伙伴API的中文说明。

对了做了个Quicl的LOGO,感觉很飘逸q Win自带的画图工具真是好用 :)