UpdateInventory.

此呼叫允许您在一个请求中更新许多项目的价格和数量。

笔记:

  • 只有API令牌的展位所拥有的项目将被更新。
  • 最多包含99项,即时同步更新。发送超过99项将触发异步更新。
  • 不支持具有多种变体的项目。
  • 无效或0数量将项目放入“缺少必填字段”状态。

UpdateInventory示例

UpdateInventory.输入

UpdateInventory是一个安全的API方法,具有以下URL和HTTP标头要求:

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

请注意,除此之外的所有安全方法 fetchtoken. GetboothItems. 要求您提交用户令牌,以便我们知道您代表的用户帐户。 有关设置和提交用户令牌的详细信息,请参阅我们的 介绍用户令牌.

您请求的名称应该是 UpdateInventory.Request..

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

争论 类型 发生 意义
请求幸置性 容器 必需的 用于用户凭据的容器
请求幸置性 .bolanzleauthtoken. 细绳 必需的 验证 用户令牌 对于您代表行事的用户。
呼叫特定的输入字段
更新 容器 必需的 嵌套哈希将包括更新项目。
更新.Itemid。 价格 漂浮 有条件的 包括更新商品的价格。
更新.Itemid。 数量 整数 有条件的 包含0或正整数以更新项目的数量。 

UpdateInventory.输出

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

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

返回值 类型 发生 意义
标准输出字段
错误信息 容器 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..*]
一个无法识别的参数数组。
呼叫特定的输出字段
UpdateInventory.Response. 容器 总是 包含项目ID的映射以响应详细信息。
UpdateInventory.Response..Itemid。 成功 布尔基 总是 该项目是否已更新。
UpdateInventory.Response..Itemid。 信息 细绳 有条件的 如果更新未成功,包含错误消息。
如果触发异步更新      
结果 细绳 总是 结果消息将是“排队更新”
成功 布尔基 总是 成功将是真的