物料条件批量调权接口
更新时间：2024-11-13
物料条件批量调权接口
接口说明
百度提供的基于一定条件调整物料权重的接口。
请求示例
HTTP方法：POST
请求URL：http://airec.baidu.com/airec/api/weight/update
Header如下：
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| Content-Type | - | 是 | application/json;charset=UTF-8 |
| X-Gw-Ak | string | 是 | 数据表鉴权信息 |
| Alias-Name | string | 是 | 数据表名称 |
请求格式
POST 方式调用
注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。
请求参数
| 参数名 | 中文名 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| conditions | 筛选条件 | list | 是 | 筛选条件列表，最大支持20条 |
| type | 且/或逻辑 | string | 否 | 且/或逻辑 |
| filters | 过滤条件 | list | 是 | 过滤条件 |
| cond | 要进行的比较操作 | string | 是 | 如"contain"、"not_contain"、"equal"、"not_equal" |
| field | 要筛选的字段名 | string | 是 | 如"tags"、"channel" |
| value | 要筛选的目标值 | - | 是 | 如"军事"、"周星驰" |
| weight | 物料全局权重 | float | 否（weight & channel_weight 两者二选一） | 物料全局权重，值在1-10之间，默认以该权重做排序 |
| channel_weights | 频道下的权重 | list | 否（weight & channel_weight 两者二选一） | 频道下的权重，请求有频道情况下，会优先以该权重做排序 |
| channel | 频道列表 | string | 否 | 频道列表 |
| weight | 频道下的权重 | float | 否 | 频道下的权重，值在1-10之间 |
| scene_name | 应用场景 | string | 是 | 枚举值：tuwen/goods/media |
请求示例1
{
"conditions": [
{
"filters": [
{
"cond": "equal", // 匹配类型
"field": "nid", // 字段名
"value": "nid_1" // 匹配值
}
],
"weight":1.0, // 物料全局权重
"channel_weights": [ // 物料在不同频道下的权重
{
"channel": "频道一",
"weight": 1.1
},
{
"channel": "频道二",
"weight": 2.1
},
{
"channel": "频道三",
"weight": 3.0
}
]
},
{
"filters": [
{
"cond": "equal",
"field": "nid",
"value": "nid_2"
}
],
"weight":1.3, // 物料全局权重
"channel_weights": [ // 物料在不同频道下的权重
{
"channel": "频道一",
"weight": 1.3
},
{
"channel": "频道二",
"weight": 2.3
},
{
"channel": "频道三",
"weight": 3.3
}
]
}
],
"scene_name": "tuwen"
}请求示例2
物料批量删除权重:
{
"conditions": [
{
"filters": [
{
"cond": "not_equal",
"field": "nid",
"value": "xxxx" // 这里设置一个不存在的nid或置空即可
}
],
"weight":1.0, // 物料全局权重，默认为1.0
"channel_weights": [ // 物料在不同频道下的权重，清空
]
}
],
"scene_name": "tuwen"
}返回格式
JSON格式
返回参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| code | string | 是 | 响应码：0正常，其他异常 |
| message | string | 否 | 响应描述 |
| traceid | string | 是 | 推荐一次请求的唯一标识 |
返回示例
{
"code": 0,
"message": "",
"trace_id": "286262231970967396559654621012708541514"
}