API对接文档
品牌基因列表
POST
/v1/brandGene/listapplication/json请求体
pageNumnumber可选默认1页码
pageSizenumber可选默认10每页条数，最大 10000
keywordstring可选关键词，模糊匹配品牌基因名称、风格关键词和自定义设置，不传则返回全部
请求示例
{
"pageNum": 1,
"pageSize": 10,
"keyword": "科技"
}响应体
codeinteger状态码，200 为成功
msgstring响应描述
msgKeystring错误编码，仅在失败时存在
dataobject对象字段
listarray品牌基因列表，按创建时间倒序
数组元素
idstring品牌基因 ID，按字符串返回
brandNamestring品牌基因名称
brandColorarray[string]品牌颜色，最多 8 个，格式为 #RRGGBB；空数组表示使用智能主色
fontStylestring字体风格
salesRegionstring销售国家/地区
languagestring生成图片语言
platformstring发布平台
customSettingsstring用户自定义设置
brandSourcestring品牌视觉来源：
MANUAL 手动设置、REFERENCE 参考图提取、BRAND_KIT 品牌套件styleKeywordsarray[string]风格关键词，最多 6 个
coverUrlstring列表封面临时地址，有效期有限；无视觉素材时为空
totalnumber总数
hasMoreboolean是否还有更多数据
响应示例
{
"code": 200,
"msg": "成功",
"data": {
"list": [
{
"id": "1849000000000000001",
"brandName": "科技品牌",
"brandColor": ["#0B0B45", "#FFFFFF"],
"fontStyle": "几何无衬线体",
"salesRegion": "美国",
"language": "英语",
"platform": "亚马逊",
"customSettings": "现代、简洁的科技视觉气质。",
"brandSource": "REFERENCE",
"styleKeywords": ["科技", "现代"],
"coverUrl": "https://cdn.example.com/UPLOAD/team/ref-1.jpg?Expires=..."
}
],
"total": 1,
"hasMore": false
}
}使用说明
列表只返回当前团队创建的品牌基因，并按创建时间倒序。keyword只做模糊匹配，不做分词；可与分页参数组合使用。
把返回项中除id、coverUrl以外的品牌字段作为商品套图或服装套图的brandKey对象提交，即可复用该品牌基因。coverUrl是临时展示地址，不要写入业务数据或长期缓存。