龙岩市教育公共服务平台

服务中心

>网站首页>对接文档>内容详情
热门资讯

龙岩市教育数据共享服务平台-平台网盘接口调用v1

发布时间： 2022-10-12 10:50 发布单位： 龙岩市教育局云管中心 浏览量： 2344 【公开】

【龙岩市教育数据共享服务平台】

平台网盘接口

（版本号 V1.0）

 

 

文档修订记录

版本号

状态

简要说明

日期

变更人

V1.0

建立

平台网盘接口

2022-03-02

童倩

V1.1

新增

新增创建网盘目录接口

2022-04-22

童倩

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

接口服务规范

1.1、接口说明

龙岩市教育数据共享服务平台在政务信息网和政务外网、互联网区提供Restful接口，各部门业务系统通过调用该Restful接口，实现政务数据实时共享。

1.2、使用约束

限制类型

限制说明

传输字符编码格式

平台接口采用的是UTF-8编码格式

传输数据格式

平台接口采用JSON格式

 

1.3、接口原则

为了保证汇聚共享平台对外提供的统一接口安全可靠、简易兼容，接口规范应满足如下原则：

(1) 接口具有普遍的适应性；

(2) 使用简单、快捷的方式实现其他系统的接入；

(3) 接口应充分考虑省汇聚共享平台的应用扩展情况；

(4) 保证接口数据在省汇聚平台与用户系统的一致性；

(5) 接口调用能够方便的形成，并能在接入方顺利地实现；

(6) 在满足功能要求的前提下，使接口数据量最少；

(7) 接口数据传输控制策略可靠且完善；

(8) 具有可靠的接口数据出错返回机制。

 

接口使用规范

 

2.1、通用规范

2.1.1协议

所有接口调用均采用HTTP远程调用方式，客户端调用并同步返回响应。数据格式： json

2.1.2 请求

1. 请求方式：get/post， 服务地址url格式为http://domain/[service]/[servicename]

其中:domain为服务域名、service为服务名称、servicename 为API名称.

2. 协议消息头包含以下属性:

Content-Type：application/json;charset=utf-8;

3. 请求header包含以下参数:

user-date： 调用日期。格式yyyyMMddHHmmssSSS。17位日期字符串，小时采用24小时格式，如：20160101160758675；

user-params：请求参数。Get请求格式为：xx=xx&xx=xx。Post请求格式为json字符串。并对参数进行URL的UTF-8编码

authorization： 鉴权码，其中，鉴权码（authorition）=dc:{apikey}:{signature}。鉴权码由三部分组成，他们之间以英文冒号隔开；（详细请参考2.2）

2.1.3 响应

1. 响应报文媒体类型为application/json;charset=utf-8.

2.2、鉴权信息

apikey

管理人员分配

secretkey

管理人员分配

 

 

 

 

authorization：

第一部分：固定值为dc。

第二部分：用户申请的apikey。

第三部分：数据签名（signature）。

例如：

dc:test-apikey:ODExQUJENUFCRTBDQTc5NzM4RkQ2RTUzQzE2MDQyNUY=

数据签名（signature），加密格式如下：

signature=

BASE64{

Hmac_sha1{

user-params + 换行符

+ user-date + 换行符

}

}

数据签名由hmac_sha1加密后在经base64编码。hmac_sha1密钥为用户申请的secretkey。}

 

user-date

用日期。格式yyyyMMddHHmmssSSS。17位日期字符串，小时采用24小时格式，如：20160101160758675；

 

user-params

请求参数。Get请求格式为：xx=xx&xx=xx。Post请求格式为json字符串。

并对参数进行URL的UTF-8编码

2.3、 API接口调用示例

API调用示例代码：

 

 

下载Api调用示例，把代码导入开发工具，查看其中的RequestApiTest类，修改其中的 APIKEY，SECRETKEY，然后根据相应的请求方式，修改接口地址进行测试。

 

平台接口调用说明

1. 示例应用信息：

appId : c1e1957*********

appKey : 70fabe*********

 

 

2. 访问接口：

所有的接口都必须带上appId 和appKey参数

 

3. 业务接口

3.1网盘资源创建接口

         接口描述

网盘资源创建接口

         请求说明

url

http://open-api.longyanedu.net/onlineDisk/createResource

格式

application/json

协议

post

 

         参数说明

序号

字段名

是否必填

类型

长度

说明

1

fid

Y

Long

 

附件ID

2

title

Y

String

 

资源标题

