相关推荐接口
更新时间：2024-06-07
相关推荐接口
接口说明
百度提供的相关推荐接口，推荐和用户指定物料相关的物料集合。
请求示例
HTTP方法：POST
请求URL：http://airec.baidu.com/airec/api/rec/r_rec
Header如下：
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| Content-Type | - | 是 | application/json;charset=UTF-8 |
| X-Gw-Ak | string | 是 | 推荐服务鉴权信息 |
| Alias-Name | string | 是 | 推荐服务应用名 |
请求格式
POST 方式调用
注意：要求使用 JSON 格式的结构体来描述一个请求的具体内容。
请求参数
| 参数名 | 中文名 | 类型 | 是否必填 | 备注 |
|---|---|---|---|---|
| nids | 相关物料ID | string | 是 | 物料唯一标志 |
| uid | 用户ID | string | 是 | 用户唯一标志 |
| req_cnt | 请求个数 | int | 否 | 单次请求物料个数, 不传默认为10 |
| page_id | 当前推荐页数 | string | 否 | 当前推荐页数，默认1 |
| filter | 过滤条件 | dict | 否 | 过滤条件 |
| scene_key | 场景管理key | string | 否 | 场景管理key |
请求示例
Plain Text
1{
2 "uid": "xsfe123455",
3 "nids": "dsexxsfe123455",
4 "page_id": 1,
5 "req_cnt": 40
6}返回格式
JSON格式
返回参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| code | string | 是 | 响应码：0正常，其他异常 |
| message | string | 否 | 响应描述 |
| trace_id | string | 是 | 推荐一次请求的唯一标识 |
| item_list | list | 是 | 返回的物料 nid列表 |
| size | int | 是 | 返回的物料数量 |
返回示例
Plain Text
1{
2 "code": 0,
3 "message": "",
4 "result": {
5 "item_list": [
6 "NID_1001",
7 "NID_1002"
8 ],
9 "recall_result": {
10 "热度TOP召回": [
11 "2828",
12 "0__647639449832"
13 ],
14 "短期兴趣召回": [
15 "NID_1001",
16 "NID_1002",
17 "NID_1003",
18 "NID_1004"
19 ],
20 "语义相似召回": []
21 },
22 "size": 2,
23 "time": "2024-06-07 11:22:35",
24 "traceid": "traceid-lrh67"
25 },
26 "trace_id": "traceid-lrh67"
27}