eBay大中华区API开发者平台 开发者专区

搜 索
OAuth快速入门指导
发布时间:2017-04-21          最近刷新时间:

Buy & Sell APIs采用的是Oauth token机制, 与Trading API的token不通用。 使用Buy & Sell API, 需要获取用户的Oauth token。下面详细列出了如何获取用户访问级别的Oauth token (Getting an user access token) 步骤。


首先,你需要知道一些必要的参数:

*client_id         -    App ID (Client ID)
*clientSecret    -    Cert ID (Client Secret)
*redirectUri      -    OAuth Enabled RuName for the clientId

*redirectUrl      -    Auth Accepted URL associated with the redirectUri


以上均可通过开发者账户设置查看:



获取用户OAuth token步骤:

***: 获取用户允许并获取授权代码给应用


https://signin.sandbox.ebay.com/authorize?client_id=<your_client_id>

&redirect_uri=<your_redirect_uri>

&response_type=code

&scope=<URL-encoded-scope-name(s)>



<URL-decoded-auth-code>: 放入URL请求中的scope需要编码处理;多个scope之间以空格隔开。Sell API scope 清单:


https://api.ebay.com/oauth/api_scope
https://api.ebay.com/oauth/api_scope/buy.order.readonly
https://api.ebay.com/oauth/api_scope/buy.guest.order
https://api.ebay.com/oauth/api_scope/sell.marketing.readonly
https://api.ebay.com/oauth/api_scope/sell.marketing
https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
https://api.ebay.com/oauth/api_scope/sell.inventory
https://api.ebay.com/oauth/api_scope/sell.account.readonly
https://api.ebay.com/oauth/api_scope/sell.account
https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly
https://api.ebay.com/oauth/api_scope/sell.fulfillment
https://api.ebay.com/oauth/api_scope/sell.analytics.readonly


授权代码的生命周期只有5分钟,5分钟以后需重新获取用户授权。

第二步: 用授权代码交换用户token (User Token)和更新token (refresh_token)

POST /identity/v1/oauth2/token HTTP/1.1
Host: api.sandbox.ebay.com
Authorization: Basic <B64-encoded-oauth-credentials>
Content-Type: application/x-www-form-urlencoded
grant_type=authorization_code&code=<URL-decoded-auth-code>&redirect_uri=<your_redirect_uri>


<URL-decoded-auth-code>: ******获取到的授权代码。
比如说,你可以使用网站 http://meyerweb.com/eric/tools/dencoder/ ***。一个URL-decoded-auth-code示例:  v^1.1#i^1#r^1#p^3#I^3#f^0#t^Ul4xXzE0QzJGQ0I2RDA2NENDMUY4MDkwRjQ3NDE3MzdENzU2XzJfMSNFXjEyODQ=

<B64-encoded-oauth-credentials>: 格式是  <your_client_id>:<your_client_secret>  ,需64位编码。
比如说,你可以使用网站 https://www.base64encode.org/ 进行编码。

一个成功的回复包括  access_token, expires_in,refresh_token and refresh_token_expires_in 

{
 "access_token": "v^1.1#i^1#r^0#I^3#p^3#...AAAOVXe2xTVRhf121kjo0YUGDxUS5v5LbnPnrbe0Mr3YO0uE",
"token_type": "User Access Token",
"expires_in": 7200,
"refresh_token": "v^1.1#i^1#p^3#f^0#I^3#r^1#t^Ul4yX0Y0OUY1RjRENTU2NDZENTBFQ0E4ODg3MzE2Q0RFQj
M2XzdfMSNFXjI2MA==",
   "refresh_token_expires_in": 47304000


其中access_token是用来执行API 调用的token,时效非常有限。 refresh_token是用来重新获取用户token的更新token,需保存管理。

第三步:当access_token过期之后,使用第二步中获取的 refresh_token来生成一个新的token

HTTP headers:
   Content-Type = application/x-www-form-urlencoded
   Authorization = Basic <B64-encoded-oauth-credentials>
 Request body:
   grant_type=refresh_token&refresh_token=<refresh_token value obtained in the step 2>&scope=<URL-encoded-scope-name(s)>

请注意,这里的 scope需与***使用的scope一致。

POST /identity/v1/oauth2/token HTTP/1.1
Host: api.sandbox.ebay.com
Authorization: Basic <B64-encoded-oauth-credentials>
Content-Type: application/x-www-form-urlencoded
grant_type=refresh_token
&refresh_token=v^1.1#i^1#p^3#f^0#I^3#r^1#t^Ul4yX0Y0OUY1RjRENTU2NDZENTBFQ0E4ODg3MzE2Q0RFQj
M2XzdfMSNFXjI2MA==
&scope=https%3A%2F%2Fapi.ebay.com%2Foauth%2Fscope%2Fsell%40user 

一个成功的回复类似:
{
    "access_token": "v^1.1#i ... AjRV4yNjA=",
    "token_type":"User Access Token",
    "expires_in": 7200,
    "refresh_token": "N/A"
}

有问题请联系我们: DL-eBay-CBT-API@ebay.com。


成为eBay开发者

  • 大的电子商务技术平台
  • 丰富的编程接口和工具
  • 支持你所熟悉的开发语言
立即注册