3

keyword

N

String

 

资源关键词

4

intro

N

String

 

资源简介

5

resForm

Y

String

 

资源形式:

1=实体资源;

2=网络资源;

6

url

N

String

 

网络资源地址（resForm为2时必填）

7

periodId

Y

String

 

学段ID

8

subjectId

Y

String

 

学科ID

9

editionId

N

String

 

教材版本ID

10

gradeId

N

String

 

年级ID

11

volumeId

N

String

 

册别ID

12

textbookId

N

String

 

教材ID

13

chapterIdList

N

String[]

 

章节ID列表

14

resTypeIdList

N

String[]

 

资源类型ID列表

15

metadataIdList

N

String[]

 

元数据ID列表

16

ownerType

Y

String

 

资源属主类型:

0=个人; 1=群组; 2=机构

17

userId

Y

String

 

用户ID

18

orgId

Y

String

 

机构ID

19

groupId

N

String

 

群组ID

20

parentId

Y

String

 

上级目录ID: 根目录传0

21

issynchronization

N

String

 

是否同步到个人资源：0=否; 1=是

22

resSource

Y

String

 

资源来源:

0=网盘

1=文章

2=名师工作室

3=备授课

4=名师空中课堂

5=城乡结对系统

8=教学助手PC端

9=教学助手WEB端

23

canRemoved

N

String

 

能否删除：0=能; 1=否; 默认0

举例

{

    "fid": 12345,

    "title": "小学语文一年级《春晓》",

    "keyword": "春晓",

    "intro": "简介简介简介",

    "resForm": "1",

    "periodId": "xx",

    "subjectId": "jcsub01",

    "editionId": "bb01",

    "gradeId": "5",

    "volumeId": "vol001",

"textbookId": "156754",

"issynchronization":"1",

    "chapterIdList": [

        "125324",

        "234562"

    ],

    "resTypeIdList": [

        "wb",

        "st"

    ],

    "metadataIdList": [

        "CH",

        "jl01"

    ],

    "ownerType": "0",

    "userId": "F259F9A575B17692E04010AC73D40970",

    "orgId": "F259F9A575B17692E04010AC73D40970",

    "groupId": "F259F9A575B17692E04010AC73D40970",

"parentId": "0",

"resSource":"0",

"canRemoved":"1"

}







 

         返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

000000：成功

2

resultDesc

Y

String

 

 

3

data

Y

JSON

 

 

3.1

resId

Y

String

 

资源ID

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

        "resId": "1234567890"

    }

}








3.2获取学段列表接口

3.2.1接口描述

根据教材数据关联查询学段信息

3.2.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/queryPeriods

格式

application/json

协议

post

 

3.2.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

subjectId

N

String

 

学科ID

2

gradeId

N

String

 

年级ID

3

volumeId

N

String

 

册别ID

4

editionId

N

String

 

教材版本ID

举例

{

    "subjectId":"sub",

    "gradeId":"gra",

    "volumeId":"vol",

"editionId":"edi"

}

 







 

3.2.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

000000：成功

2

resultDesc

Y

String

 

 

3

data

Y

JSON

 

 

3.1

periodList

Y

JSON[]

 

学段列表

3.1.1~3.1.n

periodId

Y

String

 

学段ID

periodName

Y

String

 

学段名称

sortNum

N

Integer

 

排序字段

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

        "periodList": [

            {

                "periodId": "PER0001",

                "periodName": "小学"

            },

            {

                "periodId": "PER0004",

                "periodName": "高中"

            }

        ]

    }

}







3.3获取学科列表接口

3.3.1接口描述

根据教材数据关联查询学科信息

3.3.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/querySubjects

格式

application/json

协议

post

 

3.3.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

periodId

N

String

 

学段ID

2

gradeId

N

String

 

年级ID

3

aamGradeId

N

String

 

aam年级ID,以aamGradeId查询为主

4

volumeId

N

String

 

册别ID

5

editionId

N

String

 

教材版本ID

举例

{

    "periodId":"xx",

"gradeId":"gra",

"aamGradeId":"gra",

    "volumeId":"vol",

"editionId":"edi"

}

 







 

3.3.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

000000：成功

2

resultDesc

Y

String

 

 

3

data

Y

JSON

 

 

3.1

subjectList

Y

JSON[]

 

年级列表

3.1.1~3.1.n

subjectId

Y

String

 

年级ID

subjectName

Y

String

 

年级名称

sortNum

N

Integer

 

