Recommend - 智能推荐

该接口用于获取指定实例的推荐结果。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
instanceIdstring

实例id

airec-test001
sceneIdstring

物品被投放的场景id

test
userIdstring

用户唯一id

123
ipstring

用户最后登录的ip

192.168.1.1
imeistring

设备id

06e1565409c9fc4887036b974421****
returnCountinteger

返回结果条数(0-50之间)

10
itemsstring

用于相关推荐的item(限于相关推荐场景使用)

1001
serviceTypestring

1
userInfostring

1
rankOpenboolean

召回排序阶段是否根据用户id个性化排序

true
recTypestring

推荐服务类型

gul
filterstring

推荐过滤字符串

eyJqb2luIjoiYW5kIiwiZmlsdGVycyI6W3siY29uZCI6ImNvbnRhaW4iLCJmaWVsZCI6InRhZ3MiLCJ2YWx1ZSI6IuWPjOS6uiJ9XX0.

返回参数

名称类型描述示例值
object
resultarray

返回结果

object

返回结果

matchInfostring

不用关心,debug时可能用到

xxx
traceIdstring

回传日志时使用,回传日志时,trace_id=ali

ali
positioninteger

物品在需要展示的位置,从0开始(注意:返回结果已经按照position排序,可以不用关注)

1
itemIdstring

物品Id

123
itemTypestring

物品类型

item
traceInfostring

返回结果里traceInfo的值(注意:每个item的值均不一样,回传日志时,需要传对应的)

"1007.62381.131491.100200300000000:bcb946ed-3f09-4e9b-bf4a-c19862f42231:792783::0:s101:::15:content___130788_stall:item:i2i_common_common:0.0205279946753756:null:null:1673258031504::context__recall_index=156,context__hour=17,context__trigger_num=2::C7EF99C9-6C55-5D45-A8D5-0754082E9DCF:hot_common,i2i_common_common,i2i_swing_common,hot_full:::::"
weightnumber

权重

1
flowWeightnumber

指定流程的权重

messagestring

状态信息

Successful
codestring

状态码

200
requestIdstring

请求id

04707E49-642A-4649-827A-F8EEB07D4C27
messagestring

状态信息

"i2i_common_common;NotFound;1673254401;similar product/content of clicked ones;2023-01-09 16:53:21"

示例

正常返回示例

JSON格式

{
  "result": [
    {
      "matchInfo": "xxx",
      "traceId": "ali",
      "position": 1,
      "itemId": "123",
      "itemType": "item",
      "traceInfo": "\"1007.62381.131491.100200300000000:bcb946ed-3f09-4e9b-bf4a-c19862f42231:792783::0:s101:::15:content___130788_stall:item:i2i_common_common:0.0205279946753756:null:null:1673258031504::context__recall_index=156,context__hour=17,context__trigger_num=2::C7EF99C9-6C55-5D45-A8D5-0754082E9DCF:hot_common,i2i_common_common,i2i_swing_common,hot_full:::::\"",
      "weight": 1,
      "flowWeight": 0,
      "message": "Successful"
    }
  ],
  "code": "200",
  "requestId": "04707E49-642A-4649-827A-F8EEB07D4C27",
  "message": "\"i2i_common_common;NotFound;1673254401;similar product/content of clicked ones;2023-01-09 16:53:21\""
}

错误码

访问错误中心查看更多错误码。

阿里云首页 智能推荐 AIRec 相关技术圈