批量保存 GMC 类目

批量保存 GMC 类目。

接口级参数规则：categoryList 单次默认最多 100 条；cid、name 必填；cid 仅支持数字和大小写字母，最大 100 字符；name 最大 10 字符；类目属性最多 50 个。

请求字段限制：

categoryList：必填，数组

请求参数

名称	类型	必填	描述	示例值
appKey	string	是	应用 AppKey	1c088a89de51d0af457616605f28390f
time	int64	是	请求时间戳（秒）；与服务器时间误差超过 10 分钟会鉴权失败	1511832531
checksum	string	是	请求签名校验和	f570a5eb049eb803b086e45829b07e48
checksumAlgorithm	int32	否	签名算法：0-SHA-1，1-SHA-256；不传默认为 0（SHA-1）	0

请求体

名称	类型	必填	描述	示例值
categoryList	object[]	是
└id	int64	否	类目内部 ID；新增时可不传	10001
└cid	string	是	外部类目 ID，只允许数字和大小写字母，最大 100 字符	CLOTHES001
└name	string	是	类目名称，最大 10 字符	服装
└categoryAttrs	object[]	否
└id	int64	否	属性 ID	30001
└required	int32	否	是否必填：1-必填，0-非必填	1
└attrName	string	否	属性名称，必须是已存在属性	颜色

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示成功	200
message	string	响应消息	success
data	object	业务数据。具体结构以接口说明为准
total	int32	分页总数，分页接口返回	100
requestId	string	链路请求 ID	0a1b2c3d4e5f
result	object	GMC 批量保存部分失败返回数据
└total	int32	提交总数	10
└successCount	int32	成功数量	8
└failCount	int32	失败数量	2
└successIdList	string[]	保存成功的商品货号或类目外部 ID 列表
└failIdList	string[]	保存失败的商品货号或类目外部 ID 列表

错误码

状态码	描述
14001	AppKey 缺失或不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求体不是合法 JSON 对象，或参数缺失、格式非法
14009	频控限制：接口调用超过限流阈值
14500	服务内部错误
14501	数据查询范围超出限制
14515	当前 AppKey 无接口或资源访问权限

postEndpoint

/openapi/robot/api/gmc/category/save

curl -X POST "https://qiyukf.com/openapi/robot/api/gmc/category/save?appKey=1c088a89de51d0af457616605f28390f&time=1511832531&checksum=f570a5eb049eb803b086e45829b07e48" \  -H "Content-Type: application/json" \  -d '{    "categoryList": [      {        "name": "服装",        "categoryAttrs": [          {            "attrName": "颜色",            "required": 1          }        ],        "cid": "CLOTHES001"      }    ]  }'

{
  "code": 200,
  "data": {},
  "message": "success"
}

{
  "code": 14001,
  "message": "AppKey not exists"
}

{
  "code": 14002,
  "message": "Bad checksum"
}

{
  "code": 14003,
  "message": "Bad time"
}

{
  "code": 14004,
  "message": "body内容json解析错误"
}

{
  "code": 14009,
  "message": "单位时间内请求过于频繁"
}

{
  "code": 14500,
  "message": "Internal error"
}

{
  "code": 14501,
  "message": "Data limit exceeded"
}

{
  "code": 14515,
  "message": "未开通机器人服务"
}