排序字段

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

        "subjectList": [

            {

                "subjectId": "SUB0002",

                "subjectName": "语文"

            },

            {

                "subjectId": "GRA0004",

                "subjectName": "数学"

            }

        ]

    }

}







3.4获取版本列表接口

3.4.1接口描述

根据教材数据关联查询教材版本信息

3.4.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/queryEditions

格式

application/json

协议

post

 

 

3.4.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

volumeId

N

String

 

册别ID

2

periodId

N

String

 

学段ID

3

gradeId

N

String

 

年级ID

4

aamGradeId

N

String

 

aam年级ID,以aamGradeId查询为主

5

subjectId

N

String

 

学科ID

举例

{

    "volumeId": "VOL0002",

    "periodId": "PER0004",

"gradeId": "GRA0001",

"aamGradeId": "GRA0001",

"subjectId": "SUB0005"

}







 

3.4.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

成功: 000000

2

resultDesc

Y

String

 

结果描述

3

data

Y

JSON

 

结果数据

3.1

editionList

Y

JSON[]

 

 

3.1.1~3.1.n

editionId

Y

String

 

版本ID

editionName

Y

String

 

版本名称

sortNum

N

Integer

 

排序字段

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

        "editionList": [

            {

                "editionId": "EDI2394",

                "editionName": "人教新课标版"

            },

            {

                "textbookId": "EDI8494",

                "textbookName": "人教课标版"

            }

        ]

    }

}







3.6获取册别列表接口

3.6.1接口描述

根据教材数据关联查询册别信息

3.6.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/queryVolumes

格式

application/json

协议

post

 

3.6.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

subjectId

N

String

 

学科ID

2

gradeId

N

String

 

年级ID

3

aamGradeId

N

String

 

aam年级ID，如果不为空，以aam年级ID查询为主

4

periodId

N

String

 

学段ID

5

editionId

N

String

 

教材版本ID

举例

{

    "subjectId":"sub",

"gradeId":"gra",

"aamGradeId":"gra",

    "periodId":"per",

"editionId":"edi"

}

 







 

3.6.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

000000：成功

2

resultDesc

Y

String

 

 

3

data

Y

JSON

 

 

3.1

volumeList

Y

JSON[]

 

册别列表

3.1.1~3.1.n

volumeId

Y

String

 

册别ID

volumeName

Y

String

 

册别名称

sortNum

N

Integer

 

排序字段

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

        "volumeList": [

            {

                "volumeId": "VOL0002",

                "volumeName": "第二册"

            },

            {

                "volumeId": "VOL0004",

                "volumeName": "选修一"

            }

        ]

    }

}







3.7获取教材列表接口

3.7.1接口描述

根据条件查询教材列表

3.7.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/queryTextbooks

支持验证方式

 

格式

application/json

协议

post

是否需要鉴权

false

请求数限制

false

接口方向

第三方CMS

 

3.7.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

editionId

N

String

 

教材版本ID

2

volumeId

N

String

 

册别ID

3

periodId

N

String

 

学段ID

4

gradeId

N

String

 

年级ID

 

aamGradeId

N

String

 

aam年级ID

5

subjectId

N

String

 

学科ID

举例

{

    "editionId": "EDI0001",

    "volumeId": "VOL0002",

    "periodId": "PER0004",

"gradeId": "GRA0001",

"aamGradeId": "GRA0001",

"subjectId": "SUB0005"

}







 

3.7.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

6

成功: 000000

2

resultDesc

Y

String

 

结果描述

3

data

Y

JSON

 

结果

3.1

list

Y

JSON[]

 

教材列表

3.1.1~3.1.n

textbookId

Y

String

 

教材ID

textbookName

Y

String

 

教材名称

intro

N

String

 

教材介绍

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

      "textbookId": "10134",

      "textbookName": "小学语文人教课标版一年级上册(2001)",

      "intro": "小学语文人教课标版一年级上册"

    },

 

    {

      "textbookId": "10138",

      "textbookName": "小学语文人教课标版三年级上册(2001)",

      "intro": "小学语文人教课标版三年级上册"

    }

}







 

3.8查询教材章节

3.8.1接口描述

根据教材ID或者章节上级ID查询章节信息

3.8.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/queryChapters

格式

application/json

协议

post

 

3.8.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

parentType

Y

String

 

0=根据教材ID查章节

1=根据上级章节ID查章节

2

parentId

Y

String

 

parentType为0时parentId传教材ID;

