getsingleitem.

getsingleitem. 在Bonanza上获取有关一个上市的公开可见细节。这为您提供了Bonanza在View Item Page上向普通公众显示的大多数数据(标题,描述,基本价格信息和其他详细信息)。

您只需要知道Bonanza项目ID(值为123456789012),以便检索列表。

笔记 :如果您需要查看通常只能对卖方可见的项目数据(波兰琴会要求他们登录)的项目数据怎么办?为此,您需要使用此调用的经过身份验证版本(getunlisteditem) 反而。

getsingleItem输入

GetSingLeItemis具有以下URL和HTTP标头要求的非安全请求:

提交给URL: //api.sanyili.com/api_requests/standard_request
HTTP标题中需要: x-bonanzle-api-dev-name设置为dev_id

您请求的名称应该是 getsingleitemrequest..

因此,例如,这里是Ruby代码提交您的请求:

require "json"
require "net/http"

# Open connection to api.bonanza.com over port 443
http = Net::HTTP.new("api.bonanza.com", 443)
http.use_ssl = true
http.post(
  "/api_requests/standard_request", # The path we're posting to
  "getsingleitemrequest.=your_serialized_JSON_data", # The data being posted
  { 'X-BONANZLE-API-DEV-NAME' => 'abcdef123456' } # The HTTP header, which gives your dev_id
)

以下是可用的输入参数 序列化为json.:

争论 类型 发生 意义
呼叫特定的输入字段
itemid. 细绳 必需的 唯一标识要检索数据的项目的项目ID。

您可以通过调用FindItems或来自Bonanza网站来确定项目的ID。
最长长度: 19(注意:Bonanza数据库指定38.目前,项目ID通常为9到12位数)。

getsingleItem输出

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

my_json_hash['getsingleitem.Response']

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

争论 类型 发生 意义
标准输出字段
错误信息 容器 Conditionally 当Bonanza处理请求时发生错误或警告的描述。如果ACK值为成功,则不返回。
errorMessage. 错误 容器 Conditionally,
repeatable: [0..*]
errorMessage.error.类别 ErrorCategory Conditionally Currently unused.
errorMessage.error. 信息 string Conditionally 错误描述
errorMessage.error. 类型 纠刊 Conditionally 错误的唯一描述性名称。
时间戳 约会时间 总是 该值表示Bonanza处理请求的日期和时间。此值的时区为GMT,格式为ISO 8601日期和时间格式(YYYY-MM-DDTHH:MM:SS.SSZ)。有关此时间格式和转换为GMT时区的信息,请参阅“DateTime”类型。
警告 容器 Conditionally 当Bonanza处理请求时发生的警告说明。
warnings.未识别的_分数 容器 Conditionally,
repeatable: [0..*]
一个无法识别的参数数组。
呼叫特定的输出字段
物品 容器 总是 容器有关更多详细项目信息。
物品。 bestofferenabled. 布尔基 总是 卖方是否会接受此项目的最佳报价。此功能使买方能够在固定的价格项目上进行较低价格的绑定报价。买家看不到已经进行了多少优惠(只有卖家可以看到此信息)。要在列表中提供最佳报价,请使用Bonanza网站。
物品。 买得教育家 QuantyType(双) 有条件的 CurrentPrice的假名。
物品。 ConvertedBuyitTowPrice. QuantyType(双) 有条件的 CurrentPrice的假名。
物品。 ConvertedCurrentPrice. QuantyType(双) 总是 CurrentPrice的假名。
物品。 国家 国家 codetype. 总是 两个字母的ISO 3166国家代码,以指示项目所在的国家/地区。
物品。 目前的价格 QuantyType(双) 总是 上市的当前价格为美元。
物品。 描述 细绳 总是 卖方的描述,如果有的话。这可以包括HTML标记。
最长长度:60000.
物品。 eBayid 选修的 此项目的独特eBay ID。
物品。 画廊沃尔尔 奥里瑞 有条件的 图片的URL用作画廊缩略图,如果有的话。该图像使用以下图形格式之一:JPEG,BMP,TIF或GIF。只有卖家选择展示画廊形象才会返回。
物品。 itemid. 细绳 总是 唯一标识项目列表的ID。博纳扎在列出项目时生成此ID。此ID在所有Bonanza网站上都是唯一的。
物品。 物品详情 容器 有条件的 卖家添加以描述列表的特定于类别的字段。这些字段的名称对于不同类别的项目不同,因此它们以通用名称/值结构返回。字段名称通常在类别中非常熟知。

例如,一本书的项目细节可能包括出版物年份= 2007(其中发布年份以名称返回),并且2007年返回值),以及格式= sollcover等字段。但是一辆汽车的项目细节与书籍不同,与make = toyota和model = prius的字段。并且票证的项目细节与书籍和汽车不同,eventType =音乐会和场地= FillMore等字段。

项目细节最常见的用途之一是项目条件。

只有卖家在列表中包含项目细节,才会返回。
物品。 itemspecifics.
  . 姓名 valuelist.
