全部产品
云市场

Recommend

更新时间:2019-10-29 15:32:36

描述

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

请求方法

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 返回结果条数

返回参数

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

ResultItem的参数

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

请求示例

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

返回示例

  1. {
  2. "requestId": "04707E49-642A-4649-827A-F8EEB07D4C27",
  3. "result": [
  4. {
  5. "traceId": "1007.19746.107647.100200300000000:c7bd13e3-371b-4276-b142-4c1a439f21a0:1:40000:0::::2:content___1729346806:image:cd:0.0545865490313237:0.027317269681932512:0.6218346196125295:::::::::::",
  6. "itemId": 1729346806,
  7. "itemType": "image",
  8. "matchInfo": "cd",
  9. "weight": 1.2,
  10. "position": 0
  11. "traceInfo": ""
  12. },
  13. {
  14. "traceId": "1007.19746.107647.100200300000000:c7bd13e3-371b-4276-b142-4c1a439f21a0:1:40000:0::::2:content___1729346806:image:cd:0.0545865490313237:0.027317269681932512:0.6218346196125295:::::::::::",
  15. "itemId": 1729346806,
  16. "itemType": "image",
  17. "matchInfo": "cd",
  18. "weight": 1.0,
  19. "position": 0,
  20. "traceInfo": ""
  21. }
  22. ]
  23. }