findItemsbycategory.

findItemsbycategory. 检索指定类别中的所有Bonanza手机客户端的列表

响应包含符合搜索条件的手机客户端的详细信息。默认情况下,Bonanza返回对呼叫响应的特定数据集。 findItemsbycategory. 允许您使用手机客户端过滤器来优化搜索结果(ItemFilter. )。 使用 PaginationInpul. 控制从每个请求返回的数据量。结果按清单日期进行排序。使用 排序 指定不同的排序顺序,例如按当前价格或列表结束时间进行排序。

使用手机客户端过滤器控制结果

过滤器通过缩小返回的手机客户端范围来提供对搜索结果的控制。这 ItemFilter. 容器使用名称/值对来描述特定过滤器。您可以为各种属性指定过滤器,包括手机客户端条件,价格范围,列表类型等。所有手机客户端过滤器都是可选的输入参数。

排序输出

使用 排序 元素指定返回的手机客户端的排序顺序。例如,指定值 priceplusshpingasc. 通过手机客户端价格加上运费的综合成本进行排序,首先列出了最低的商品。排序对返回结果的数量没有影响。

排序 欲获得更多信息。

奉献结果

使用 PaginationInpul. 其子元素以控制匹配搜索条件的一组手机客户端在结果集中返回。使用 PaginationInpul. 将返回的手机客户端划分为子集或“页面”的数据:

  • PaginationInput。entriesperpage. 指定任何给定请求返回的最大手机客户端数
  • PaginationInput.PageNumber. 指定要在当前呼叫中返回的数据的“页面”

在回应中, PaginationOutput. 包含用于鸣合数据的相应字段:

  • PaginationOutput.。Totalentries. 表示符合可以返回的输入搜索条件的手机客户端总数(具有一个或多个呼叫)。如果指定的值 PaginationInput。entriesperpage. 少于退回 PaginationOutput.。Totalentries.,然后它需要多个呼叫来检索所有匹配项。
  • PaginationInput.PageNumber. 表示应用程序的多个调用序列中的位置。
  • PaginationOutput.。entriesperpage. 字段表示可以在响应中返回的最大手机客户端数。这 数数 属性为 搜索结果 字段表示响应中返回的实际手机客户端数。的价值 entriesperpage. 除以匹配项的总数确定可以为给定查询返回多少页面。

PaginationInpul.PaginationOutput. 欲获得更多信息。

findItemsbycategory输入

从此请求返回的输出的名称是findItemsbyCategoryResponse。因此,在将序列化响应解析为JSON之后,您可以使用类似的东西访问数据:

my_json_hash['findItemsbycategory.Response']

以下是所有可能的输出参数:

争论 类型 发生 意义
标准输入字段
compouttsid. 整数 必需的 Bonanza类别ID。
get类别
PaginationInpul. 容器 Optional 控制结果集的分页。子元素指定每个呼叫返回的最大手机客户端列表数量和数据页面返回。控制响应中返回的列表数量,但未指定为每个列表返回的详细信息。

笔记: 对于给定的搜索,无论找到多种匹配,都无法检索超过10,000个手机客户端。该限制由允许的最大页码(100)和允许的最大条目强制执行(100)。
paginationInput.entriesperpage. int Optional 指定单个呼叫中返回的最大条目数。如果指定的pageNumber上的条目数小于此处指定的值,则返回的手机客户端数将小于entriessperpage的值。这表示结果集的结尾。

如果entriessperpage设置为大于100的数字,则将使用默认值100。
最大限度: 100. 默认: 100.
paginationInput.Pagenumber. int Optional 指定要在呼叫响应中返回的数据(或“页面”)的子集。数据页数由匹配请求搜索条件(在PaginationOutput.Totalentries中返回的手机客户端的总数决定)除以每个响应中显示的条目数(entriesperpage)。您可以通过发出多个请求并按顺序指定要返回的页面来返回结果集的前100页。
最大限度: 100. 默认: 1.
排序 SortOrderType Optional 根据单个指定的排序顺序对返回的手机客户端进行排序。
默认: BestMatch.

适用价值:
  • 最佳匹配
    (in)通过最佳匹配进行排序,基于社区购买活动和其他基于相关的因素。
  • CurrentPriceHest
    (in)按目前的价格排序,最高价格最高。
  • CurrentPriceloWest.
    (in)按目前的价格排序,价格最低。
  • Starttimenewest.
    (in)按开始时间对手机客户端进行排序,最近列出的(最新)手机客户端首先出现。
