top
关闭

开发者登录

错题本API

主要使用场景:错题本相关API

1、错题标签—标签错题数

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

id

必选

Body(json)

string

-

错题本ID

4

gradeid

必选

Body(json)

string

-

年级ID

5

runtime

可选

Body(json)

string

-

执行时间

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

cache

可选

string

-

是否缓存

4

result

可选

json

-

返回结果

4.1

lists

可选

json

-

返回列表

4.1.1

id

可选

int

-

自增长id

4.1.2

name

可选

string

-

名称

4.1.3

isCreate

可选

int

-

是否平台自建(0:非平台自建1:平台自建)

4.1.4

num

可选

int

-

错题数

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/tagnums&access_token=xxxxx&platformcode=xx&personid=xx&id=xx&gradeid=xx

应答报文:
{
    "code": "000000",
    "message": "成功",
    "cache": "false",
    "result": {
    "lists": [
            {
                "id": 1,
                "name": "不错",
                "isCreate": 1,
                "num": 1
            }, {
                "id": 2,
                "name": "很不错",
                "isCreate": 1,
                "num": 1
            }, {
                "id": 3,
                "name": "飒飒",
                "isCreate": 1,
                "num": 1
            }
        ]
    },
    "runtime": "0.07404"
}
						

2、错题—添加备注

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

id

必选

Body(json)

string

-

错题ID

4

remarks

必选

Body(json)

string

-

备注

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

int

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/remarks&access_token=xxxxx&platformcode=xx&personid=xx&id=xx&remarks=xx

应答报文:
{
    "code": "000000",
    "message": "备注成功!",
    "runtime": "0.12073",
    "cache": "false",
    "result": "000000"
}
						

3、错题—我要灭题

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

id

必选

Body(json)

string

-

错题ID

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

int

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/know&access_token=xxxxx&platformcode=xx&personid=xx&id=xx

应答报文:
{
    "code": "000000",
    "message": "灭题成功!",
    "runtime": "0.12073",
    "cache": "false",
    "result": "000000"
}
						

4、错题—上传图片

前置条件

获取接口访问凭证:accessToken

请求说明

url https://opengate.huijiaoyun.com/flawsweeper/openapi/fs/uploadimages
请求方式 POST
格式 json
是否需要鉴权
请求数限制
接口方向 第三方应用>开放平台

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

image

必选

Body(json)

string

-

图片base64编码

返回说明

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

1

code

可选

string

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

string

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

json

-

返回结果

5.1

list

可选

string

-

相对路径

5.2

upload_url

可选

string

-

绝对路径

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/uploadimages&access_token=xxxxx&platformcode=xx&personid=xx

应答报文:
{
    "code": "000000",
    "message": "上传成功!",
    "runtime": "0.12073",
    "cache": "false",
    "result": {
        "list": "888888/2017/09/340445d15293309.jpg",
        "upload_url": "http://flawsweeper.t.huijiaoyun.com/uploads/flawsweeper/images/"
    }
}
						

5、错题本—列表

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

page

必选

Body(json)

string

-

页码

4

pagesize

必选

Body(json)

string

-

每页记录数

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

json

-

返回结果

5.1

page

可选

string

-

5.2

pagesize

可选

string

-

5.3

count

可选

int

-

5.4

lists

可选

json

-

5.4.1

id

可选

string

-

5.4.2

name

可选

string

-

5.4.3

add_time

可选

string

-

5.4.4

last_time

可选

string

-

5.4.5

previews

可选

int

-

5.4.6

rise_nums

可选

int

-

5.4.7

nums

可选

int

-

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/flawsweeper&access_token=xxxxx&platformcode=xx&personid=xx&page=xx&pagesize=xx
应答报文:
{
    "code": "000000",
    "message": "请求成功",
    "runtime": "0.03639",
    "cache": "false",
    "result": {
        "page": "1",
        "pagesize": "10",
        "count": 1,
        "lists": [
            {
                "id": 124,
                "name": "语文",
                "add_time": 1506323754,
                "last_time": 1506323754,
                "previews": 0,
                "rise_nums": 0,
                "nums": 0
            }
        ]
    }
}
						

