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。 信息 | 细绳 | 有条件的 | 如果更新未成功,包含错误消息。 |
如果触发异步更新 | |||
结果 | 细绳 | 总是 | 结果消息将是“排队更新” |
成功 | 布尔基 | 总是 | 成功将是真的 |