API接入常见问题

  1. Q : 推荐接口中出本地的资讯,或者单独有个“本地”频道怎么办?

    A : 需要客户自己上报内容带地域信息,同时在请求推荐接口时带上用户所在城市;同理,如果需要有“本地”频道,也是类似。

  2. Q : 需要单独有个“视频”频道怎么办?

    A : 还是调用"推荐接口",增加请求参数res_type=video

  3. Q : 推荐接口和频道接口拉取条数有限制吗?

    A : 最大30条。如果拉取条数太多,会有不少的资讯根本就没有在屏幕上展示。而犀光推荐引擎是根据用户已经下发过的资讯做去重。造成的结果就是有不少资讯没有机会展示在用户屏幕,被浪费掉了。所以建议每次刷新10条。

  4. Q : 有时候接口获取不到资讯数据,是怎么回事?

    A : 可能的原因:1. 资源内容数量较少,刷多了就没有了。因为下发过的资讯不会再次下发。如有特殊需求,请联系犀光开发人员。2. 配置未生效或错误,请找犀光开发人员。 3. 上报数据还没有入库。

  5. Q : 怎么避免接口没有数据时,端上空白?

    A : 建议端上缓存最后一次刷新获取到的数据,在接口没有数据返回时,用缓存数据展示。同时提示“今天没有更多内容了,请稍后重试”,优化用户体验。

  6. Q : 端上展现反馈一定要上报吗?

    A : 最好将用户屏幕上展示过的资讯内容上报犀光,用于推荐策略。如果短期内改动较大,可以不上报,下一次版本迭代时把这个功能规划进去。

  7. Q : 端上列表的点击反馈一定要上报吗?

    A : 一定。

  8. Q : 上报反馈数据经常报错。

    A : 文档中有比较详细的说明。特别要注意必有字段以及类型。特别是整形的,不要上传数字字符串。另外,注意post的content-type。