智能推荐 Recommend

描述

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

请求方法

GET

URI

/openapi/instances/{instanceId}/actions/recommend

请求参数

名称	类型	是否必选	描述
sceneId	String	是	物品被投放的场景id
userId	String	否	用户唯一id
ip	String	否	用户最后登录的ip
imei	String	否	1、非注册用户必填2、按照指定要求，mac地址，设备号等无效，会无法使用内部用户画像信息，仅保留曝光过滤功能3、32位MD5值 4、安卓:MD5（imei),IOS:MD5（idfa）
ReturnCount	Integer	是	返回结果条数（0-50之间）

返回参数

名称	类型	描述
RequestId	String	请求id，公共参数
Result	List	ResultItem组成的数据

ResultItem的参数

名称	类型	描述
traceId	String	traceId=traceInfo：两个兼容，回传日志时使用，回传日志时，trace_id=ali，trace_info为返回结果里traceInfo的值（注意：每个item的值均不一样，回传日志时，需要传对应的）
itemId	String	物品Id
itemType	String	物品类型
matchInfo	String	不用关心，debug时可能用到
weight	Float	不用关心，debug时可能用到
position	Integer	物品在需要展示的位置，从0开始（注意：返回结果已经按照position排序，可以不用关注）
traceInfo	String	traceInfo=traceId

请求示例

GET /openapi/instances/airec-cn-dsksdlisdlfsd/actions/recommend
?sceneId=1&userId=2&ip=10.120.70.19&returnCount=10

返回示例

{
  "requestId": "04707E49-642A-4649-827A-F8EEB07D4C27",
  "result": [
    {
      "traceId": "1007.19746.107647.100200300000000:c7bd13e3-371b-4276-b142-4c1a439f21a0:1:40000:0::::2:content___1729346806:image:cd:0.0545865490313237:0.027317269681932512:0.6218346196125295:::::::::::",
      "itemId": 1729346806,
      "itemType": "image",
      "matchInfo": "cd",
      "weight": 1.2,
      "position": 0，
      "traceInfo": ""      
    },
    {
      "traceId": "1007.19746.107647.100200300000000:c7bd13e3-371b-4276-b142-4c1a439f21a0:1:40000:0::::2:content___1729346806:image:cd:0.0545865490313237:0.027317269681932512:0.6218346196125295:::::::::::",
      "itemId": 1729346806,
      "itemType": "image",
      "matchInfo": "cd",
      "weight": 1.0,
      "position": 0,
      "traceInfo": ""
    }
  ]
}