parentType为1时parentId传上级章节ID

3

retType

Y

String

 

返回类型：

0=返回整棵子树

1=返回下级节点

举例

{

    "parentType": "0",

"parentId": "TEX0000345621",

"retType": "0"

 

}







 

3.8.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

000000：成功

2

resultDesc

Y

String

 

 

3

data

Y

JSON

 

 

3.1

list

Y

JSON[]

 

结果列表

3.1.1~3.1.n

chapterId

Y

String

 

章节ID

chapterTitle

Y

String

 

章节标题

chapterPid

Y

String

 

父章节ID，根节点为0

textbookId

Y

String

 

教材ID

depth

Y

Integer

 

章节层级

isLeaf

Y

String

 

是否叶子节点

Y=是

N=否

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

        "list": [

            {

                "chapterId": "CHA0000000001",

                "chapterTitle": "一单元",

                "chapterPid": "0",

                "textbookId": "TEX0000000001",

                "chapterLevel": 2,

                "isLeaf": "N"

            },

            {

                "chapterId": "CHA0000000002",

                "chapterTitle": "二单元",

                "chapterPid": "0",

                "textbookId": "TEX0000000001",

                "chapterLevel": 2,

                "isLeaf": "N"

            }

        ]

    }

}

 

 







3.9学科资源列表查询接口

3.9.1接口描述

查询平台学科资源列表接口

3.9.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/xkzyList

格式

application/json

协议

post

 

3.9.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

page

Y

JSON

 

分页

1.1~1.2

curPage

Y

Integer

 

当前页

numPerPage

Y

Integer

 

每页条数

2

query

Y

JSON

 

查询条件

 

periodId

N

String

 

学段id

subjectId

N

String

 

学科id

volumeId

N

String

 

册别id

textbookId

N

String

 

教材id

chapterId

N

String

 

章节id

classificationId

N

String

 

基础类型

resType

N

String

 

资源类型(0:全部 1:图形图像 2:文本文档 3:视频 4:音频 5:动画)

keyword

N

String

 

关键字

orderBy

N

String

 

排序字段（倒序）:

viewCount=浏览量（默认）;

downCount=下载量;

createTime=创建时间;

fileLength=文件大小;

marks=评分

 

platformCode

N

String

 

平台编码

 

gradeId

N

String

 

年级id

                                             举例

{

"query": {

"platformCode": "888888"

},

"page": {

"curPage": 1,

"numPerPage": 10

}

 

}







 

3.9.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

000000：成功

2

resultDesc

Y

String

 

结果描述

3

data

Y

JSON

 

 

3.1

totalCount

Y

Integer

 

总数

3.2

productList

Y

JSON[]

 

产品列表

3.2.1~3.2.n

productCode

Y

String

 

产品编码

productName

Y

String

 

产品名称

createTime

Y

String

 

创建时间（yyyy-MM-dd HH:mm:ss）

viewCount

Y

Number

 

浏览次数

commentCount

Y

Number

 

评论次数

downCount

Y

Integer

 

下载次数

score

Y

Number

 

产品评分

fileName

N

String

 

产品附件名称

fileLength

N

String

 

产品附件大小

imageUrl

Y

String

 

图标地址

thumbnailUrlList

Y

list

 

缩略图地址

intro

Y

String

 

描述

userName

Y

String

 

贡献人

 

modifyTime

N

String

 

修改时间（yyyy-MM-dd HH:mm:ss）

 

thumbnailUrl

N

list

 

缩略图地址

 

fileExt

N

String

 

文件格式

 

fileSize

N

String

 

文件大小

 

title

N

String

 

搜索关键字

 

fid

N

String

 

文件fid

 

resIdList

Y

list

 

资源id数组

 

collectedCount

Y

Number

 

收藏次数

 

classificationId

N

String

 

简单分类

 

classificationName

N

String

 

简单分类名称

 

chapterId

N

String

 

章节id

 

chapterName

N

String

 

章节名称

 

desc

Y

String

 

产品描述

                                          举例