呼叫特定的输入字段
ItemFilter. 容器 Optional,
repeatable: [0..*]
根据您指定的过滤器减少响应中返回的手机客户端数。请参阅所有可能的过滤器列表 ItemFilters.
itemFilter. 姓名 ItemFilterType Optional 指定要使用的手机客户端过滤器的名称。 ItemFilter名称必须具有相应的值。您可以在单个请求中应用多个ItemFilter名称/值对。有关允许的值,使用规则和依赖项的更多信息,请参阅ItemFilterType类型文档。

请参阅以下示例以查看ItemFilters:
  使用ItemFilters定义价格范围
  使用Itemfilters搜索使用的购买它现在。
itemFilter. 价值 string Optional,
repeatable: [1..*]
与相应的ItemFilter名称关联的值。
关键词 string Required 指定用于搜索查询的一个或多个单词,用于查找Bonanza上的手机客户端。默认情况下,查询仅搜索手机客户端标题。运行查询时,最好包含完整的关键字值 - Bonanza在彼此中检查上下文中的单词。

findItemsbycategory输出

从此请求返回的输出的名称是findItemsbyCategoryResponse。因此,在将序列化响应解析为JSON之后,您可以使用类似的东西访问数据:

my_json_hash['findItemsbycategory.Response']

以下是所有可能的输出参数:

返回值 类型 发生 意义
标准输出字段
ACK. ACK. value. 总是

指示在处理请求期间是否生成错误或警告。

适用价值:

  • 失败
    (OUT)Bonanza在处理请求期间遇到致命错误,导致请求失败。发生严重的应用程序级别错误时,返回错误而不是业务数据。
  • 成功
    (OUT)Bonanza成功处理了请求,并在响应中返回业务数据。请注意,返回成功的响应是可能的,但仍不包含结果中的预期数据。
  • 警告
    (out)请求已成功处理,但富士色在处理过程中遇到了非致命错误。为获得最佳效果,请求应退回无警告。在重新提交请求之前检查警告详细信息并解决问题。
错误信息 容器 Conditionally 当Bonanza处理请求时发生错误或警告的描述。如果ACK值为成功,则不返回。
errorMessage. 错误 容器 Conditionally,
repeatable: [0..*]
errorMessage.error.类别 ErrorCategory Conditionally Currently unused.
errorMessage.error. 信息 string Conditionally 错误描述
errorMessage.error. 类型 纠刊 Conditionally 错误的唯一描述性名称。
PaginationOutput. 容器 Conditionally 表示结果集的分页。子元素表示返回的页码,每页返回的最大手机客户端列表数,可以返回的总页数以及与搜索条件匹配的列表总数。
paginationOutput
  .entriesperpage.
int Conditionally 在响应中可以返回的最大手机客户端数。此数字始终等于PaginationInput.entriesPage的值输入。

如果为entriesperpage指定的数字大于指定的pageNumber上发现的手机客户端数,则已达到结果集的末尾。在这种情况下,会比entriessPerpage中指定的数字返回的手机客户端较少。这可以通过将entriesspage值与SearchResult字段的Count属性中返回的值进行比较来确定。
paginationOutput.Pagenumber. int Conditionally 在当前响应中返回的手机客户端数据的子集。搜索结果分为套装或手机客户端数据的“页面”。页数等于与搜索条件匹配的手机客户端总数除以要求在请求中为entriberPage指定的值。对请求的响应包含手机客户端数据的一个“页面”。

此返回值表示返回的手机客户端数据(完整结果集的子集)。如果此字段包含1,则响应包含手机客户端数据的第一页(默认值)。如果在rotentries中返回的值小于entriesperpage的值,则pagenumber返回1,响应包含整个结果集。

