top
关闭

开发者登录

主要使用场景:

1、动态-列表

前置条件

获取接口访问凭证: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"
	}
}
											

参数说明

请求参数消息体-link类
序号 字段名 约束 类型 长度 说明

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"
	}
}
											

参数说明

请求参数消息体-oa类
序号 字段名 约束 类型 长度 说明

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

消息体的关键字对应的值