Bonapitit开始（快速！）

此页面将简要介绍创建将为所有金枪鱼搜索Bonanza的程序的过程。

如果您有现有的eBay应用程序，您希望查看我们入门的步骤，您可能还想查看我们的从eBay页面迁移.

你需要什么

要完成本教程，您需要以下内容：

可以发布到HTTP地址的编程语言
可以编写和解析的库（或语言）手机客户端格式化数据.

第一步：设置一个帐户

申请Bonanza API帐户，访问 //api.bonanza.com 并单击“链接”以应用。一旦您的申请批准（通常在1-2个工作日内），您将通过电子邮件发送信息来登录您的帐户。

第二步：打电话给金枪鱼

现在，您需要将请求发布到您想要了解Bonanza的Tuna的选择。每件事 API. 调用文档，这将是一个哈希，如下所示：

{ "keywords" => "tuna" }

把这个哈希变成json 并将其发布到我们的API地址，“//api.sanyili.com/api_requests/standard_request“。ruby语法完成这看起来像：

# Turn hash input into 手机客户端, store it in variable called "my_input"
my_input = { "keywords" => "tuna" }.to_json

曾经翻译成手机客户端，my_input将相等：

"{\"keywords\":\"tuna\"}"

所以现在让我们将此发布给Bonanza：

require "net/http"
require "json"

# Open connection to api.bonanza.com
@http = Net::HTTP.new("api.bonanza.com", 443);
@http.use_ssl = true

# Post the request to our API, with the "findItemsByKeywords" name and our 手机客户端 from above as the value
response = @http.post("/api_requests/standard_request", "findItemsbyKeywords.=#{my_input}");
puts "response code is #{ response.code }"
puts "response body is #{ response.body }"

现在这个金枪鱼靠近你可能闻它。只需一个详细信息......您需要在HTTP标头中给我们API帐户名称。在Ruby中，这只是意味着将一个参数添加到后呼叫：

response = @http.post("/api_requests/standard_request", "findItemsbyKeywords.=#{my_input}", {'X-BONANZLE-API-DEV-NAME' => 'my_bonapitit_account_name'});

此调用将以手机客户端格式从Bonanza返回金枪鱼的页面（默认为20项）。

第三步：解析骑士，雪莉！

在进行调用后，您现在可以为您的解析乐趣提供手机客户端兼容的哈希。解析这将取决于您的首选语言。 Googling“手机客户端 [我的语言]应该在正确的道路上设置你（开发人员，随意推荐你最喜欢的手机客户端解析器在讨论到这个页面的语言）。

如果您使用的是Ruby，那么我发现的最简单的库就是“破解”库（GEM安装裂缝）。使用它，您可以将响应转换为散列，如下所示：

my_hash = Crack::手机客户端.parse(data);

然后，要在结果集中获取第一个项目：

yummy_tuna = my_hash["findItemsbyKeywords.Response"]["item"].first

你有金枪鱼。

跟进

想要看到一个更复杂的搜索？