6、统计—时间内错题数量和灭提数量

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

start

必选

Body(json)

string

-

开始时间可以是时间戳或以下格式20180102

4

end

必选

Body(json)

string

-

结束时间可以是时间戳或以下格式20180103

返回说明

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

1

code

可选

string

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

string

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

string

-

返回结果

5.1

date

可选

string

-

时间

5.2

list

可选

string

-

返回集合

5.2.1

ctsnums

可选

string

-

错题数

5.2.2

name

可选

string

-

错题本名称

5.2.3

mtsnums

可选

string

-

灭题数

5.2.4

flawsweeperId

可选

string

-

错题本id

6

total

可选

string

-

返回结果总统计

6.1

date

可选

string

-

时间

6.2

list

可选

string

-

返回集合

6.2.1

ctsnums

可选

string

-

错题数

6.2.2

name

可选

string

-

错题本名称

6.2.3

mtsnums

可选

string

-

灭题数

6.2.4

flawsweeperId

可选

string

-

错题本id

示例

							请求报文:
{URL}?personid=84afc1929222455188195a8fe0f3a45a&start=20171003&end=20181203
应答报文:
{
code: "000000",
message: "成功",
runtime: "0.01954",
result: {
596: {
ctsnums: 10,
name: "化学"
},
598: {
ctsnums: 9,
name: "英语"
},
599: {
ctsnums: 8,
name: "综合"
},
673: {
ctsnums: 2,
name: "历史"
},
876: {
ctsnums: 11,
name: "语文"
},
883: {
ctsnums: 73,
mtsnums: 1,
name: "数学"
},
951: {
ctsnums: 5,
name: "思想政治"
},
1065: {
ctsnums: 71,
name: "物理"
},
1165: {
ctsnums: 1,
name: "sdds "
}
},
cache: "false"
}
						

7、错题本—编辑

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

name

必选

Body(json)

string

-

错题本名称

4

id

必选

Body(json)

string

-

错题本ID

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

int

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/flawsweeperupdate&access_token=xxxxx&platformcode=xx&personid=xx&name=xx&id=xx

应答报文:
{
    "code": "000000",
    "message": "编辑成功!",
    "runtime": "0.03136",
    "cache": "false",
    "result": "000000"
}
						

8、错题本—新建

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

name

必选

Body(json)

string

-

错题本名称

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

json

-

返回结果

5.1

id

可选

int

-

添加成功返回数据库id

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/flawsweeperadd&access_token=xxxxx&platformcode=xx&personid=xx&name=xx

应答报文:
{
    "code": "000000",
    "message": "添加成功!",
    "runtime": "0.05159",
    "cache": "false",
    "result": {
        "id": "111"
       }
}
						

9、错题本—删除

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

id

必选

Body(json)

string

-

错题本ID

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

int

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/flawsweeperdelete&access_token=xxxxx&platformcode=xx&personid=xx&id=xx

应答报文:
{
    "code": "000000",
    "message": "删除成功!",
    "runtime": "0.12073",
    "cache": "false",
    "result": "000000"
}
						

10、错题—移动到

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

int

-

用户ID

3

id

必选

Body(json)

int

-

错题ID

4

ctb_id

必选

Body(json)

int

-

错题本ID

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

int

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/moveto&access_token=xxxxx&platformcode=xx&personid=xx&id=xx

应答报文:
{
    "code": "000000",
    "message": "移动成功!",
    "runtime": "0.12073",
    "cache": "false",
    "result": "000000"
}
						

11、获取科目新编号

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

返回说明

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

1

code

可选

string

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

string

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

string

-

返回结果

5.1

list

可选

string

-

返回列表

