简介
| 接口简介 |
| URL |
申请后成功的URL |
| 返回格式 |
json |
| 请求方式 |
GET |
| 权限控制 |
需提交申请 |
参数说明
| 参数名 |
类型 |
是否必须 |
描述 |
| appid |
string |
是 |
申请成功后的开放平台接口管理中的APPID |
| secretkey |
string |
是 |
根据申请成功后的APPKEY，通过加密共识计算得到secretkey。加密公式：secretkey ＝ sha1(md5(app_key) + nonce + timestamp) |
| timestamp |
int |
是 |
时间戳，单位为秒。指格林威治事件1970年01月01日00时00分00秒（北京时间1970年01月01日08时00分00秒）起至现在的总秒数。 |
| nonce |
string |
是 |
随机字符串 |
| channel |
string |
是 |
频道信息，例如，体育、财经。具体可使用的频道在开放平台-应用设置中配置。 |
| offset |
int |
否 |
offset初始为0，之后的每次请求时offset=offset+count。 |
| count |
int |
否 |
请求的文章数，一次请求最多20条 |
| return_delete |
string |
否 |
return_delete=true则返回上次请求到本次请求这段时间内被删除的文章，return_delete=false或者不加此字段则不返回删除文章，删除文章的描述见删除文章字段 |
返回值
| 参数名 |
类型 |
描述 |
| status |
string |
请求成功时返回success，失败时返回fail |
| code |
int |
错误码，成功时返回0 |
| reason |
string |
错误原因，code!=0时，一定包含此字段 |
| result |
json Array |
卡片列表数组，包括新闻、视频两种类型的卡片 |
(1)新闻卡片字段
| 参数名 |
类型 |
是否必需 |
描述 |
| ctype |
string |
是 |
卡片类型，news |
| title |
string |
是 |
标题 |
| docid |
string |
是 |
文章id |
| url |
string |
是 |
链接 |
| date |
string |
是 |
发布时间 |
| images |
json array |
是 |
图片列表 |
| source |
string |
是 |
来源 |
| summary |
string |
是 |
文章摘要 |
| category |
string array |
是 |
文章类别 |
| media_name |
string |
否 |
自媒体作者名称 |
| media_pic |
string |
否 |
自媒体作者头像 |
示例：
{
"docid": "0JARm4vO",
"url": "http://pandora.yidianzixun.com:3081/article/0JARm4vO?s=meiyou&appid=meiyou_web",
"share_url": "http://pandora.yidianzixun.com:3081/article/0JARm4vO?s=meiyou&appid=meiyou_web&yd_share=1",
"date": "2018-05-29 13:15:25",
"title": "新款小米笔记本Pro上架：八代i5+8G内存 到手价4999元",
"images": ["http://i1.go2yd.com/corpimage.php?url=0JARm48bV2&type=_180x120&source=meiyou"],
"source": "快科技",
"ctype": "news",
"summary": "外观方面，新款小米笔记本Pro采用了15.6英寸1080P显示屏，拥有170°广视角，300尼特亮度，机身三围尺寸为360.7×243.6×15.9mm，重1.95kg，支持140°开合。",
"media_pic": "http://si1.go2yd.com/get-image/0EPiPrL211U",
"media_name": "快科技",
"category": ["科技"]
}
(2)视频卡片字段
| 参数名 |
类型 |
是否必需 |
描述 |
| ctype |
String |
是 |
卡片类型，video |
| title |
string |
是 |
标题 |
| docid |
string |
是 |
文章id |
| url |
string |
是 |
链接 |
| date |
string |
是 |
发布时间 |
| images |
json array |
是 |
图片列表 |
| source |
string |
是 |
来源 |
| summary |
string |
是 |
文章摘要 |
| category |
string array |
是 |
文章类别 |
| media_name |
string |
否 |
自媒体作者名称 |
| media_pic |
string |
否 |
自媒体作者头像 |
示例：
{
"docid": "V_01cxMuKW",
"url": "http://pandora.yidianzixun.com:3081/article/V_01cxMuKW?s=meiyou&appid=meiyou_web",
"share_url": "http://pandora.yidianzixun.com:3081/article/V_01cxMuKW?s=meiyou&appid=meiyou_web&yd_share=1",
"date": "2018-05-23 00:49:06",
"title": "考试前VS考试时……",
"images": ["http://i1.go2yd.com/corpimage.php?url=V_01cxMuWExB&type=_180x120&source=meiyou"],
"source": "快手",
"ctype": "video",
"summary": "",
"media_pic": "http://si1.go2yd.com/get-image/0DaaMc15pZI",
"media_name": "快手",
"duration": 20,
"category": ["搞笑"]
}
错误码说明
| 错误代码 |
错误原因 |
说明 |
| 0 |
无 |
成功返回 |
| 10 |
缺少参数 |
缺少必须的参数 |
| 23 |
认证失败 |
secretkey错误 |
| 24 |
时间戳非法 |
时间戳格式错误，或者不是当前的时间 |
| 28 |
请求超出最大Q PS |
每秒的请求量大于10个 |
| 30 |
应用状态不正 确 |
应用申请没有通过，或者已经关闭 |
| 31 |
应用不存在 |
appid错误，找不到对应的应用 |
(3)删除文章字段
| 参数名 |
类型 |
是否必须 |
描述 |
| docid |
string |
是 |
文章id |
| status |
string |
是 |
status=delete |
| deleteTime |
int |
是 |
文章删除的时间戳 |