pagenumber的值通常等于paginationInput.pagenumber的值输入。但是,如果PageNumber的数字输入大于输出总可能的页面,则Bonanza返回结果集中的手机客户端数据的最后一页,并且PageNumber的值设置为相应的(最后)页码。
paginationOutput.税前 int Conditionally 发现的手机客户端总数与您的请求中的搜索条件匹配。根据intriesperpage的输入值,响应可能仅包括整个结果集的一部分(a页)。如果BONANZA没有找到与搜索条件匹配的任何手机客户端,则返回“0”的值。
搜索结果 容器 总是 符合搜索条件的手机客户端列表的容器。如果找到任何匹配项,则在单个容器中返回每个手机客户端的数据。
搜索结果。 物品 容器 总是,
repeatable: [1..*]
用于与搜索条件匹配的单个手机客户端数据的容器。
searchresult.item。 国家 细绳 有条件的 两个字母的ISO 3166国家代码,以指示手机客户端所在的国家/地区。对于对应于每个代码的英文名称(例如,KY =“Cayman Islands”),请参阅ISO网站:
http://www.iso.ch/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html.
searchresult.item。画廊沃尔尔 奥里瑞 有条件的 画廊缩略图图像的URL。必须以以下图形格式之一提供图像:JPEG,BMP,TIF或GIF。只有卖家选择展示画廊图像才会返回。
searchresult.item。 Globalid. 细绳 总是 目前总是返回“Bonanza”。
searchresult.item。 itemid. 细绳 总是 唯一标识手机客户端列表的ID。博纳扎在列出手机客户端时生成此ID。 ID值在所有Bonanza站点上都是唯一的。
最长长度:19.
searchresult.item。listinginfo. 容器 有条件的 没有(只是一个容器)
searchresult.item.listinginfo.
.bestofferenabled.
布尔基 有条件的 显示卖方是否会接受相关手机客户端的最佳报价。最佳优惠允许买方在固定的价格上制作较低价格的装订报价。买家看不到已经进行了多少优惠(只有卖家可以看到此信息)。要在列表中提供最佳报价,请使用Bonanza网站。
searchresult.item.listinginfo.
.买得教育家
金额(双) 有条件的 现在买它的价格
searchresult.item.listinginfo.
.ConvertedBuyitTowPrice.
金额(双) 有条件的 假名为“GUNEITTNOWPRICE”
searchresult.item.listinginfo.
.莱克坎德时期
约会时间 有条件的 此手机客户端以任何方式修改的最后日期。
searchresult.item.listinginfo.
.listintype.
细绳 有条件的 列表的格式,例如在线拍卖,固定价格或广告。 * listinype值: 固定金:固定价格上市。目前唯一的可能性。
searchresult.item.listinginfo.
.开始时间
约会时间 有条件的 正如博纳扎作为那一刻所录制的时间戳是可用的。此值在GMT中返回,ISO 8601日期和时间格式(YYYY-MM-DDTHH:MM:SS.SSZ)。有关时间格式的信息,请参阅“DateTime”类型,以及用于转换为GMT时区的详细信息。请注意,starttime可以与GetSingleItem返回的值不同。
searchresult.item。 地点 细绳 有条件的 手机客户端的物理位置,由卖方指定。这给出了物品将发货(或交付)的一般指示。
searchresult.item.
.付款方法
细绳 有条件的,
repeatable: [0..*]

列出可接受付款的付款类型为此手机客户端付款。可能的值包括:

  • PayPal.
  • 亚马逊
  • 信用卡
searchresult.item。邮政编码 细绳 有条件的 列出的手机客户端所在的邮政编码,仅在卖方指定邮政编码时才会返回。
searchresult.item.
.小型类别
容器 总是 有关列出该手机客户端的第一个(或仅)类别的详细信息。请注意,可以在多个类别中列出手机客户端。
searchresult.item.
.primaryCategory.compouttsid.
细绳 总是 指定的Bonanza站点上的类别的唯一ID。
searchresult.item.
.primaryCategory.分类名称
细绳 总是 显示在Bonanza网站上显示的类别名称。
searchResult.item.斯太福福 容器 Always 有关手机客户端卖家的信息。
searchresult.item.sellerinfo.
  . 可用
boolean Always 如果卖家目前正在聊天以聊聊物品,则为真。
searchresult.item.sellerinfo.
  .反馈
string Always

用户反馈分数的视觉指示符。 exputBackratingStar值:

  • 无:没有显示图形,反馈得分0-9。
  • 黄色:黄色星,反馈分数10-49。
  • 蓝色:蓝星,反馈分数50-99。
  • 绿松石:绿松石星,反馈分数100-499。
  • 紫色:紫色明星,反馈得分500-999。
  • 红色:红星,反馈得分1,000-4,999。
  • 绿色:绿色明星,反馈得分5,000-9,999。
  • Yellowshooting:黄色射击星,反馈得分10,000-24,999。
searchresult.item.sellerinfo.
  .成员夫妻
int Always 卖方的订阅级别:
  • 不是订阅者,只是标准成员
  • 加成员
  • 首映成员
searchresult.item.sellerinfo.
  .积极的背心
double Always 用户正反馈的百分比值(其正面反馈划分为它们的总积极加负反馈除外)。
searchresult.item.sellerinfo.
  .萨克纳姆
string Always 卖家的博纳扎的用户名;一个独特的价值。
searchresult.item.sellerinfo.
  . 使用 rPicture.
anyURI Conditional 如果他们上传了卖方的全尺寸图片的URL。
searchresult.item.
.卖天球
卖天球 有条件的 指定与Bonanza的处理工作流程的手机客户端销售状态。
searchresult.item.
.sellingStatus
.ConvertedCurrentPrice.
金额(双) 有条件的 “clustprice”的假名。
searchresult.item.
.sellingStatus.目前的价格
金额(双) 有条件的 按列出该手机客户端的网站货币提供的手机客户端的当前价格。也就是说,CurrentPrice以原始列表货币返回。
searchresult.item.
.sellingStatus.卖斯特泰特
细绳 有条件的

