AddFixedPriceItem.

AddFixedPriceItem. 允许您代表Bonanza用户将物品发布到展位。在能够添加项目之前,用户必须验证您是否已代表其授权行动,请参阅我们的 介绍用户令牌 for more details.

看一看 在C#,Java,PHP,Python和Ruby中的一些示例。

如果您正在添加的展位有超过40k的项目,则您的呼叫将异步处理。回复将是:

{ 'resultMessage' => "Item queued for addition", 'success' => true }

AddFixedPriceItem输入

AddFixedPriceItem是一个安全的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. 要求您提交用户令牌,以便我们知道您代表的用户帐户。 有关设置和提交用户令牌的详细信息,请参阅我们的 介绍用户令牌.

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

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

争论 类型 发生 意义
请求幸置性 容器 必需的 用于用户凭据的容器
请求幸置性 .bolanzleauthtoken. 细绳 必需的 验证 用户令牌 对于您代表行事的用户。
呼叫特定的输入字段
物品 容器 必需的 容器保留有关已发布项目的所有细节。
物品。 custom类别 整数 选修的 也称为展位类别,自定义类别ID对应于用户定义的类别。 了解更多
物品。 描述 细绳 选修的 物品的描述。可以包括大多数HTML。
最长长度: 60000 characters.
物品。 外部产物 细绳 选修的 此项目的可选字符串标识符,以便可以使用第三方库存系统跟踪它。
物品。 obo. 布尔基 选修的 如果卖家不接受此项目的优惠,则为False。默认情况下。
物品。 物品详情 容器 选修的 用于提供物品特征的容器。
物品。 itemspecifics。细节 标签值对数组 选修的 标签/值对数组,例如[[条件“,”新“],[”类型“,”浪漫“]]。指定项目特征将对Bonanza和Search引擎的项目进行更多流量。
物品。 itemspecifics。迪卡尔德 布尔基 选修的 如果为true,则在导入新的细节之前将丢弃项目的所有现有细节。
物品。 picturedetails. 容器 选修的 用于提供有关项目图片的详细信息的集装箱。
物品。 picturedeTails。迪卡尔德 布尔基 选修的 如果为true,则在导入新图片之前将丢弃项目的所有现有图片。
物品。 picturedeTails。pictureurl. 奥里瑞 可选,可重复:[0..3] 最多四个用于与此项目相关联的图片的URL。当您提出请求时,我们将从Web中获取这些图像,因此请确保Bonanza.com域可以访问它们。
物品。 picturedeTails。picturefilename. 图像数据 可选,可重复:[0..3] 最多四张图片与此项目相关联。这些应包括为多部分表单数据。
物品。 价格 双倍的 选修的 此商品应以美元列出的价格。
物品。 小型类别 容器 选修的 容器指定项目的类别。看 get类别.
Item.PrimaryCategory。compouttsid. 整数 选修的 此项目的类别的ID。
物品。 数量 整数 选修的 销售的物品的数量。一个是默认值。设置为0将返回一个 卖斯特泰特 of 缺少必填字段。
物品。 退货政策 容器 选修的 持有有关此项目的退货策略的详细信息。
物品。 returnpolicy。
描述
细绳 选修的 卖方退货政策的详情。
物品。 returnpolicy。
returnsacceptedoption.
细绳 选修的 卖方是否会接受此项目的退货。可能的选择:
  • 接受退货
  • returnsnotaccepted.
物品。 returnpolicy。
returnswithinoption.
整数 选修的 买方可以在他们收到物品的那天返回这段时间内的物品。使用returnpolicy.description字段来解释策略细节
物品。 returnpolicy。
shippingcostpaidbyoption.
细绳 选修的 如果卖方将支付返回运费或“买方”,则价值应为“卖方”。
物品。 送货细节 容器 选修的 有关销售物品的运输的详细信息。
Item.ShippingDetails.
ShipswithIndays.
整数 选修的 物品将在内部发货的工作日数
Item.ShippingDetails。
CalcultShippingrate.
容器 如果fookingtype是“计算” 用于计算的运输细节的容器。
Item.ShippingDetails。
计算架步。
包装
细绳 选修的 适用价值观:
  • 大信封
  • 普通套餐
  • 大包装
  • 非常大的包装
  • USPS. 优先邮件小型统一框
  • USPS. 优先邮件媒体统一速率框
  • USPS. 优先邮件大型汇率盒
  • USPS. 优先邮件统一费率信封
  • USPS. 优先邮件填充额定速率信封
  • USPS. 优先邮件法律固定利率信封
Item.ShippingDetails。
计算架步。
运费重量
整数 如果fookingtype是“计算” 此包装的磅数。
Item.ShippingDetails。
计算架步。
..
整数 如果fookingtype是“计算” 此包装的盎司数量,超出运输磅。也就是说,如果包装是16磅,8盎司,那么这个字段应该是“8”。
Item.ShippingDetails。
计算架步。
运费
整数 如果fookingtype是“计算”,并且“包装”是未指明的 以英寸为单位的高度。请注意,选择为高度,宽度和深度的一侧是任意的。一个只需要指定三个维度中的每一个的长度。
Item.ShippingDetails。
计算架步。
运费宽
整数 如果fookingtype是“计算”,并且“包装”是未指明的 包装宽度为英寸。请注意,选择为高度,宽度和深度的一侧是任意的。一个只需要指定三个维度中的每一个的长度。
Item.ShippingDetails。
计算架步。
装运Depth.
整数 如果fookingtype是“计算”,并且“包装”是未指明的 以英寸为单位的封装深度。请注意,选择为高度,宽度和深度的一侧是任意的。一个只需要指定三个维度中的每一个的长度。
Item.ShippingDetails。
武装部队
容器 选修的 有关运输保险的详细信息。
Item.ShippingDetails.insuranceTeTails。
保险费
细绳 选修的 提供的航运保险类型。 适用价值:
  • CharedingShippingHandling.。航运保险免费提供标准运费。
  • 选修的 。可以选择收取运费保险。
  • 必需的 。必须增加运输保险费。