"result": "000000",

    "resultDesc": "success",

    "data": {

        "totalCount": 1,

        "productList": [

            {

                "productCode": "PD3546984",

"productName": "2016高考真题语文全国卷Ⅱ解析.doc",

"score": 0.0,

"createTime": "2016-10-07 00:00:00",

"modifyTime": "2016-10-07 00:00:00",

"commentCount": 0,

"downCount": 259,

"fileName": "2016高考真题语文全国卷Ⅱ解析.doc",

"fileLength": 193536,

"viewCount": 24547,

"userName": "慧教云",

"resIdList": ["aee57d2cf95b47e392e940ff9f131c7c"],

"fileExt": "doc",

"fileSize": "189KB",

"title": "2016高考真题语文全国卷Ⅱ解析.doc",

"fid": 5889223,

"collectedCount": 0,

"classificationId": "jl12",

"classificationName": "试卷",

"imageUrl": "http://css.huijiaoyun.com/tianyu_edu/common/images/resource_icon/doc.png"

            }

        ]

    }

}







 

4. 上传接口

4.1资源文件上传接口

4.1.1接口描述

上传小容量资源文件

4.1.2请求说明 【适用于小文件上传 50M以上大文件上传须走分片上传】

url

http://open-api.longyanedu.net/onlineDisk/uploadify

格式

multipart/form-data

协议

post

 

4.1.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

fileData

Y

Stream Bytes

 

文件流

举例

 







 

4.1.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

fid

Y

Long

 

文件ID

举例

{fid:2438652}







4.2断点续传--创建文件接口

4.2.1接口描述

断点续传之创建文件接口

4.2.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/createFid

格式

text/plain

协议

post

 

4.2.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

fileMd5

Y

String

 

文件MD5值

2

userId

Y

String

 

用户ID

3

fileLength

Y

String

 

文件大小：单位字节（byte）

4

filePathLocal

Y

String

 

文件在本地的路径

举例

模拟form表单post提交即可







 

4.2.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

000000：成功

100000：失败

2

resultDesc

Y

String

 

结果描述

3

data

Y

JSON

 

数据

3.1~3.n

fid

Y

Long

 

文件ID

fileLength

Y

Long

 

文件大小 单位字节

fileMd5

Y

String

 

文件MD5值

fileNameLocal

Y

String

 

文件名

filePathLocal

Y

String

 

文件本地路径

filePos

Y

Long

 

文件续传位置

fileSize

Y

String

 

格式化的文件大小

fileExt

Y

String

 

文件后缀

postComplete

Y

String

 

是否上传完成

"false"=否；

"yes”=是

postedLength

Y

Long

 

已上传的文件大小

postedTime

Y

String

 

上传时间

userId

Y

String

 

用户ID

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

        "fid": 4746964,

        "fileLength": 26051823,

        "fileMd5": "bf476d952cfc4f5727678869e692e235",

        "fileNameLocal": "基础数据-整合（新）.xlsx",

        "filePathLocal": "D:/files/20150402/基础数据-整合（新）.xlsx",

        "filePos": 0,

        "fileSize": "24.84MB",

        "fileExt": "xlsx",

        "isDeleted": "false",

        "postComplete": "false",

        "postedLength": 0,

        "postedTime": "2015-04-20 17:13:47",

        "userId": "5feda533f2a24a65b4113d8d3146a8db"

    }

}







4.3断点续传--文件续传接口

4.3.1接口描述

断点续传之文件续传接口

4.3.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/fileResume

格式

multipart/form-data

协议

post

 

4.3.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

fid

Y

String

 

文件ID

2

userId

Y

String

 

用户ID

3

fileLength

Y

String

 

文件大小：单位字节（byte）

5

fileMd5

Y

String

 

文件MD5值

6

fileNameLocal

Y

String

 

文件名称

7

filePos

Y

String

 

文件位置

8

part

Y

byte[]

 

文件块流

举例

模拟form表单post提交即可







 

4.3.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

000000：成功

100000：失败

2

resultDesc

Y

String

 

结果描述

3

data

Y

JSON

 

数据

3.1~3.n

fid

Y

Long

 

文件ID

fileLength

Y

Long

 

文件大小 单位字节

fileMd5

Y

String

 

文件MD5值

fileNameLocal

Y

String

 

文件名

filePathLocal

Y

String

 

文件本地路径

filePos

Y

Long

 

文件续传位置

fileSize

Y

String

 

格式化的文件大小

fileExt

Y

String

 

文件后缀

postComplete

Y

String

 

是否上传完成

"false"=否；

"yes”=是

postedLength

Y

Long

 

已上传的文件大小

postedTime

Y

String

 

上传时间

userId

Y

String

 