指定Bonanza处理工作流程中的列表状态。如果是过去的手机客户端的结局,但没有关于买方或高价者的详细信息(并且用户不是匿名),您可以使用SellingState信息来确定BONANZA是否已经完成了处理列表。

出售值:

  • 活跃:上市仍然活着。拍卖最近也可能结束,但是博纳扎尚未完成最终处理(例如,高投标人仍在确定)。
  • 取消:卖方或博纳扎已取消列表。
  • 缺少必填字段:列表需要在填充之前填充的一个或多个字段(必填字段目前标题,类别和价格)
  • 准备出售:拥有所有所需的字段填充,并在下次更新/激活下次展开时出售
  • 保留:卖方已将该手机客户端标记为“保留”;它将留在我们的系统中,无法销售,直到卖家重新激活它
  • 售货:该手机客户端已售出
  • 未知:通常会在物品中被清除,等待删除时
  • 另一个数字:这表示Bonanza上的本机手机客户端状态ID。如果您看到一个数字被报告为手机客户端状态,并且您不确定为什么,请向API@bonanza.com报告它
searchResult.item.shippinginfo. 容器 Conditionally 用于数据的容器有关列表的送货详细信息。
searchresult.Item.ShippingInfo.
  .shippingservicecost.
Amount (double) Conditionally 物品的基本运费。
searchresult.Item.ShippingInfo.
  .opportype.
string Conditionally

用于确定运输成本的运输方式。例如:统一率,计算或自由。卖方在列出该手机客户端时指定可用的送货服务。

forwardype值:

  • 计算:计算出的运输模型:发布的航运成本基于买方所选的送货服务,由买方从卖方提供的不同运输服务中选择。货运成本由Bonanza和运输承运人根据买方的地址计算。卖方建立的任何包装和处理成本都会自动汇入总数。
  • 平面:平价运输型号:卖方建立了运费和任何运输保险的成本,无论买方所选送货服务可能会向卖方收取什么费用。
  • 免费:卖方宣布为买方免费提供免费时使用免费。
  • 光明:卖家没有指定送货类型。
searchresult.Item.ShippingInfo.
  .shiptolocations.
string Conditionally,
repeatable: [0..*]
卖方愿意发货的国际地点或地区。仅返回具有指定股份层的手机客户端。有关送货位置的完整列表,请参阅Shiptolocations。
searchResult.item.stortinfo. 容器 Always 有关列出该手机客户端的Bonanza商店的信息。
searchresult.Item.StoreInfo.
  .stockiscount.
容器 Conditionally 如果商店设置了定价折扣,则存在。
searchresult.Item.StoreInfo.
  .storeDiscount.Pricethreshold.
double Conditionally 美元金额以获得展位折扣。
searchresult.Item.StoreInfo.
  .storeDiscount.折扣
int Conditionally 如果买方达到“PriCethreshold”中规定的价格阈值,则占所有物品的百分比折扣。例如,如果priCethreshold是“100”和贴纸是“10”,那么如果他们的订单总计95美元,买方就不会折扣。但如果他们的订单总计100美元,他们将获得10美元的折扣,只需支付90美元。
searchresult.Item.StoreInfo.
  .storeitemcount.
int Always 此展位目前出售的物品数量。请注意,如果特定手机客户端具有多个数量的数量,则仍然仅计算为StoreItemcount的一个手机客户端。这是商店中的唯一物品的数量。
searchresult.Item.StoreInfo.
  .Storename.
string Conditionally 卖方的博纳扎商店的名称。
searchresult.Item.StoreInfo.
  . Storeurl.
anyURI Conditionally 卖方的Bonanza Store页面的URL。
searchresult.item。 标题 细绳 有条件的 在列表标题中显示的手机客户端名称,或搜索和浏览结果。
searchresult.item。viewItemuRL. 奥里瑞 有条件的 在Bonanza上查看此特定列表的URL。
时间戳 约会时间 总是 该值表示Bonanza处理请求的日期和时间。此值在GMT中返回,ISO 8601日期和时间格式(YYYY- MM-DTHH:MM:SS.SSZ)。有关时间格式的信息,请参阅“DateTime”类型,以及用于转换为GMT时区的详细信息。
版本 细绳 总是 Bonanza用于处理请求的发布版本。如果您使用它们来解决问题,则开发人员技术支持可能会要求您提供版本值。

笔记: 使用中的版本通常是最新的发布版本,如发行说明中的​​指定。请注意,Bonanza在API版本发布到美国网站后,大约一周内将API发布到国际网站。
警告 容器 Conditionally 当Bonanza处理请求时发生的警告说明。
warnings.未识别的_分数 容器 Conditionally,
repeatable: [0..*]
一个无法识别的参数数组。