容器 有条件的,
repeatable: [0..*]
此列表是项目细节数组,这是卖家添加以描述列表的特定于类别的字段。这些字段的名称对于不同类别的项目不同,因此它们以通用名称/值结构返回。

例如,汽车的项目细节可能包括像make = toyota(以名称返回的位置,并且在值中返回的位置)和型号= prius(以名称返回的型号,并且普形返回值) 。

在多变体列表中,相同的名称不能出现在VariationsPecifics节点和ItemsPecifics节点中。
 
物品。 itemspecifics.
  .nameValueList. 姓名
细绳 有条件的 特定项目的名称。

如果卖家在列表中包含项目特定名称,则此字段仅在响应中返回。但是,如果卖家还没有包含特定项目的相应值,最好不要将名称显示为名称以避免令人困惑的用户。
物品。 itemspecifics.
  .nameValueList. 价值
细绳 有条件的,
repeatable: [0..*]
特定项目的值。

如果卖家包含特定于项目的值,则此字段仅返回响应。在getSingleItem响应中,始终返回此字段,为返回的每个特定项目(如果有)。但是,如果卖家没有为特定项目选择值,则此字段可能会返回空,或者它可能会返回“ - ”,“未选择”或“未指定”(或者语言)等值。网站)。
物品。 listingstatus. 细绳 总是

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

出售值:

  • 活跃:上市仍然活着。拍卖最近也可能结束,但是博纳扎尚未完成最终处理(例如,高投标人仍在确定)。
  • 取消:卖方或博纳扎已取消列表。
  • 缺少必填字段:列表需要在填充之前填充的一个或多个字段(必填字段目前标题,类别和价格)
  • 准备出售:拥有所有所需的字段填充,并在下次更新/激活下次展开时出售
  • 保留:卖方已将该项目标记为“保留”;它将留在我们的系统中,无法销售,直到卖家重新激活它
  • 售货:该项目已售出
  • 未知:通常会在物品中被清除,等待删除时
  • 另一个数字:这表示Bonanza上的本机项目状态ID。如果您看到一个数字被报告为项目状态,并且您不确定为什么,请向API@bonanza.com报告它
物品。 地点 细绳 总是 项目的物理位置,由卖方指定。 (这给出了物品将发货或交付的地方的一般指示。)
物品。 支付方式 细绳 有条件的,
repeatable: [0..*]

列出可接受付款的付款类型为此项目付款。可能的值包括:

  • PayPal.
  • 亚马逊
  • 信用卡
物品。 pictureurl. 奥里瑞 有条件的,
repeatable: [0..24]
包含与项目关联的图像的URL,如果有的话。只有卖家在列表中包含至少一张照片时才会返回。请注意,此元素不会返回通过HTML IMG标记中包含的卖方中包含的卖方的URL。
物品。 viewItemuRL. 奥里瑞 总是 项目的规范列表URL。
物品。 邮政编码 细绳 总是 邮政编码指示项目的物理位置,由卖方指定。 (这给出了物品将发货或交付的地方的一般指示。)
物品。 小型类别 容器 总是
Item.PrimaryCategory。compouttsid. 整数 总是 列出项目的第一个(或仅)类别的数字ID。 (列表可以出现在多个类别中。)
Item.PrimaryCategory。分类名称 细绳 总是 显示列出该项目的第一个(或仅)类别的名称。这是一个完全合格的类别面包屑(例如,计算机和网络:笔记本电脑,笔记本电脑)。
Item.PrimaryCategory。类别层次结构 大批 总是 向下父类别的类别ID数组。
物品。 数量 总是 卖方目前可供出售的物品数量。
物品。 退货政策 容器 选修的 持有有关此项目的退货策略的详细信息。
物品。 returnpolicy。
描述
细绳 选修的 卖方退货政策的详情。
物品。 returnpolicy。
接受退货
细绳 选修的 卖方是否会接受此项目的退货。可能的选择:
  • 接受退货
  • returnsnotaccepted.
物品。 returnpolicy。
rethentswithin.
整数 选修的 买方可以在他们收到物品的那天返回这段时间内的物品。
物品。 returnpolicy。
ChapersingCostpaidby.
细绳 选修的 如果卖方将支付返回运费或“买方”,则价值应为“卖方”。
item. 卖方 容器 Always 容器有关此列表的卖家的信息。
item.seller.反馈 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。
item.seller.反馈评分 int Always 用户的聚合反馈得分。用户的反馈分数是净正反馈减去用户留下的净负反馈。
item.seller.积极的背心 float Always 卖方的积极反馈得分。通过将卖方的积极反馈得分除以其负面反馈得分来计算卖方积极反馈的百分比值。对此计算考虑到最后12个月的反馈评分。
item.seller. 用户身份 string Always 用户唯一的Bonanza用户ID。
物品。 ShippingCostsummary. 容器 总是 用于运输信息的集装箱。
Item.ShippingCostsummary.
  . 载体
String 有条件的 运输载体,如果运输类型是“计算”。可能的值包括“USPS”,“UPS”和“FedEx”。
Item.ShippingCostsummary.
  .保险公司