Item.ShippingDetails.insuranceTeTails。
保险费
双倍的 选修的 国内航运保险费用。
Item.ShippingDetails. .InternationalShippingserviceOption. 容器 可选,可重复:[0 .. *] 用于描述国际运输选项的容器数组。
Item.ShippingDetails .InternationalShippingserviceOption。 opportype. 细绳 必需的 为此目的地提供的运费类型。 适用价值:
  • 计算
  • 固定的
  • 自由
  • 种子
Item.ShippingDetails .InternationalShippingserviceOption。 Shiptolocation. 细绳 必需的 我们指定运费的地区。 适用价值观:
  • 非洲
  • 亚洲
  • 澳大利亚
  • 加拿大
  • 欧洲
  • 德国
  • 日本
  • 墨西哥
  • N.和S.美国
  • 英国
  • 全世界
Item.ShippingDetails .InternationalShippingserviceOption。 shippingservicecost. 双倍的 如果FookingType是“固定”的要求 运送到Shippolocation中指定的区域的平价费用。
Item.ShippingDetails。 InternationalShippingServiceOption. .. string 如果fookingtype是“计算” 使用的航运载体的名称。仅在“计算运输”宣布时才适用。适用价值观:
  • UPS
  • USPS.
  • 联邦快递
Item.ShippingDetails. .ShipPingserviceOptions. 容器 可选,可重复(0。*) 用于国内航运详情的集装箱。
Item.ShippingDetails.ShippingServiceOptions。
买方Paysforlabel.
布尔基 选修的 允许买方作为购物的一部分支付运输标签的费用。
Item.ShippingDetails .ShippingServiceOptions。
opportype.
细绳 必需的 提供的运费类型。 适用价值:
  • 计算
  • 固定的
  • 自由
  • 种子
Item.ShippingDetails。
shippingserviceoptions。
免运费
布尔基 选修的 如果是真,国内运费是免费的。请注意,必须设置此变量,或者在商品可以在Bonanza销售之前必须设置ShippingServiceCost。
Item.ShippingDetails。
shippingserviceoptions。 shippingservicecost.
双倍的 如果FookingType是“固定”的要求 国内运输的扁平费用。
Item.ShippingDetails。
shippingserviceoptions。 Shippingservice.
shippingservicetype. 选修的 shippingservicetype. 适用于适用价值
Item.ShippingDetails。
shippingserviceoptions。 ChinessionScarrier.
细绳 如果fookingtype是“计算” 使用的航运载体的名称。仅在“计算运输”宣布时才适用。适用价值观:
  • UPS
  • USPS.
  • 联邦快递
物品 .sku. 细绳 选修的 商品的SKU,用于库存跟踪目的。
物品 。标题 细绳 要求卖 项目的标题,最多80个字符。虽然您不一定要用您的请求提交这一点,但您的物品将无法出售,直到给出有效的标题。
物品 。变化 逐项,可选择[0..n] 选修的 有关此项目的潜在变化的详细信息。在单个固定价格列表中,变化是多种相似(但不是相同的)项目。例如,T恤上市可能包含多个品牌的相同品牌,这些品牌因颜色和大小而异(如“蓝色,大”和“黑色,中等”)。每个变体指定其中一种颜色和大小的组合。每个变化可以具有不同的数量。您可以同时从一个变体购买多个项目。 (即,一个订单行项目可以包含来自单个变体的多个项目。)
Item.Variations。
价格
双倍的 选修的 这种变化应以美元列出的价格。如果未指定任何变化价格,则变更价格将被设置为“默认”项目中提交的项目 物品。 price. argument.
Item.Variations。
数量
整数 如果使用变体需要 这个特定项目变异的数量
Item.Variations。
斯科
细绳 选修的 变异的SKU
Item.Variations。
UPC.
细绳 选修的 变异的UPC
Item.Variations。
姓名 valuelist.
名称valuelist容器,可选择[0..2] 如果使用变化,则需要 项目变体名称/值对的容器。试图提交超过两次将返回一个 toomanyredariationnames. error.
Item.Variations。
nameValueList.
姓名
细绳 如果使用变化,则需要 被指定的属性的名称,即“size”。从getCategorytraits收集。在所有变体中,名称必须是相同的。
Item.Variations。
nameValueList.
价值
细绳 如果使用变化,则需要 “名称”称为“名称”的属性值。例如,如果名称为“尺寸”值可能是“L”。可以从getCategorytraits中收集潜在值。

AddFixedPriceItem输出

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

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

返回值 类型 发生 意义
标准输出字段
错误信息 容器 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..*]
一个无法识别的参数数组。
呼叫特定的输出字段
itemid. 整数 总是 创建的项目的唯一ID。
compouttsid. 整数 总是 此项目列出的类别的ID。
卖斯特泰特 细绳 总是 目前的物品销售状态。 适用价值观:.
  • 积极的 。此商品目前在Bonanza上出售。
  • 结束了 。此商品目前尚未出售。它可能是保留或销售。
  • 缺少必填字段。此项目已创建,但它没有必要的一些领域可供出售。
  • 准备出售。此项目包含所有必要的字段来发布,一旦用户点击“更新展位”按钮,它将可供销售。
  • 未知 。此项目的状态无法确定。
信息 细绳 有条件的 提供缺失字段的详细描述,以防止该项目可供出售。

AddFixedPriceItem示例