Http Method GET Http 返回格式 JSON Http 请求参数说明参数类型是否必需描述 userid string 否用户 id imei string 否用户手机 IMEI 号 cid string 否用户网站 cookieid( 注意 :userid imei cid 至少包

Size: px

Start display at page:

Download "Http Method GET Http 返回格式 JSON Http 请求参数说明参数类型是否必需描述 userid string 否用户 id imei string 否用户手机 IMEI 号 cid string 否用户网站 cookieid( 注意 :userid imei cid 至少包"

肠刷都
6 years ago
Views:

1 智能推荐接口文档概览达观数据科技为应用方提供了功能强大使用灵活的推荐系统, 能够有效的提升用户的粘性, 促进产品的成交和转化达观智能推荐系统服务采用简单易用的 HTTP 接口, 供应用方调用获取推荐结果在网站或手机 APP 上展示达观推荐系统提供三种类型的推荐服务 : 1. 个性化推荐服务 : 为每个用户定制的个性化的推荐, 常以猜你喜欢或发现或你可能还需要等形式出现, 根据每个用户的喜好夺身定制 2. 相关推荐服务 : 根据当前所浏览的商品, 推荐相关的商品, 常以相关的商品经常一起购买的商品同类型商品看了又看等形式出现 3. 热门推荐服务 : 各种数据计算得到的排行榜, 支持全局排行以及分类热门排行等同时这三项功能, 在达观后台也提供详细的推荐配置, 以及数据统计功能, 让使用者充分掌握推荐功能的运行状态注意事项您需要完成以下步骤后, 才可调用达观数据相关服务 1. 如您还没有开通达观账号, 请先开通, 账号开通请参考文档 :Step 1: 开通账号 ( start/step1) 2. 获取您的 appid 及 appname, 请参考文档 : 获取 AppId 及 AppName ( 获取 AppId AppName) 3. 设置 IP 白名单, 请参考文档 : 设置 IP 白名单 ( start/step1# 设置 IP 白名单 ) 4. 使用智能推荐服务, 请先进行数据上报数据上报请参考文档 : 数据上报接口文档 ( report) 接口列表个性化推荐服务 URL Http Method

2 Http Method GET Http 返回格式 JSON Http 请求参数说明参数类型是否必需描述 userid string 否用户 id imei string 否用户手机 IMEI 号 cid string 否用户网站 cookieid( 注意 :userid imei cid 至少包含一项, 可都填写 ) scene_type string 否场景类型, 用于标时不同的场景, 常用的包括 pc_home(pc 首页个性推荐 ),android_detail( 安卓详情页个性化推荐 ) 等不在上述中的可以自行添加 start int 否开始项, 用于翻页, 默认为 0, 最大为 128 cnt int 否需要推荐的数目, 默认为 10, 最大为 64 exclude string 否需要过滤的 itemid 列表, 这些 itemid 推荐结果不会返回如果有多个 itemid 请以, 分隔 rsn int 否是否返回推荐理由,0 为否,1 为是默认为 1 cateid string 否是否需要按照类别过滤 itemid 列表, 有则推荐的 item 必须是这个类别的 Http 返回结果说明字段类型描述 status string 执行结果,OK 为成功,FAIL 为失败,,WARN 为有部分非重要字段异常, 请根据返回错误信息进行排查 rec_data string 推荐结果, 为一个 LIST, 每一项为一个 dict, 包括推荐 itemid, 以及 rsn( 如果请求了推荐理由 ) request_id string 该条查询的记录 id, 主要用于排查问题使用 errors string 如果 FAIL 或 WARN 时返回错误码和错误信息示例 CURL 调用示例 : curl ' = &userid= &exclude=192,2102,3444&rsn=1&scene_type=pc_ho me'

3 成功返回示例 : "status":"ok", "request_id":" ", "rec_data":[ "id":"34", "rsn":" 和您口味相似的用户也喜欢 ", "id":"15", "rsn":" 根据您的浏览记录推荐 " ] 错误返回示例 : "status":"fail", "errors": "message":"userid,cid,imei all null" 警告返回示例 : "status":"warn", "errors": "message":"rsn value is incorrect" 相关推荐服务 URL Http Method GET Http 返回格式

4 Http 返回格式 JSON Http 请求参数说明参数类型是否必需描述 itemid string 是当前物品 id, 请求和该 itemid 相关的推荐物品 userid string 否用户 id imei string 否用户手机 IMEI 号 cid string 否用户网站 cookieid( 注意 :userid imei cid 至少包含一项, 可都填写 ) scene_type string 否场景类型, 用于标时不同的场景, 常用的包括 pc_home(pc 首页个性推荐 ),android_detail( 安卓详情页个性化推荐 ) 等不在上述中的可以自行添加 start int 否开始项, 用于翻页, 默认为 0, 最大为 128 cnt int 否需要推荐的数目, 默认为 10, 最大为 64 exclude string 否需要过滤的 itemid 列表, 这些 itemid 推荐结果不会返回如果有多个 itemid 请以, 分隔 rsn int 否是否返回推荐理由,0 为否,1 为是默认为 1 cateid string 否是否需要按照类别过滤 itemid 列表, 有则推荐的 item 必须是这个类别的 Http 返回结果说明字段类型描述 status string 执行结果,OK 为成功,FAIL 为失败,,WARN 为有部分非重要字段异常, 请根据返回错误信息进行排查 rec_data string 推荐结果, 为一个 LIST, 每一项为一个 dict, 包括推荐 itemid, 以及 rsn( 如果请求了推荐理由 ) request_id string 该条查询的记录 id, 主要用于排查问题使用 errors string 如果 FAIL 或 WARN 时返回错误码和错误信息示例 CURL 调用示例 : curl ' =2&imei=abcdefg&userid= &exclude=1,2,3&rsn=1&scene_type=pc_detail' 成功返回示例 :

5 "status":"ok", "request_id":" ", "rec_data":[ "id":"34", "rsn":"60% 的用户也浏览过 ", "id":"15", "rsn":" 同作者作品 " ] 错误返回示例 : "status":"fail", "errors": "message":"itemid is required" 警告返回示例 : "status":"warn", "errors": "code":2013, "message":"rsn value is incorrect" 热门推荐服务 URL Http Method GET Http 返回格式

6 JSON Http 请求参数说明参数类型是否必需描述 userid string 否用户 id imei string 否用户手机 IMEI 号 cid string 否用户网站 cookieid( 注意 :userid imei cid 至少包含一项, 可都填写 ) scene_type string 否场景类型, 用于标时不同的场景, 常用的包括 pc_home(pc 首页个性推荐 ),android_detail( 安卓详情页个性化推荐 ) 等不在上述中的可以自行添加 cateid string 否如果该项为空, 则为全局排行, 如果不为空, 则为相应分类排行 start int 否开始项, 用于翻页, 默认为 0, 最大为 128 cnt int 否需要推荐的数目, 默认为 10, 最大为 64 rsn int 否是否返回推荐理由,0 为否,1 为是默认为 1 Http 返回结果说明字段类型描述 status string 执行结果,OK 为成功,FAIL 为失败,,WARN 为有部分非重要字段异常, 请根据返回错误信息进行排查 rec_data string 推荐结果, 为一个 LIST, 每一项为一个 dict, 包括推荐 itemid, 以及 rsn( 如果请求了推荐理由 ) request_id string 该条查询的记录 id, 主要用于排查问题使用 errors string 如果 FAIL 或 WARN 时返回错误码和错误信息示例 CURL 调用示例 : curl ' imei=abcdefg&userid= &scene_type=pc_home' 成功返回示例 :

7 "status":"ok", "request_id":" ", "rec_data":[ "id":"34", "rsn":" 昨日阅读榜前 10", "id":"15", "rsn":" 总收藏榜前 50" ] 错误返回示例 : "status":"fail", "errors": "code":2015, "message":"" 警告返回示例 : "status":"warn", "errors": "message":"rsn value is incorrect"

同时, 用户可在系统后台查看到并且进行结果反馈操作结果反馈请点击右侧的操作按钮反馈结果会上传系统用于模型训练和效果提升如需将反馈结果实时响应给应用方, 可以添加回调地址回调地址是应用方提供的, 接受消息推送的地址添加回调地址之后, 一旦用户在系统平台提交结果反馈, 反馈结果会通过 POS

同时, 用户可在系统后台查看到并且进行结果反馈操作结果反馈请点击右侧的操作按钮反馈结果会上传系统用于模型训练和效果提升如需将反馈结果实时响应给应用方, 可以添加回调地址回调地址是应用方提供的, 接受消息推送的地址添加回调地址之后, 一旦用户在系统平台提交结果反馈, 反馈结果会通过 POS 文本挖掘接口文档概述达观数据科技为应用方提供了功能强大使用灵活的文本挖掘服务, 通过简单易用的 HTTP 接口, 帮助应用方有效分析大量的文本数据, 提高应用方的处理效率达观文本挖掘系统提供四种文本挖掘服务 : 1. 文章自动标签提取 : 从文本数据中自动提取出较为重要的关键词标签 2. 文章自动归类 : 自动判别文章所属类别, 并给出相应的置信度, 比如判断一篇文章是属于娱乐八卦时事政治还是数码科技等

Http Method GET Http 返回格式 JSON Http 请求参数说明 参数类型是否必需描述 userid string 否用户 id imei string 否用户手机 IMEI 号 cid string 否用户网站 cookieid( 注意 :userid imei cid 至少包

Http Method GET Http 返回格式 JSON Http 请求参数说明参数类型是否必需描述 userid string 否用户 id imei string 否用户手机 IMEI 号 cid string 否用户网站 cookieid( 注意 :userid imei cid 至少包