用户ID

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

        "fid": 4746964,

        "fileLength": 26051823,

        "fileMd5": "bf476d952cfc4f5727678869e692e235",

        "fileNameLocal": "基础数据-整合（新）.xlsx",

        "filePathLocal": "D:/files/20150402/基础数据-整合（新）.xlsx",

        "filePos": 0,

        "fileSize": "24.84MB",

        "fileExt": "xlsx",

        "isDeleted": "false",

        "postComplete": "false",

        "postedLength": 0,

        "postedTime": "2015-04-20 17:13:47",

        "userId": "5feda533f2a24a65b4113d8d3146a8db"

    }

}







4.4断点续传--获取未完成的文件接口

4.4.1接口描述

断点续传之获取用户未上传完成的文件列表接口

4.4.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/uncompletedFiles

格式

form

协议

post

 

4.4.3参数说明

序号

字段名

是否必填

类型

长度

说明

1

userId

Y

String

 

用户ID

举例

/cms-ft/uncompletedFiles?userId=5feda533f2a24a65b4113d8d3146a8db







 

4.4.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

000000：成功

100000：失败

2

resultDesc

Y

String

 

结果描述

3

data

Y

JSON

 

数据

3.1

uncompletedFiles

Y

JSON[]

 

文件列表

3.1.1~3.1.n

fid

Y

Long

 

文件ID

fileLength

Y

Long

 

文件大小 单位字节

fileMd5

Y

String

 

文件MD5值

fileNameLocal

Y

String

 

文件名

filePathLocal

Y

String

 

文件本地路径

filePos

Y

Long

 

文件续传位置

fileSize

Y

String

 

格式化的文件大小

fileExt

Y

String

 

文件后缀

postComplete

Y

String

 

是否上传完成

"false"=否；

"yes”=是

postedLength

Y

Long

 

已上传的文件大小

postedTime

Y

String

 

上传时间

userId

Y

String

 

用户ID

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

        "uncompletedFiles": [

            {

                "fid": 4746964,

                "fileLength": 26051823,

                "fileMd5": "bf476d952cfc4f5727678869e692e235",

                "fileNameLocal": "基础数据-整合（新）.xlsx",

                "filePathLocal": "D:/files/20150402/基础数据-整合（新）.xlsx",

                "filePos": 0,

                "fileSize": "24.84MB",

                "fileExt": "xlsx",

                "isDeleted": "false",

                "postComplete": "false",

                "postedLength": 0,

                "postedTime": "2015-04-20 17:13:47",

                "userId": "5feda533f2a24a65b4113d8d3146a8db"

            }

        ]

    }

}







 

4.5创建网盘目录

4.5.1接口描述

创建网盘目录

4.5.2请求说明

url

http://open-api.longyanedu.net/onlineDisk/createFolder

格式

application/json

协议

post

 

4.5.3参数说明

序号

字段名

是否必填

类型

长度

说明

parentId

否

string

父级目录id

 

 

ownerType

是

string

资源类型（0:个人资源，1:群组资源，2:机构资源）

 

 

userId

是

string

用户ID

 

 

orgId

否

string

机构ID（资源内省为2时，orgId不能为空）

 

 

dirName

是

string



文件夹名称







 

 





groupId

否

string

群组ID（资源类型为1时，groupId不能为空）

 

 

 

4.5.4返回说明

序号

字段名

是否必填

类型

长度

说明

1

result

Y

String

 

000000：成功

100000：失败

2

resultDesc

Y

String

 

结果描述

3

data

Y

JSON

 

数据

3.1

dirId

Y

String

 

文件夹ID

举例

{

    "result": "000000",

    "resultDesc": "success",

    "data": {

        "dirId": "8ef4d642693840ceb7f0b208341e57bd"

    }

}

 







 

 


上一篇: 龙岩市教育数据共享服务平台-天喻认证相关| 下一篇: 龙岩市教育数据共享服务平台-门户统一风格

评论

还能输入140字

用户评论

 | 帮助中心
龙岩市教育局主办     技术运营支持：福建智慧海西信息技术有限公司   
Copyright©2022 www.longyanedu.net All rights reserved      ICP备案号: 闽ICP备09006768号

经过核实，本空间由于存在敏感词或非法违规信息或不安全代码或被其他用户举报，
已被管理员（或客服）锁定。
本空间现无法正常访问，也无法进行任何操作。
如需解锁请联系当地教育技术部门，由当地教育技术部门联系锁定人处理。

当前机构空间已被管理员（或客服）封锁。
目前机构空间无法正常访问，也无法进行任何操作。
如需重新开放，请联系当地教育技术部门，由当地教育技术部门联系管理员（或客服）处理。