Bonapitit和eBay API之间的差异

请注意,Bonanza绝不会被eBay附属或认可。

当我们设计BONAPITIT时,我们的主要目标是拥抱已经拥有数百个应用程序与eBay的API完全合作的现实。我们不是重新发明轮子,我们选择了,我们可以尽可能地实现我们的API,这使得能够最大限度地减少使eBay应用程序成为富尔萨的申请所需的努力。

作为一个基地,您会注意到大多数人 API. 呼叫 具有与eBay API中存在的调用相同的名称和输入参数。虽然我们走得太远 较少 总体而言比他们所呼叫,我们在检查他们的API时意识到的是,许多电话可以巩固到较少的呼叫中,没有功能损失。我们的努力最终使我们在今天在Bonapitit中看到的汤面的小集合。

但是,如果您翻译eBay应用程序与Bonapitit一起使用的eBay应用程序,请记住一些具体差异的一些具体差异:

可能需要代码修改的差异

  1. 您提交的HTTP标头和URL是不同的。对于非反呼,我们只需要在HTTP标题中传递你的Bonanza dev_id(而不是dev id,cert id和app id,如eBay)。
  2. 所有博纳扎输出都是 json格式化了。我们做出了两种和半种原因。第一个原因是生成JSON数据比XML要快得多,因为它的格式基本相当于现有数据结构 - 哈希 - 这是大多数XML最终被解析为无论如何。第二个原因是,比XML更有说可以是更有说明的(,因此,更容易解析),因为节点没有像XML这样的任意数量的潜在属性。最后半个原因是,此时,所有现代计算机语言都有可用的JSON库,可以轻松地在JSON和哈希之间转换。也就是说,Bonanza API理论上可以将XML视为输入,但您应该记住1)这不是“正式”支持和2)我们的产出仍然是JSON,所以你需要在某处兼容JSON兼容在你的框架里。
  3. Bonanza输出/输入不会在节点中使用嵌入属性。由于前一个项目,我们不做像嵌入SearchResult节点中的项目计数,因为偶尔API偶尔会这样做。 json不可能,因为它与JSON的更简单名称/值设计不一致。
  4. 变量和方法名称一直启动下壳。 eBay的旧版API呼叫始于UpperCasevariaBlenames,而他们的较新的API调用(如findItemsbyKeywords)开始底壳。为了一致性,我们选择了解所有API方法调用的新公约。如果这被证明是开发人员的大麻烦,我们可能允许“兼容模式”,其中我们允许变量名称开始上层或下套。
  5. 错误框架差异。我们的错误代码和类别不同于eBays,因此如果您的代码是预期/响应某些类型的错误,则需要修改它。

其他差异

  • 通常,我们的参数比eBay更少。我们将忽略您发送给我们的任何额外参数,所以这不应该造成任何不兼容,但它可能导致结果并不是您所期望的结果。我们还有一些返回值,即eBay没有,例如Bonanza信息和卖方的实时聊天可用性。
  • 您可能会发现98%的类别ID类似于eBays,但会偶尔差异。我们希望很快就实施方法来检索我们的类别和项目副本信息。