ebay API 基 础 Susan Zheng
日 程 ebay API 新 手 起 航 ebay API 输 入 输 出 实 例 ebay API 最 佳 实 践 国 际 e 邮 宝 API 集 成
ebay API 新 手 起 航
加 入 ebay API 开 发 者 行 列 步 骤 一 : 免 费 加 入 ebay 开 发 者 行 列 https://developer.ebay.com/join/
加 入 ebay API 开 发 者 行 列 步 骤 二 : 注 册 测 试 环 境 账 号 http://sandbox.ebay.com/
加 入 ebay API 开 发 者 行 列 步 骤 三 : 申 请 Key set 识 别 开 发 者 或 是 应 用 程 序 的 唯 一 标 识 DevID + AppID + CertID 环 境 测 试 (Sandbox) 生 产 (Production) 永 不 过 期
ebay API 支 持 的 协 议 类 型
ebay API 支 持 的 协 议 类 型 Get Name- Value http://svcs.ebay.com/services/search/findingservice/v1?operation- NAME=findItemsByKeywords&SERVICE-VERSION=1.0.0 &SECURITY- APPNAME=YourAppID &RESPONSE-DATA-FORMAT=XML &REST-PAYLOAD &keywords=harry%20potter%20phoenix HTTP Post JSON XML {"jsonns.xsi":"http://www.w3.org/2001/xmlschema-instance", "jsonns.xs":"http://www.w3.org/2001/xmlschema", "jsonns.tns":"http://www.ebay.com/marketplace/search/v1/services", "tns.finditemsbykeywordsrequest":{"keywords":"harry potter phoenix"}} <finditemsbykeywordsrequest xmlns="http://www.ebay.com/marketplace/search/v1/services"> <keywords>harry potter phoenix</keywords> </finditemsbykeywordsrequest> SOAP <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns="http://www.ebay.com/marketplace/search/v1/services"> <soap:header/> <soap:body> <finditemsbykeywordsrequest> <keywords>harry potter phoenix</keywords> </finditemsbykeywordsrequest> </soap:body> </soap:envelope>
ebay API 支 持 的 协 议 类 型 不 需 要 Token 需 要 Token Finding Shopping Product Trading Best Match Large Merchant Name- Value JSON XML SOAP Name- Value JSON XML SOAP Name- Value JSON XML SOAP XML SOAP XML SOAP XML SOAP
根 据 开 发 语 言 下 载 适 合 的 SDK
根 据 开 发 语 言 下 载 适 合 的 SDK ebay 应 用 其 他 开 发 语 言 PHP, Perl.NET 环 境 下 语 言 C#, VB.NET, VB6 Java ebay SDK ebay SDK.Net 版 本 ebay SDK Java 版 本 Web Service 支 撑 工 具 包.NET 框 架 Apache Axis API ebay API (XML/SOAP) ebay 电 子 商 务 平 台
根 据 开 发 语 言 下 载 适 合 的 SDK https://www.x.com/developers/ebay/documentation-tools/sdks SDK 类 型 支 持 的 API 类 型 描 述.NET SDK Trading 使 用 ebay 的.NET SDK 简 化 类 似 于 注 册 出 错 处 理 认 证 等 常 用 项 目 的 开 发 流 程 Java SDK Trading 在 ebay 平 台 上 享 受 面 向 对 象 的 Web 服 务 无 需 解 析 XML 字 符 串 或 是 数 据 结 构
了 解 ebay 授 权 流 程
什 么 是 Token Token 代 表 一 个 ebay 账 号 对 一 个 应 用 程 序 的 授 权 Token 失 效 的 情 况 1. 超 过 18 个 月 有 效 期 自 然 失 效 2. ebay 强 制 Token 过 期 3. 用 户 在 My ebay 中 解 除 授 权 应 用 1 应 用 2 Token1 Token2 Token3 Token4 Token5 ebay 用 户 1 ebay 用 户 2 ebay 用 户 3
获 取 Token 自 己 的 账 号 https://developer.ebay.com/devzone/account/tokens 选 环 境 登 陆 ebay 进 行 授 权 保 存 Token
获 取 Token 自 己 的 账 号 https://developer.ebay.com/devzone/account/tokens 选 环 境 登 陆 ebay 进 行 授 权 保 存 Token
获 取 Token 自 己 的 账 号 https://developer.ebay.com/devzone/account/tokens 选 环 境 登 陆 ebay 进 行 授 权 保 存 Token
获 取 Token 第 三 方 工 具
获 取 Token 第 三 方 工 具 应 用 层 设 置 RUName 设 置 获 取 Token
获 取 Token 第 三 方 工 具 应 用 层 设 置 RUName 设 置 获 取 Token
获 取 Token 第 三 方 工 具 应 用 层 应 用 程 序 设 置 RUName 设 置 1) 调 用 GetSessionID RuName SessionID 2) 根 据 RuName 和 SessionID 构 造 URL URL 重 定 向 SessionID Token 获 取 Token ebay API 服 务 器 ebay 登 陆 页 3) 调 用 FetchToken
错 误 做 法 示 例 ebay 账 号 管 理 账 号 : 添 加 账 号 Token: 账 号 : Token: Paypal 账 号 管 理 账 号 : 添 加 账 号 开 发 者 密 码 :
ebay API 输 入 输 出 实 例
Trading API 示 例 AddFixedPriceItem 请 求 <AddFixedPriceItemRequest xmlns="urn:ebay:apis:eblbasecomponents"> <ErrorLanguage>en_US</ErrorLanguage> <WarningLevel>High</WarningLevel> <Version>773</Version> <Item> <Title>Apple MacBook Pro MB990LL/A 13.3 in. Notebook</Title> <Description>Brand New Apple MacBook Pro MB990LL/A 13.3 in. Notebook!</Description> <PrimaryCategory> <CategoryID>111422</CategoryID> </PrimaryCategory> <StartPrice>500.0</StartPrice>. </Item> <RequesterCredentials> <ebayauthtoken>abc...123</ebayauthtoken> </RequesterCredentials> </AddFixedPriceItemRequest> 通 用 信 息 版 本 错 误 语 言 商 品 信 息 名 称 描 述 分 类 价 格 Token
Trading API 示 例 AddFixedPriceItem 返 回 <AddFixedPriceItemResponse xmlns="urn:ebay:apis:eblbasecomponents"> <Timestamp>2012-05-30T07:03:03.597Z</Timestamp> <Ack>Success</Ack> <Version>773</Version> <Build>E771_CORE_BUNDLED_14807899_R1</Build> <ItemID>110099332159</ItemID> <StartTime>2012-05-30T07:03:03.191Z</StartTime> <EndTime>2012-06-06T07:03:03.191Z</EndTime> <Fees> <Fee> <Name>AuctionLengthFee</Name> <Fee currencyid="usd">0.0</fee> </Fee>. </Fees> </AddFixedPriceItemResponse> 通 用 信 息 版 本 时 间 戳 错 误 返 回 结 果 集 商 品 ID 刊 登 费
ebay API 最 佳 实 践
商 品 刊 登
刊 登 商 品 前 准 备 将 商 品 匹 配 到 合 适 的 ebay 分 类 准 备 多 属 性 列 表 转 换 价 格 将 商 品 属 性 匹 配 到 推 荐 的 ebay 商 品 属 性
刊 登 商 品 前 准 备 运 输 策 略 退 货 策 略 支 付 方 式
刊 登 商 品 前 准 备 HTML 描 述 模 板
商 品 刊 登 管 理 刊 登 商 品 修 改 价 格 / 数 量 AddItem AddFixedPriceItem ReviseInventoryStatus 修 改 内 容 结 束 刊 登 重 新 刊 登 ReviseItem ReviseFixedPriceItem EndItem EndFixedPriceItem RelistItem RelistFixedPriceItem
使 用 HTML 模 板 生 成 商 品 描 述 标 题 价 格,...,...,... A, 4.99,...,...,... B, 10.99,...,...,... 库 存 文 件 / 数 据 库 模 板 合 成 HTML 模 板 具 体 商 品 的 HTML 描 述 Add/Revise FixedPriceItem <html> <body> Item Title: <<Title>> Sale Price: <<Price>> </body> </html> <html> <body> Item Title: A Sale Price: 4.99 </body> </html>
刊 登 策 略 拍 卖 交 叉 销 售 节 日 促 销 新 款 上 架 限 时 折 扣
订 单 同 步
订 单 同 步 时 间 轴 15 分 钟 15 分 钟 15 分 钟 1 小 时 1 小 时 1 天 每 次 取 的 时 间 窗 口 保 证 一 定 时 间 的 重 叠
订 单 同 步 小 贴 士 设 置 DetailLevel 设 定 合 理 时 间 段 设 置 OutputSelector 筛 选 采 用 分 页
API 调 用 次 数
Compatible App Check http://developer.ebay.com/support/developersupport/app_check/ 服 务 默 认 次 数 ( 每 天 ) 已 认 证 应 用 Finding 5000 150 万 Trading 5000 150 万 Best Match 5000 150 万 Product 5000 50 万 Product Metadata 5000 50 万 Shopping 5000 150 万 Merchandising 5000 150 万 Notifications 无 无
错 误 诊 断 及 寻 求 帮 助
错 误 诊 断 网 络 错 误 / 系 统 配 置 错 误 Internal Server Error(HTTP 状 态 500) Proxy Error(HTTP 状 态 502) Cannot find class in classpath 检 查 网 络 连 接 检 查 系 统 配 置
错 误 诊 断 系 统 内 部 错 误 API 错 误 代 码 10007: Internal error to the application 报 告 ebay 隔 段 时 间 重 试
错 误 诊 断 请 求 级 错 误 返 回 结 果 中 的 API 错 误 Error Code 20822: Invalid ItemID or TransactionID Error Code 878: API request version is not supported. Error Code 932: Auth token is hard expired. 查 看 ebay API 错 误 列 表 查 看 保 存 的 request/response xml 日 志 技 术 文 档 /ebay 论 坛 / 邮 件 咨 询
API 最 新 消 息 更 新 您 使 用 的 API 版 本 每 半 年 修 改 一 次 最 低 支 持 版 本,18 个 月 前 的 版 本 将 不 再 支 持 从 2012 年 8 月 开 始,eBay 支 持 的 最 低 版 本 为 707 获 取 API 最 新 更 新 信 息 https://www.x.com/developers/ebay/ebayproduct-updates
从 哪 里 获 得 帮 助 ebay 大 中 华 区 API 开 发 者 平 台 http://www.ebay.cn/developer/ ebay 中 国 开 发 者 论 坛 http://community.ebay.cn/viewforum_400000072. html ebay API 咨 询 信 箱 DL-eBay-CBT-API@ebay.com
国 际 e 邮 宝 API 集 成
使 用 国 际 e 邮 宝 API 发 货 AddAPACShipping Package GetAPACShipping Label GetAPACShipping PackageStatus ConfirmAPAC ShippingPackage
Shipping Tool API 授 权 ( 无 需 Token) 我 是 通 过 认 证 的 第 三 方 开 发 商 Tom 我 是 Peter, 我 相 信 Tom, 他 可 以 通 过 API 操 作 我 的 e 邮 宝 账 户 我 记 住 了, Tom 可 以 操 作 Peter 的 账 号 Hi Shipping Tool, 请 将 Tom 加 入 到 我 的 授 权 列 表 中
如 何 使 用 API 凭 证 在 使 用 国 际 e 邮 宝 API 时, 在 您 发 送 的 请 求 中 填 入 以 下 内 容 : <Version>3.0.0</Version> <APIDevUserID>[API 开 发 者 ID]</APIDevUserID> <APIPassword>[API 签 名 ]</APIPassword> <APISellerUserID>[ 您 需 要 操 作 的 ebay 账 号 ]</APISellerUserID> 用 户 授 权 后, 可 以 使 用 VerifyAPACShippingUser 来 验 证 授 权 是 否 成 功 <APIDevUserID> <APIPassword> 这 是 对 应 该 API 开 发 者 ID 的 ebay 账 号, 操 作 此 账 号 时 无 需 授 权 操 作
国 际 e 邮 宝 API V3 上 线 时 间 及 测 试 链 接 国 际 e 邮 宝 API V3 已 上 线, 测 试 用 API URL 地 址 为 : http://epacketws.pushauction.net/v3/orderservice.asmx 配 合 ebay 退 货 功 能, 增 加 退 货 地 址 国 际 e 邮 宝 API V2 版 本 停 用 时 间 : 计 划 2012 年 8 月 31 日
谢 谢!