物料条件批量调权接口
更新时间：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
Plain Text
1{
2 "conditions": [
3 {
4 "filters": [
5 {
6 "cond": "equal", // 匹配类型
7 "field": "nid", // 字段名
8 "value": "nid_1" // 匹配值
9 }
10 ],
11 "weight":1.0, // 物料全局权重
12 "channel_weights": [ // 物料在不同频道下的权重
13 {
14 "channel": "频道一",
15 "weight": 1.1
16 },
17 {
18 "channel": "频道二",
19 "weight": 2.1
20 },
21 {
22 "channel": "频道三",
23 "weight": 3.0
24 }
25 ]
26 },
27 {
28 "filters": [
29 {
30 "cond": "equal",
31 "field": "nid",
32 "value": "nid_2"
33 }
34 ],
35 "weight":1.3, // 物料全局权重
36 "channel_weights": [ // 物料在不同频道下的权重
37 {
38 "channel": "频道一",
39 "weight": 1.3
40 },
41 {
42 "channel": "频道二",
43 "weight": 2.3
44 },
45 {
46 "channel": "频道三",
47 "weight": 3.3
48 }
49 ]
50 }
51 ],
52 "scene_name": "tuwen"
53}请求示例2
物料批量删除权重:
Plain Text
1{
2 "conditions": [
3 {
4 "filters": [
5 {
6 "cond": "not_equal",
7 "field": "nid",
8 "value": "xxxx" // 这里设置一个不存在的nid或置空即可
9 }
10 ],
11 "weight":1.0, // 物料全局权重，默认为1.0
12 "channel_weights": [ // 物料在不同频道下的权重，清空
13
14 ]
15 }
16 ],
17 "scene_name": "tuwen"
18}返回格式
JSON格式
返回参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| code | string | 是 | 响应码：0正常，其他异常 |
| message | string | 否 | 响应描述 |
| traceid | string | 是 | 推荐一次请求的唯一标识 |
返回示例
Plain Text
1{
2 "code": 0,
3 "message": "",
4 "trace_id": "286262231970967396559654621012708541514"
5}