5.1.1

cmsid

可选

string

-

样式

5.1.2

id

可选

string

-

学科id

5.1.3

name

可选

string

-

学科名称

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/configsubject&access_token=xxxxx

应答报文:
{
    "code": "000000",
    "message": "请求成功",
    "runtime": "0.00679",
    "cache": "true",
    "result": {
    "list": [
        {
        "cmsid": "none",
        "id": 1,
        "name": "自定义"
        },
        {
        "cmsid": "jcsub01",
        "id": 2,
        "name": "语文"
        },
        {
        "cmsid": "jcsub02",
        "id": 3,
        "name": "数学"
        },
        {
        "cmsid": "jcsub03",
        "id": 4,
        "name": "英语"
        },
        {
        "cmsid": "jcsub13",
        "id": 5,
        "name": "物理"
        },
        {
        "cmsid": "jcsub14",
        "id": 6,
        "name": "化学"
        },
        {
        "cmsid": "jcsub08",
        "id": 12,
        "name": "思想品德"
        },
        {
        "cmsid": "jcsub11",
        "id": 7,
        "name": "历史"
        },
        {
        "cmsid": "jcsub12",
        "id": 8,
        "name": "地理"
        },
        {
        "cmsid": "jcsub06",
        "id": 13,
        "name": "品德与生活"
        },
        {
        "cmsid": "jcsub07",
        "id": 14,
        "name": "品德与社会"
        },
        {
        "cmsid": "jcsub15",
        "id": 9,
        "name": "生物"
        },
        {
        "cmsid": "jcsub09",
        "id": 10,
        "name": "思想政治"
        },
        {
        "cmsid": "SUB45",
        "id": 11,
        "name": "综合"
        },
        {
        "cmsid": "jcsub10",
        "id": 15,
        "name": "历史与社会"
        },
        {
        "cmsid": "SUB27",
        "id": 16,
        "name": "体育"
        },
        {
        "cmsid": "jcsub16",
        "id": 17,
        "name": "科学"
        },
        {
        "cmsid": "jcsub18",
        "id": 18,
        "name": "美术"
        },
        {
        "cmsid": "jcsub19",
        "id": 19,
        "name": "体育与健康"
        },
        {
        "cmsid": "jcsub20",
        "id": 20,
        "name": "音乐"
        },
        {
						

12、错题标签—给错题打标签

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

name

必选

Body(json)

string

-

本题的全部标签,多个标签用逗号隔开

4

id

必选

Body(json)

string

-

错目ID

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

int

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/tagforadd&access_token=xxxxx&platformcode=xx&personid=xx&name=xx&id=xx

应答报文:
{
    "code": "000000",
    "message": "编辑成功!",
    "runtime": "0.03136",
    "cache": "false",
    "result": "000000"
}
						

13、错题—同步

前置条件

获取接口访问凭证:accessToken

请求说明

url https://opengate.huijiaoyun.com/flawsweeper/openapi/fs/synchronous
请求方式 POST
格式 json
是否需要鉴权
请求数限制
接口方向 第三方应用>开放平台

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

gradeid

必选

Body(json)

string

-

年级ID(根据54制或63制在相关编号接口中取值)

4

titleid

必选

Body(json)

string

-

题目唯一标识,来源方自定义

5

subjectid

必选

Body(json)

string

-

学科ID(相关编号接口有标注)

6

sourceid

必选

Body(json)

string

-

应用来源ID(相关编号接口有标注)

7

sourcetypeid

必选

Body(json)

string

-

内容来源ID(相关编号接口有标注)

8

difficultyid

必选

Body(json)

string

-

难易ID(相关编号接口有标注)

9

typeid

必选

Body(json)

string

-

题目类型ID(相关编号接口有标注)

10

title

必选

Body(json)

string

-

标题,与标题组图必传其一

11

titlepics

可选

Body(json)

string

-

标题组图,与标题必传其一

12

questions

可选

Body(json)

string

-

正确答案

13

contents

可选

Body(json)

string

-

题目内容

14

analyse

可选

Body(json)

string

-

解析内容

15

analysepics

可选

Body(json)

string

-

解析内容图片

16

tags

可选

Body(json)

string

-

题目标签

17

mymark

可选

Body(json)

string

-

我的备注

18

addtime

可选

Body(json)

string

-

错题创建的时间戳

19

myquestions

可选

Body(json)

string

-

我的答案

20

iscreate

可选

Body(json)

string

-

0同步 1平台自建 2应用自建同步

21

myquestionspath

可选

Body(json)

string

-

“我的答案”的图片路径

22

questionspath

可选

Body(json)

string

-

“正确答案”的图片路径

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

string

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/synchronous&access_token=xxxxx

应答报文:
{
    "code": "000000",
    "message": "同步成功",
    "runtime": "0.00053",
    "cache": "false",
    "result": "OK"
}
						

14、错题本—更新浏览量

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

id

必选

Body(json)

string

-

错题本ID

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

int

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/flawsweeperpreviews&access_token=xxxxx&platformcode=xx&personid=xx&id=xx

应答报文:
{
    "code": "000000",
    "message": "更新成功!",
    "runtime": "0.12073",
    "cache": "false",
    "result": "000000"
}
						

15、错题标签—新建

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

name

必选

Body(json)

string

-

标签,多个标签用逗号隔开

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

json

-

返回结果

5.1

ids

可选

int

-

返回添加的id

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/tagadd&access_token=xxxxx&platformcode=xx&personid=xx&name=xx

应答报文:
{
    "code": "000000",
    "message": "添加成功!",
    "runtime": "0.05159",
    "cache": "false",
    "result": {
        "id": "111"
       }
}
						

16、错题标签—删除

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

id

必选

Body(json)

string

-

标签ID

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

int

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/tagdelete&access_token=xxxxx&platformcode=xx&personid=xx&id=xx

应答报文:
{
    "code": "000000",
    "message": "删除成功!",
    "runtime": "0.12073",
    "cache": "false",
    "result": "000000"
}
						

17、错题—自定义难度

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

id

必选

Body(json)

string

-

错题ID

4

d_id

必选

Body(json)

string

-

自定义难度ID

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

int

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/difficulty&access_token=xxxxx&platformcode=xx&personid=xx&id=xx&d_id=xx

应答报文:
{
    "code": "000000",
    "message": "自定义难度成功!",
    "runtime": "0.12073",
    "cache": "false",
    "result": "000000"
}
						

18、错题标签—列表

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

page

可选

Body(json)

string

-

页码,默认1

4

pagesize

可选

Body(json)

string

-

每页记录数,默认10

4.5

runtime

可选

Body(json)

string

-

执行时间

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

cache

可选

string

-

是否缓存

4

result

可选

json

-

返回结果

4.1

page

可选

int

-

当前页码

4.2

pagesize

可选

int

-

当前每页记录数

4.3

count

可选

int

-

总数

4.4

lists

可选

json

-

列表

4.4.1

id

可选

int

-

自增长id

4.4.2

name

可选

int

-

标签名称

4.4.3

isCreate

可选

int

-

是否平台自建(0:非自建1:自建)

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/tag&access_token=xxxxx&platformcode=xx&personid=xx&page=xx&pagesize=xx

应答报文:
{
    "code": "000000",
    "message": "成功",
    "cache": "false",
    "result": {
    "page": 1,
    "pagesize": "15",
    "count": 11,
    "lists": [
            {
                "id": 29,
                "name": "232323",
                "isCreate": 1
            },
            {
                "id": 1,
                "name": "测试标签",
                "isCreate": 0
            }
        ]
    },
    "runtime": "0.07404"
}
						

19、错题—删除

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

id

必选

Body(json)

string

-

错题ID

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

int

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/delete&access_token=xxxxx&platformcode=xx&personid=xx&id=xx

应答报文:
{
    "code": "000000",
    "message": "删除成功!",
    "runtime": "0.12073",
    "cache": "false",
    "result": "000000"
}
						

20、错题—更新

前置条件

获取接口访问凭证:accessToken

请求说明

url https://opengate.huijiaoyun.com/flawsweeper/openapi/fs/topicupdate
请求方式 POST
格式 json
是否需要鉴权
请求数限制
接口方向 第三方应用>开放平台

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

gradeid

必选

Body(json)

string

-

年级ID

4

titleid

必选

Body(json)

string

-

题目唯一标识,来源方自定义

5

fsid

必选

Body(json)

string

-

错题本ID

6

sourceid

必选

Body(json)

string

-

来源应用ID

7

sourcetypeid

必选

Body(json)

string

-

内容来源ID

8

difficultyid

必选

Body(json)

string

-

难易ID

9

typeid

必选

Body(json)

string

-

题目类型ID

10

title

可选

Body(json)

string

-

标题,与标题组图必传其一

11

titlepics

可选

Body(json)

string

-

标题组图,与标题必传其一

12

questions

可选

Body(json)

string

-

正确答案

13

contents

可选

Body(json)

string

-

题目内容

14

analyse

可选

Body(json)

string

-

解析内容

15

analysepics

可选

Body(json)

string

-

解析内容图片

16

tags

可选

Body(json)

string

-

题目标签ID

17

mymark

可选

Body(json)

string

-

我的备注

18

addtime

可选

Body(json)

string

-

错题创建的时间戳

19

myquestions

可选

Body(json)

string

-

我的答案

20

iscreate

可选

Body(json)

string

-

0同步 1平台自建 2应用自建同步

21

myquestionspath

可选

Body(json)

string

-

“我的答案”的图片路径

22

questionspath

可选

Body(json)

string

-

“正确答案”的图片路径

23

fsname

可选

Body(json)

string

-

错题本名称

24

updateid

可选

Body(json)

string

-

错题ID,添加时不传,更新时必传

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

string

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/topicupdate&access_token=xxxxx

应答报文:
{
    "code": "000000",
    "message": "更新成功",
    "runtime": "0.00053",
    "cache": "false",
    "result": "OK"
}
						

21、获取相关编号

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

返回说明

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

1

code

必选

string

-

返回状态

2

message

必选

string

-

返回消息

3

runtime

可选

string

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

json

-

返回结果

5.1

subject

可选

json

-

系统错题本名称集合

5.1.1

id

可选

string

-

系统错题本id对应创建错题本中错题本关联id

5.1.2

name

可选

string

-

名称

5.2

source

可选

string

-

错题应用来源,用于填写错题中的应用来源

5.2.1

id

可选

string

-

应用id

5.2.2

name

可选

string

-

应用名称

5.3

sourcetype

可选

string

-

错题内容来源集合

5.3.1

id

可选

string

-

错题内容来源id

5.3.2

name

可选

string

-

错题内容来源名称

5.4

difficulty

可选

string

-

错题难度集合

5.4.1

id

可选

string

-

错题难度id

5.4.2

name

可选

string

-

错题难易度名称

5.5

type

可选

string

-

错题类型集合

5.5.1

id

可选

string

-

错题类型id

5.5.2

name

可选

string

-

错题类型名称

5.6

grade_63

可选

string

-

63制年级集合

5.6.1

id

可选

string

-

63制年级id

5.6.2

name

可选

string

-

63制年级名称

5.7

grade_54

可选

string

-

54制年级集合

5.7.1

id

可选

string

-

54制年级id

5.7.2

name

可选

string

-

54制年级名称

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=api/OpenFs/config

应答报文:
{
"code": "000000",
"message": "请求成功",
"runtime": "0.00619",
"cache": "true",
"result": {
    "subject": [
        {
        "id": 1,
        "name": "自定义"
        },
        {
        "id": 2,
        "name": "语文"
        },
        {
        "id": 3,
        "name": "数学"
        },
        {
        "id": 4,
        "name": "英语"
        },
        {
        "id": 5,
        "name": "物理"
        },
        {
        "id": 6,
        "name": "化学"
        },
        {
        "id": 12,
        "name": "思想品德"
        },
        {
        "id": 7,
        "name": "历史"
        },
        {
        "id": 8,
        "name": "地理"
        },
        {
        "id": 13,
        "name": "品德与生活"
        },
        {
        "id": 14,
        "name": "品德与社会"
        },
        {
        "id": 9,
        "name": "生物"
        },
        {
        "id": 10,
        "name": "思想政治"
        },
        {
        "id": 11,
        "name": "综合"
        },
        {
        "id": 15,
        "name": "历史与社会"
        },
        {
        "id": 16,
        "name": "体育"
        },
        {
        "id": 17,
        "name": "科学"
        },
        {
        "id": 18,
        "name": "美术"
        },
        {
        "id": 19,
        "name": "体育与健康"
        },
        {
        "id": 20,
        "name": "音乐"
        },
        {
        "id": 21,
        "name": "信息技术"
        },
        {
        "id": 22,
        "name": "通用技术"
        },
        {
        "id": 23,
        "name": "综合实践活动"
        },
        {
        "id": 24,
        "name": "健康(学前)"
        },
        {
        "id": 25,
        "name": "科学(学前)"
        },
        {
        "id": 26,
        "name": "社会(学前)"
        },
        {
        "id": 27,
        "name": "艺术(学前)"
        },
        {
        "id": 28,
        "name": "语言(学前)"
        },
        {
        "id": 29,
        "name": "科技制作活动"
        },
        {
        "id": 30,
     
						

22、错题—列表

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

platformcode

必选

Body(json)

int

-

平台编码

2

personid

必选

Body(json)

int

-

用户ID

3

flawsweeperid

必选

Body(json)

int

-

错题本ID

4

page

可选

Body(json)

int

-

页码,默认1

5

pagesize

可选

Body(json)

string

-

每页记录数,默认10

6

isknow

可选

Body(json)

int

-

1:掌握 0未掌握

7

title

可选

Body(json)

int

-

标题关键字

8

gradeid

可选

Body(json)

int

-

年级ID

9

sid

可选

Body(json)

int

-

来源应用ID,见接口相关编号

10

stid

可选

Body(json)

string

-

内容来源ID,见接口相关编号

11

did

可选

Body(json)

int

-

难易ID,见接口相关编号

12

tagid

可选

Body(json)

int

-

标签ID

13

sstid

可选

Body(json)

string

-

题目类型ID,见接口相关编号

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

json

-

返回结果

5.1

lists

可选

json

-

返回列表

5.1.01

id

可选

int

-

唯一标识id

5.1.02

gradeId

可选

int

-

年级

5.1.03

titleid

可选

string

-

非平台错题唯一标识

5.1.04

sourceId

可选

int

-

来源应用id

5.1.05

sourceTypeId

可选

int

-

内容来源id

5.1.06

difficultyId

可选

int

-

难度

5.1.07

subjectTypeId

可选

int

-

错题类型id

5.1.08

subjectName

可选

string

-

题目

5.1.09

subjectNamepath

可选

int

-

题目附带图片

5.1.10

questions

可选

int

-

正确答案

5.1.11

CorrectAnalysis

可选

int

-

正确解析

5.1.12

CorrectAnalysispath

可选

int

-

正确解析图片

5.1.13

tags

可选

int

-

标签id多个逗号隔开

5.1.13.1

id

可选

string

-

标签id

5.1.13.2

name

可选

string

-

标签名称

5.1.14

Remarks

可选

int

-

我的备注

5.1.15

addTime

可选

int

-

创建时间(时间戳)

5.1.16

myquestions

可选

string

-

我的答案

5.1.17

isCreate

可选

int

-

0非平台自建,1平台自建

5.1.18

isknow

可选

int

-

是否掌握,0未掌握 1掌握

5.1.19

flawsweeperId

可选

int

-

错题本id

5.1.20

contents

可选

json

-

选项内容

5.1.20.1

options

可选

string

-

选项名称

5.1.20.2

yess

可选

int

-

是否是正确答案,1正确,0错误

5.1.20.3

orderby

可选

int

-

排序

5.1.21

myquestionspath

可选

string

-

我的答案图片路径

5.1.22

questionspath

可选

string

-

正确答案图片路径

5.2

page

可选

int

-

页码

5.3

pagesize

可选

int

-

每页记录数

5.4

count

可选

int

-

总数

5.5

hosts

可选

string

-

平台域名

10

pic_url

可选

string

-

平台图片路径

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/lists&access_token=xxxxx&platformcode=xx&personid=xx&flawsweeperid=xx&page=xx&pagesize=xx&isknow=xx&title=xx&gradeid=xx&sid=xx&stid=xx&did=xx&tagid=xx
应答报文:
{
    "code": "000000",
    "message": "请求成功",
    "runtime": "0.03639",
    "cache": "false",
    "result": {
        "page": "1",
        "pagesize": "10",
        "count": 1,
        "hosts": "http:\/\/flawsweeper.t.huijiaoyun.com\/",
        "pic_url": "http:\/\/flawsweeper.t.huijiaoyun.com\/uploads\/flawsweeper\/images\/",
        "lists": [
            {
                "id": 1363,
                "gradeId": 8,
                "titleid": "16A5407473AA4A56B14A3234928CB5E8",
                "sourceId": 10,
                "sourceTypeId": null,
                "difficultyId": 1,
                "subjectTypeId": 3,
                "subjectName": "这个题难吗?",
                "subjectNamepath": null,
                "questions": null,
                "CorrectAnalysis": null,
                "CorrectAnalysispath": "",
                "tags": "",
                "Remarks": "",
                "addTime": 1463439872,
                "myquestions": "A",
                "isCreate": 0,
         
						

23、错题—批量同步

前置条件

获取接口访问凭证:accessToken

请求说明

url https://opengate.huijiaoyun.com/flawsweeper/openapi/fs/batchsynchronous
请求方式 POST
格式 json
是否需要鉴权
请求数限制
接口方向 第三方应用>开放平台

参数说明

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

1

platformcode

必选

Body(json)

string

-

平台编码

2

personid

必选

Body(json)

string

-

用户ID

3

gradeid

必选

Body(json)

string

-

年级ID

4

titleid

必选

Body(json)

string

-

题目唯一标识,来源方自定义

5

subjectid

必选

Body(json)

string

-

学科ID

6

sourceid

必选

Body(json)

string

-

来源应用ID

7

sourcetypeid

必选

Body(json)

string

-

内容来源ID

8

difficultyid

必选

Body(json)

string

-

难易ID

9

typeid

必选

Body(json)

string

-

题型ID

10

title

可选

Body(json)

string

-

标题,与标题组图必传其一

11

titlepics

可选

Body(json)

string

-

标题组图,与标题必传其一

12

questions

可选

Body(json)

string

-

正确答案

13

contents

可选

Body(json)

string

-

题目内容

14

analyse

可选

Body(json)

string

-

解析内容

15

analysepics

可选

Body(json)

string

-

解析内容图片

16

tags

可选

Body(json)

string

-

题目标签

17

mymark

可选

Body(json)

string

-

我的备注

18

addtime

可选

Body(json)

string

-

错题创建的时间戳

19

myquestions

可选

Body(json)

string

-

我的答案

20

iscreate

可选

Body(json)

string

-

0同步 1平台自建 2应用自建同步

21

myquestionspath

可选

Body(json)

string

-

“我的答案”的图片路径

22

questionspath

可选

Body(json)

string

-

“正确答案”的图片路径

返回说明

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

1

code

可选

int

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

int

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

string

-

返回结果

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/batchsynchronous&access_token=xxxxx
应答报文:
{
    "code": "000000",
    "message": "同步成功",
    "runtime": "0.00053",
    "cache": "false",
    "result": "OK"
}
						

24、错题—详情

前置条件

获取接口访问凭证:accessToken

请求说明

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

参数说明

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

1

id

必选

Body(json)

string

-

错题ID

2

platformcode

必选

Body(json)

string

-

平台编码

3

personid

必选

Body(json)

string

-

用户ID

返回说明

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

1

code

可选

string

-

返回状态

2

message

可选

string

-

返回消息

3

runtime

可选

string

-

执行时间

4

cache

可选

string

-

是否缓存

5

result

可选

json

-

返回结果集

5.1

list

可选

string

-

内容集合

5.1.01

id

可选

string

-

唯一标识id

5.1.02

gradeid

可选

string

-

年级id

5.1.03

titleid

可选

string

-

非平台错题唯一标识

5.1.05

sourceid

可选

string

-

来源应用ID

5.1.06

sourcetypeid

可选

string

-

内容来源ID

5.1.07

difficultyid

可选

string

-

难度id

5.1.08

typeid

可选

string

-

题目类型ID

5.1.09

title

可选

string

-

标题

5.1.10

titlepics

可选

string

-

标题图片

5.1.11

questions

可选

string

-

正确答案

5.1.12

contents

可选

string

-

选项集合

5.1.12.1

options

可选

string

-

选项

5.1.12.2

yess

可选

string

-

是否正确答案

5.1.12.3

orderby

可选

string

-

排序

5.1.13

analyse

可选

string

-

解析内容

5.1.14

analysepics

可选

string

-

解析内容图片

5.1.15

tags

可选

string

-

题目标签

5.1.15.1

id

可选

string

-

标签id

5.1.15.2

name

可选

string

-

标签名称

5.1.16

mymark

可选

string

-

我的备注

5.1.17

addtime

可选

string

-

错题创建的时间戳

5.1.18

myquestions

可选

string

-

我的答案

5.1.19

iscreate

可选

string

-

0同步 1平台自建 2应用自建同步

5.1.20

isknow

可选

string

-

1:掌握 0未掌握

5.1.21

flawsweeperid

可选

string

-

错题本ID

5.1.22

myquestionspath

可选

string

-

“我的答案”的图片路径

5.1.23

questionspath

可选

string

-

“正确答案”的图片路径

5.2

hosts

可选

string

-

错题本平台地址

示例

							请求报文:
http://flawsweeper.t.huijiaoyun.com/index.php?r=openapi/fs/info&access_token=xxxxx&id=xx&platformcode=xx&personid=xx

应答报文:
{
    "code": "000000",
    "message": "请求成功",
    "runtime": "0.03639",
    "cache": "false",
    "result": {
        "page": "1",
        "pagesize": "10",
        "count": 1,
        "lists": [
            {
            "id": 6,
            "gradeid" : "年级ID",
            "titleid" : "题目唯一标识",
            "subjectid" : "学科ID",
            "sourceid" : "来源方ID",
            "sourcetypeid" : "来源方类型ID",
            "difficultyid" : "难易ID",
            "typeid" : "题型ID",
            "title" : "标题",
            "titlepics" : {"1.jpg","2.jpg"},
            "questions" : "正确答案",
            "contents" : {"1":"选项1","2":"选项2"},
            "analyse " : "解析内容",
            "analysepics" : "解析内容",
            "tags" : "题目标签",
            "mymark" : "我的备注",
            "addtime" : "错题创建的时间戳",
            }
        ]
    }
}
						

参数说明

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

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

消息体的关键字对应的值