getCategorytraits.

检索关于给定类别的所有项目特征的完整信息。例如,在“漫画书”类别中,适用的项目特征可能包括“年发布”,“出版商”和“条件”。此信息可在其中使用 发布 或者 编辑 项目或项目特征可以作为滤波器应用于缩小 搜索结果.

getCategorytraits输入

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

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

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

因此,例如,这里是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
  "getCategorytraitraitsRequest.=your_serialized_JSON_data", # The data being posted
  { 'X-BONANZLE-API-DEV-NAME' => 'abcdef123456' } # The HTTP header, which gives your dev_id
)

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

争论 类型 发生 意义
呼叫特定的输入字段
compouttsid. 整数 必需的 您要抓取的特征的类别的数字ID。

getCategorytraits输出

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

my_json_hash['getCategorytraits.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..*]
一个无法识别的参数数组。
警告。类别_deleted. 容器 有条件的 输入类别在Bonanza上不再使用。请用 get类别 或者访问您的仪表板以下载最新类别。
呼叫特定的输出字段
Traitarray. 容器 总是,重复:[0 .. *] 包含给定类别的可用性特征的数组。
Traitarray。htmlinputtype. 细绳 总是 项目特征的类型是。可能的值包括:
  • 落下。一个选择器框,可以选择一个值。
  • checkboxset.。复选框,其中多个值可以是真或假的。
  • 文本域。一个文本字段,用户可以自由输入其值。
Traitarray。ID 整数 总是 此项目特征的唯一ID。
Traitarray。标签 细绳 总是 这个特质的名称。例如,“材料”,“颜色”,“品牌”等。
Traitarray。parenttraitid. 整数 总是 这个特质的父母的id。在通过搜索结果遍历时可以是有用的,知道像“颜色”映射到“装饰收集物”的“颜色”映射。
Traitarray。variationsenabled. 布尔基 总是 如果这是一个可以具有为其指定的变体的特征,则返回true。看 AddFixedPriceItem. 有关变化的更多细节。
Traitarray。RequestSellerInput. 布尔基 总是 如果这是一个特征,那么卖方会愿意卖方并包含在项目创建中的特征。
Traitarray。差异 容器 有条件地,可重复:[0 .. *] 包含特征的可能值的数组,仅适用于特质时 htmlinputtype. is "落下."
traitarray.traitValues。显示顺序 整数 有条件的 如果在列表中显示,应呈现此特征值的顺序。较低的数字应在列表之上。
traitarray.traitValues。姓名 细绳 有条件的 这个特征价值的名称,例如“绿色”,“红色,”皮革,“”新建“等。
traitarray.traitValues。searchid. 整数 有条件的 用作过滤器的整数 findItemsbyKeywords. 仅过滤具有此项目特征集的搜索结果。

getCategorytraits示例