正确返回:
{
"status": "success",
"data": {
"id": "5b8b9572e116fb3714e6faba",
"content": "君问归期未有期,巴山夜雨涨秋池。",
"popularity": 1170000,
"origin": {
"title": "夜雨寄北",
"dynasty": "唐代",
"author": "李商隐",
"content": [
"君问归期未有期,巴山夜雨涨秋池。",
"何当共剪西窗烛,却话巴山夜雨时。"
],
"translate": [
"您问归期,归期实难说准,巴山连夜暴雨,涨满秋池。",
"何时归去,共剪西窗烛花,当面诉说,巴山夜雨况味。"
]
},
"matchTags": [
"秋",
"晚上"
],
"recommendedReason": "",
"cacheAt": "2018-09-17T21:18:44.693645"
},
"token": "6453911a-9ad7-457e-9b9d-c21011b85a0c",
"ipAddress": "162.248.93.154"
}
其中
data.content 是核心,即推荐的诗句
data.matchTags 是与你相关的标签,也是推荐给你的部分理由。
data.recommendedReason 是推荐原因,暂未支持。
data.cacheAt 是指我们会对每个 Token 进行预生成推荐数据并缓存。正常情况下我们会10分钟更新一次缓存数据。
data.popularity 是我们对这句诗的流行度评价
data.origin 源诗信息
data.origin.translate 是整诗翻译,部分诗词有,部分没有
token 是当前用户的 token ,原则上,同一个用户,一段时间内 Token 应该不变。
ipAddress 是当前用户的 ip ,如果 IP 有异常,您需要查明您是否在服务端调用
错误返回:
{
"status": "error",
"errCode": 2001,
"errMessage": "No matching handler"
}
errcode 是错误码,目前只有以下几种错误码,您也简单判断 HTTP 头中的状态码,对于错误返回,我们总不会返回 200
1001 :内部服务器错误,HTTP状态码 500
1002 :API路径不对,HTTP状态码 404
2002 :Token不是服务器签发,HTTP状态码 400
2003 :IP超过每日新用户限制,HTTP状态码 400,这很有可能是您没有正确保存 Cookies 或者 Token