更新时间：2025-11-18 GMT+08:00
商品录入 - UploadProduct
功能介绍
商品录入
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/trace/trace-sweepcode/product/submit
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 租户从IAM申请到的projectid，一般为32位字符串 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 用户Token |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
productCode | 是 | String | 商品码，支持大小写字母、数字、下划线、中划线 |
productName | 是 | String | 商品名称 |
productPhotoUrl | 否 | String | 商品介绍图片url |
bannerUrl | 否 | String | 横幅url |
productOrigin | 是 | String | 商品产地 |
sweepcodeStatisticsSwitch | 否 | String | 商品溯源扫码统计开关(0：关闭；1 打开)，默认打开 |
merchant | 是 | String | 商户ID（取值为项目ID） |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
code | String | 返回码 |
message | String | 返回描述 |
状态码：500
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误描述 |
请求示例
{
"productCode" : "test2202",
"productName" : "测试功能2202",
"productOrigin" : "中国/陕西/西安",
"productPhotoUrl" : "https://xxx.xxx.xxx.xxx/petaltrace%2FHWG%26ABG%E6%A1%8C%E9%9D%A2-2023-1.jpg",
"merchant" : "1754386705866125313"
} 响应示例
状态码：200
Success
{
"code" : "200",
"message" : "操作成功!"
} 状态码：500
Error response
{
"code" : "500",
"message" : "系统异常"
} 状态码
状态码 | 描述 |
|---|---|
200 | Success |
500 | Error response |
父主题：商品管理
