更新时间:2022-04-25 GMT+08:00
分享

预测接口(排序)

功能介绍

线上预测接口。

URI

POST 服务部署成功后返回的预测地址。

请求消息

请求参数请参见表1 请求参数说明

表1 请求参数说明

参数名称

是否必选

参数类型

说明

rec_num

Integer

请求返回数量,默认返回50条。

user_id

String

用户ID。

rank_items

List

用户自己上传的候选集列表。

响应消息

响应参数请参见表2-响应参数说明
表2 响应参数说明

参数名称

是否必选

参数类型

说明

is_success

Boolean

true表示预测成功,false表示预测失败。

data

JSON

请参见表3 data参数说明

表3 data参数说明

参数名称

是否必选

参数类型

说明

trace_id

String

消息追踪ID,标识本次请求的推荐结果。

rec_num

Integer

返回的结果数量。

user_id

String

用户ID

content

List

请参见表4,推荐物品的内容。

表4 content参数说明

参数名称

是否必选

参数类型

说明

score

Float

物品打分值,值越高推荐越靠前。

item

JSON

请参见表5,推荐物品。

表5 item参数说明

参数名称

是否必选

参数类型

说明

id

String

推荐物品ID。

示例

  • 请求示例
    {
        "rec_num": 50,
        "user_id": "260086000000100759",
        "rank_items": ["00860135010002401", "3101010003401"]
    }
  • 成功响应示例
    {
        "is_success": true,
        "data": {
            "trace_id": "a94495c062c6443b87c097427d99232d",
            "user_id": "260086000000100759",
            "rec_num": 2,
            "content": [
                {
                    "score": 0.524979,
                    "item": {
                        "id": "00860135010002401"
                    }
                },
                {
                    "score": 0.524979,
                    "item": {
                        "id": "3101010003401"
                    }
                }
            ]
        }
    }
  • 失败响应示例
    {
        "is_success": false,
        "error_msg": "Backend service found error. Failed to respond due to backend service not found or failed to respond, please check the service you request. "
    }

状态码

状态码请参见状态码

相关文档