相关推荐接口
更新时间：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 |
请求示例
{
"uid": "xsfe123455",
"nids": "dsexxsfe123455",
"page_id": 1,
"req_cnt": 40
}返回格式
JSON格式
返回参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| code | string | 是 | 响应码：0正常，其他异常 |
| message | string | 否 | 响应描述 |
| trace_id | string | 是 | 推荐一次请求的唯一标识 |
| item_list | list | 是 | 返回的物料 nid列表 |
| size | int | 是 | 返回的物料数量 |
返回示例
{
"code": 0,
"message": "",
"result": {
"item_list": [
"NID_1001",
"NID_1002"
],
"recall_result": {
"热度TOP召回": [
"2828",
"0__647639449832"
],
"短期兴趣召回": [
"NID_1001",
"NID_1002",
"NID_1003",
"NID_1004"
],
"语义相似召回": []
},
"size": 2,
"time": "2024-06-07 11:22:35",
"traceid": "traceid-lrh67"
},
"trace_id": "traceid-lrh67"
}