主要使用场景:
获取接口访问凭证:accessToken
url | https://opengate.huijiaoyun.com/openapi/trends/list?accessToken=****** |
请求方式 | GET |
格式 | json |
是否需要鉴权 | 是 |
请求数限制 | 否 |
接口方向 | 第三方应用>开放平台 |
序号 | 字段名 | 约束 | 位置 | 类型 | 长度 | 说明 |
---|---|---|---|---|---|---|
1 |
userid |
必选 |
Body(json) |
string |
- |
查询者的用户id(wap_person、wap_related、wap_friend、wap_teacher、wap_msg、wap_attention时必传) |
2 |
usertype |
必选 |
Body(json) |
string |
- |
查询者的用户类型,0学生,1老师,2家长 |
3 |
orgid |
可选 |
Body(json) |
string |
- |
查询者的用户学校id |
4 |
classid |
可选 |
Body(json) |
string |
- |
查询者的用户班级id |
5 |
otherinfo |
可选 |
Body(json) |
string |
- |
是否获取被查询者用户的其它关联信息(学校,背景图等等),1是,0否,默认0 |
6 |
startid |
可选 |
Body(json) |
string |
- |
查询的起始id,默认0,无起始点 |
7 |
type |
必选 |
Body(json) |
string |
- |
查询的类型,wap_person客户端个人动态,wap_related客户端与我相关,wap_school客户端学校动态,wap_class客户端班级动态,wap_friend客户端好友动态,wap_teacher客户端用户可见范围内的老师动态,wap_msg客户端说说动态,wap_attention客户端用户关注人的动态 |
8 |
spaceuserid |
可选 |
Body(json) |
string |
- |
被查询者的用户id,看他人动态时必传 |
9 |
cpagesize |
可选 |
Body(json) |
string |
- |
每条动态查询的评论数量,默认10 |
10 |
pagesize |
可选 |
Body(json) |
string |
- |
查询的数量,默认10 |
序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
---|---|---|---|---|---|
1 |
code |
可选 |
string |
- |
返回状态 |
2 |
runtime |
可选 |
string |
- |
返回速度 |
3 |
result |
可选 |
string |
- |
返回结果 |
3.1 |
id |
可选 |
string |
- |
动态id |
3.2 |
type |
可选 |
string |
- |
动态动作类型(发布个人文章1001,转载文章1002) |
3.3 |
objecttype |
可选 |
string |
- |
动态对象类型(规定文章对象类型为1000) |
3.4 |
objectid |
可选 |
string |
- |
业务动作id(发布文章时的id) |
3.5 |
objectpid |
可选 |
string |
- |
业务动作分类id(发布文章时的文章分类id) |
3.6 |
comment_id |
可选 |
string |
- |
被评论、回复的评论id(动态是由评论产生的) |
3.7 |
user_img |
可选 |
string |
- |
动态主体的用户头像 |
3.8 |
user_name |
可选 |
string |
- |
动态主体的用户姓名 |
3.9 |
user_type |
可选 |
string |
- |
动态主体的用户类型(0学生,1老师,2家长等等) |
3.10 |
user_id |
可选 |
string |
- |
动态主体的用户id |
3.11 |
content |
可选 |
string |
- |
业务文字内容(比如文章内容) |
3.12 |
title |
可选 |
string |
- |
业务文字标题(比如《父亲的手》) |
3.13 |
is_commont |
可选 |
string |
- |
动态的展示状态(1公开,0私有) |
3.14 |
typename |
可选 |
string |
- |
业务划分(post文章类型,photo相册类型,res资源类型,msg说说类型) |
3.15 |
url_web |
可选 |
string |
- |
web业务连接地址 |
3.16 |
is_del |
可选 |
string |
- |
是否有删除权限 |
3.17 |
is_report |
可选 |
string |
- |
是否有举报权限 |
3.18 |
power |
可选 |
string |
- |
动态权限范围(1公开,2好友,3私密) |
3.19 |
power_msg |
可选 |
string |
- |
动态权限文字说明 |
3.20 |
action_title |
可选 |
string |
- |
动作描述标题(转发了xx的动态) |
3.21 |
url |
可选 |
string |
- |
wap业务连接地址 |
3.22 |
show_startid |
可选 |
string |
- |
是否为衍生动态(true和false,非原生的都属于) |
3.23 |
pubdate |
可选 |
string |
- |
动态友好时间格式 |
3.24 |
pubdate_time |
可选 |
string |
- |
动态时间戳 |
3.25 |
show_form |
可选 |
string |
- |
动态来自哪里 |
3.26 |
comment_list |
可选 |
string |
- |
评论列表 |
3.27 |
comment_num |
可选 |
string |
- |
评论数 |
3.28 |
show_praise |
可选 |
string |
- |
是否可以点赞(true和false) |
3.29 |
praise_num |
可选 |
string |
- |
点赞数 |
3.30 |
show_forward |
可选 |
string |
- |
是否可以转载(true和false) |
3.31 |
show_forward_code |
可选 |
string |
- |
不可转载的描述码(200000限制类动态,不能转发;200001原动态是自己所发,不能转发;200003非公开类型动态,不能转发) |
请求报文: http://opengate.t.huijiaoyun.com/openapi/trends/list?accessToken=b61e79d4d3e840be893eacb69777f95d&userid=xxx&usertype=x&type=xx 应答报文: { "code": "000000", "message": "success", "result": [ { "id": 594868, "type": 1001, "objecttype": 1000, "objectid": "1611662453", "objectpid": "2668480", "comment_id": 0, "user_img": "http://www.t.huijiaoyun.com/uploads/avatar/data/32/53/3187e743e6d044e7b3bba47bebd33707_45x45.jpg?1488763530", "user_name": "马骏", "user_type": 1, "user_id": "3187e743e6d044e7b3bba47bebd33707", "url": "http://www.t.huijiaoyun.com//index.php?r=space/person/post/view&sid=3187e743e6d044e7b3bba47bebd33707&id=1611662453", "is_del": false, "is_report": true, "power_msg": "公开", "action_title": "发表了文章", "show_startid": false, "typename": "post", "content": "经常才能烦恼那些你休息吧我好吃你猜那些年息怒息怒", "title": "好方法就到家", "img_list": [ { "src": "http://www.t.huijiaoyun.com/uploads/170x170/post/wap/2017/05/02/1493688654_66938.jpg", "big_src": "http://www.t.huijiaoyun.com/uploads/post/wap/2017/05/02/1493688654_66938.jpg" } ], "pubdate": "昨天09:43", "pubdate_time": 1493689393, "show_form": "文章", "comment_num": 0, "is_commont": 1, "show_praise": true, "praise_num": 0, "show_forward": true, "forward_num": 0 } ], "runtime": "0.01751", "info":{"orgName":"第一中学","orgId":"2","userIcon":"http://.....","userId":"111","userType":"1","userGender":"1","divImg":"http://.....","divTheme":"theme1",} }
序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
---|---|---|---|---|---|
1 |
msgType |
必选 |
String |
10 |
消息类型,此时固定为:text |
1.1 |
text |
必选 |
Json |
- |
text消息体 |
1.1.1 |
content |
必选 |
String |
消息内容 |
{ "msgtype": "text", "text": { "content": "zhxy msg text test 12" } }
序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
---|---|---|---|---|---|
1 |
msgType |
必选 |
String |
10 |
消息类型,此时固定为:link |
2 |
link |
必选 |
Json |
- |
link消息体 |
2.1 |
pcUrl |
必选 |
String |
PC端消息点击链接地址 |
|
2.2 |
appUrl |
必选 |
String |
移动客户端点击消息时跳转到的H5地址 |
|
2.3 |
title |
必选 |
String |
消息标题 |
|
2.4 |
busiId |
必选 |
String |
对应业务的id |
|
2.5 |
content |
必选 |
String |
消息描述 |
|
2.6 |
picUrl |
必选 |
String |
图文消息的图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80。如不填,在客户端不显示图片 |
{ "msgtype": "link", "link": { "pcUrl": "http://www.baidu.com", "appUrl": "http://www.baidu.com", "picUrl": "http://xxx.yyy.com/zzz.jpg", "content": "百度一下", "title": "百度", "busiId":"AQWER1234" } }
序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
---|---|---|---|---|---|
1 |
msgType |
必选 |
String |
10 |
消息类型,此时固定为:oa |
2 |
busiId |
必选 |
String |
- |
该条oa消息在业务系统对应的id |
3 |
pcUrl |
必选 |
String |
消息点击链接地址 |
|
4 |
appUrl |
必选 |
String |
移动客户端点击消息时跳转到的H5地址 |
|
5 |
oa |
必选 |
Json |
- |
oa类型消息体 |
5.1 |
head |
必选 |
Json |
255 |
消息头部Json |
5.1.1 |
text |
必选 |
String |
255 |
消息的头部标题 |
5.1.2 |
bgColor |
可选 |
String |
消息头部的背景颜色。长度限制为8个英文字符,其中前2为表示透明度,后6位表示颜色值。不要添加0x。默认值:FFCC0000 |
|
5.2 |
body |
可选 |
Json |
消息体 |
|
5.2.1 |
title |
可选 |
String |
消息体的标题 |
|
5.2.2 |
content |
可选 |
String |
消息体的正文 |
|
5.2.3 |
imageUrl |
可选 |
String |
消息体中的图片url |
|
5.2.4 |
fileCount |
可选 |
String |
自定义的附件数目。此数字仅供显示,不作验证 |
|
5.2.5 |
author |
可选 |
String |
自定义的作者名字 |
|
5.2.6 |
form |
可选 |
Json数组 |
消息体的表单,最多6个 |
|
5.2.7 |
key |
可选 |
String |
消息体的关键字 |
|
5.2.8 |
value |
可选 |
String |
消息体的关键字对应的值 |