AmountType (double) 有条件的 保险费用。对于统一费率运输,这是卖方设定的价值,如果有的话。
Item.ShippingCostsummary.
  .保险型
String 有条件的 航运保险类型。适用的值:无,可选,需要。
Item.ShippingCostsummary.
  .包装
String 有条件的 如果“计算出货类型,则为包指定的大小的文本描述。
Item.ShippingCostsummary.
  .shippingservicecost.
AmountType (double) 有条件的 物品的基本运费。
Item.ShippingCostsummary.
  .opportype.
shippingtypecodetype. 总是

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

forwardype值:

  • 计算:计算出的运输模型:发布的航运成本基于买方所选的送货服务,由买方从卖方提供的不同运输服务中选择。货运成本由Bonanza和运输承运人根据买方的地址计算。卖方建立的任何包装和处理成本都会自动汇入总数。
  • 平面:平价运输型号:卖方建立了运费和任何运输保险的成本,无论买方所选送货服务可能会向卖方收取什么费用。
  • 免费:卖方宣布为买方免费提供免费时使用免费。
  • 光明:卖家没有指定送货类型。
Item.ShippingCostsummary.
  .shippingle.
Integer 有条件的 为包指定的磅数。只有在“计算出货”时才会返回。
Item.ShippingCostsummary.
  .ShippingOz.
Integer 有条件的 包装的盎司数量超过其磅(即,如果包装为5磅,2盎司,这将返回“2”)。只有在“计算出货”时才会返回。
Item.ShippingCostsummary.
  .shippingservices.
容器 有条件地,1 .. * 有关运输服务的详细信息
Item.ShippingCostsummary.
  .shippingServices
  . 姓名
细绳 总是 航运服务名称(例如,“USPS优先”)
Item.ShippingCostsummary.
  .shippingServices
  . 载体
细绳 总是 航运服务载体的名称(例如,“USPS”)
Item.ShippingCostsummary.
  .shippingServices
  .shippingservicecost.
QuantyType(双) 有条件的 该航运服务的成本,如果是统一的速度。如果没有,缺席
物品。 shiptolocations. 容器 总是,
可重复: [1..*]
卖方愿意发货的国际地点。仅返回具有指定股份层的项目。
Item.Shiptolocations.
  . 地区
string 有条件的

该数据的区域。 适用价值:
  • 美洲(北,南,或拉丁美洲)
  • 亚洲
  • 欧洲
  • 北美
  • 南美洲
  • 全世界
Item.Shiptolocations.
  .shippingservicecost.
AmountType (double) 有条件的 该项目的基本运输成本指定的区域。
Item.Shiptolocations.
  .opportype.
shippingtypecodetype. 总是

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

forwardype值:

  • 计算:计算出的运输模型:发布的航运成本基于买方所选的送货服务,由买方从卖方提供的不同运输服务中选择。货运成本由Bonanza和运输承运人根据买方的地址计算。卖方建立的任何包装和处理成本都会自动汇入总数。
  • 平面:平价运输型号:卖方建立了运费和任何运输保险的成本,无论买方所选送货服务可能会向卖方收取什么费用。
  • 免费:卖方宣布为买方免费提供免费时使用免费。
  • 光明:卖家没有指定送货类型。
物品。 开始时间 约会时间 总是 Time Stump(GMT)博纳扎作为上市所提供的时刻记录。搜索呼叫返回的开始时间可能因GetSingleItem返回的值而异。
物品。 斯科 细绳 选修的 商品的SKU,用于库存跟踪目的。
物品。 标题 细绳 总是 列表中显示的项目名称或搜索和浏览结果。
物品 。变化 容器 选修的 有关此项目的潜在变化的详细信息。在单个固定价格列表中,变化是多种相似(但不是相同的)项目。例如,T恤上市可能包含多个品牌的相同品牌,这些品牌因颜色和大小而异(如“蓝色,大”和“黑色,中等”)。每个变体指定其中一种颜色和大小的组合。每个变化可以具有不同的数量。您可以同时从一个变体购买多个项目。 (即,一个订单行项目可以包含来自单个变体的多个项目。)
Item.Variations。变化 逐项,可选地[0 .. *] 有条件的 有关一个或多个项目变体的详细信息
Item.Variations。
variation.
价格
整数 有条件的 这个特定项目变异的数量
Item.Variations。
variation.
数量
整数 有条件的 这个特定项目变异的数量
Item.Variations。
variation.
姓名 valuelist.
名称valuelist容器,可选择[0 .. *] 有条件的 项目变体的一个或多个名称/值对的容器
Item.Variations。
variation.
nameValueList.
姓名
细绳 有条件的 被指定的属性的名称,即“size”。从getCategorytraits收集。
Item.Variations。
variation.
斯科
细绳 选修的 SKU特定于这种变化。一个项目可能有一个SKU,涵盖每个变体的所有变化或不同的SKU。
Item.Variations。
variation.
nameValueList.
斯科
细绳 有条件的 “名称”称为“名称”的属性值。例如,如果名称为“尺寸”值可能是“L”。可以从getCategorytraits中收集潜在值。

getsingleItem示例