top
关闭

开发者登录

主要使用场景:

1、文章-我的文章

前置条件

获取接口访问凭证:accessToken

请求说明

url https://opengate.huijiaoyun.com/openapi/post/mine?accessToken=******
请求方式 GET
格式 json
是否需要鉴权
请求数限制
接口方向 第三方应用>开放平台

参数说明

序号 字段名 约束 位置 类型 长度 说明

1

type

可选

Body(json)

string

-

类型 template(美文)

2

userid

必选

Body(json)

string

-

用户编号

3

categoryid

可选

Body(json)

int

-

文章分类

4

page

可选

Body(json)

int

-

页码

5

pagesize

可选

Body(json)

int

-

返回数量

6

keyword

可选

Body(json)

string

-

标题关键词

7

from_type

可选

Body(json)

string

-

来源 wap (移动端)

8

original

可选

Body(json)

int

-

原创 1(原创)

返回说明

序号 字段名 约束 类型 长度 说明

1

code

可选

string

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

string

-

返回速度

4

result

可选

string

-

返回结果

4.1

categorytitle

可选

string

-

分类标题

4.2

total

可选

string

-

文章总数

4.3

list

可选

string

-

文章列表

4.3.1

id

可选

string

-

文章id

4.3.2

userid

可选

string

-

用户id

4.3.3

username

可选

string

-

用户昵称

4.3.4

organizationid

可选

string

-

机构id

4.3.5

classid

可选

string

-

班级id

4.3.6

title

可选

string

-

文章标题

4.3.7

content

可选

string

-

文章内容

4.3.8

categoryid

可选

string

-

文章分类id

4.3.9

article_category_id

可选

string

-

4.3.10

publishid

可选

string

-

4.3.11

parentid

可选

string

-

4.3.12

paperid

可选

string

-

4.3.13

copyid

可选

string

-

4.3.14

type

可选

string

-

类型

4.3.15

external_type

可选

string

-

外部类型

4.3.16

tags

可选

string

-

标签

4.3.17

datetime

可选

string

-

添加时间

4.3.18

updatetime

可选

string

-

更新时间

4.3.19

searchtime

可选

string

-

最后查看时间

4.3.20

status

可选

string

-

阅读状态

4.3.21

copy_status

可选

string

-

转载状态

4.3.22

comment_status

可选

string

-

评论状态

4.3.23

comment_count

可选

string

-

评论总数

4.3.24

view_count

可选

string

-

阅读数

4.3.25

like_count

可选

string

-

喜欢数

4.3.26

copy_count

可选

string

-

转载数

4.3.27

favorite_count

可选

string

-

收藏数

4.3.28

child_count

可选

string

-

4.3.29

resource

可选

string

-

4.3.30

istop

可选

string

-

是否置顶

4.3.31

isdel

可选

string

-

是否删除

4.3.32

reply_status

可选

string

-

回复状态

4.3.33

operate

可选

string

-

4.3.34

issnspost

可选

string

-

4.3.35

isPrivate

可选

string

-

是否私密文章

4.3.36

credit

可选

string

-

学分

4.3.37

experience

可选

string

-

经验

4.3.38

password

可选

string

-

4.3.39

publisher

可选

string

-

4.3.40

original_type

可选

string

-

原始类型

4.3.41

original_type_url

可选

string

-

原始类型地址

4.3.41

studyphase

可选

string

-

4.3.42

majorsubjectid

可选

string

-

4.3.43

majorsubjectname

可选

string

-

4.3.44

usertype

可选

string

-

用户类型

4.3.45

platformCode

可选

string

-

平台码

4.3.46

shareid

可选

string

-

4.3.47

commendlevel

可选

string

-

4.3.48

areacode

可选

string

-

区域码

4.3.49

hasPicture

可选

string

-

是否有图片

4.3.50

issharepost

可选

string

-

是否分享文章

4.3.51

objectid

可选

string

-

4.3.52

taskId

可选

string

-

4.3.53

from_type

可选

string

-

来源类型

4.3.54

from_move

可选

string

-

4.3.55

has_add_credit

可选

string

-

是否增加学分

4.3.56

templateid

可选

string

-

模板id

4.3.57

musicid

可选

string

-

背景音乐id

4.3.58

cover

可选

string

-

封面

4.3.59

source

可选

string

-

资源地址

示例

							请求报文:
http://opengate.t.huijiaoyun.com/openapi/post/mine?accessToken=******&userid=******

应答报文:
{"code":"000000","message":"请求成功","runtime":"0.35313","result":{"categorytitle":"全部文章","total":169,"list":[{"id":1611612785,"userid":"eab92753997b41d49032fa104b78c6a6","username":"滕老师","organizationid":"cbaa19e76e524c48a0cc10173205137f","classid":null,"title":"初三物理理论知识","content":"

\"image\"初三物理理论知识,概念介绍;
<\/p>","categoryid":2597959,"article_category_id":null,"publishid":0,"parentid":null,"paperid":0,"copyid":null,"type":"post","external_type":"public","tags":"学无止","datetime":1426579188,"updatetime":1486707652,"searchtime":"2017-12-11 16:21:44","status":"publish","copy_status":"close","comment_status":"close","comment_count":0,"view_count":39,"like_count":1,"copy_count":null,"favorite_count":0,"child_count":null,"resource":"","istop":1472026683,"isdel":null,"reply_status":null,"operate":null,"issnspost":null,"isPrivate":null,"credit":0,"experience":0,"password":"","publisher":null,"original_type":null,"original_type_url":null,"studyphase":"0","majorsubjectid":"jcsub30","majorsubjectname":"劳动技术","usertype":"1","platformCode":"888888","shareid":null,"commendlevel":null,"areacode":"420106","hasPicture":null,"issharepost":null,"objectid":null,"taskId":null,"from_type":null,"from_move":null,"has_add_credit":null,"templateid":null,"musicid":null,"cover":null,"source":null},{"id":1611612962,"userid":"eab92753997b41d49032fa104b78c6a6","username":"滕老师","organizationid":"cbaa19e76e524c48a0cc10173205137f","classid":null,"title":"163618_学无止境.doc","content":"

学无止境<\/p>","categoryid":2597959,"article_category_id":null,"publishid":0,"parentid":null,"paperid":0,"copyid":null,"type":"post","external_type":"public","tags":"学无","datetime":1426583068,"updatetime":1472023367,"searchtime":"2017-02-16 17:36:38","status":"publish","copy_status":"close","comment_status":"close","comment_count":0,"view_count":40,"like_count":1,"copy_count":null,"favorite_count":1,"child_count":null,"resource":
						

参数说明

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

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

消息体的关键字对应的值