开发者中心 - 小鱼易连

一、功能说明

分片上传。公有云及 5.2 均支持。

流程图：

=================================================================================================================================

二、详细流程

1.预上传签名

RestUrl

POST https://sdk.xylink.com/api/rest/external/v1/file/manage/multipart/preSignature?enterpriseId=***&signature=***

参数类型

参数	参数类型	参数位置	是否必须	默认值	说明
enterpriseId	String	Query	是	无	企业id
signature	String	Query	是	无	签名值
storeType	String	Body	是	无	企业分组：需要向小鱼对接人员申请
fileSize	long	Body	是	0	文件大小（字节）
mimeType	String	Body	是	无	文件类型
title	String	Body	是	无	文件名称

请求消息体示例（JSON）：

{
     "storeType": "type-video",
     "fileSize": 4,
     "mimeType": "text/plain",
     "title": "test.txt"
}

返回成功结果示例：

{
     "preResourceId": "513424192910139392"
}

返回结果字段说明:

字段名称	备注
preResourceId	预上传资源id

=================================================================================================================================

2.开启一个分片上传事务

RestUrl

POST https://sdk.xylink.com/api/rest/external/v1/file/manage/multipart/upload/start?enterpriseId=***&signature=***

参数类型

参数	参数类型	参数位置	是否必须	默认值	说明
enterpriseId	String	Query	是	无	企业id
signature	String	Query	是	无	签名值
preResourceId	String	Body	是	无	预上传资源id

请求消息体示例（JSON）：

{
    "preResourceId":51342419291013939
}

返回成功结果示例：

{
     "partNum": 1,
     "partSize": "1"
}

返回结果字段说明:

字段名称	备注
partNum	推荐资源分片数
partSize	推荐资源分片大小

=================================================================================================================================

3.获取分片上传的url

RestUrl

GET https://sdk.xylink.com/api/rest/external/v1/file/manage/multipart/signature?enterpriseId=***&preResourceId=***&partIndex=***&signature=***

参数类型

参数	参数类型	参数位置	是否必须	默认值	说明
enterpriseId	String	Query	是	无	企业id
signature	String	Query	是	无	签名值
preResourceId	String	Query	是	无	预上传资源id
partIndex	String	Query	是	无	分片索引

请求Header参数

参数	参数类型	参数位置	是否必须	默认值	说明
FileContent-MD5	String	HEADER	是	无	⽂件内容md5，计算⽅法参考Content-MD5的计算⽅法
FileContent-Type	String	HEADER	是	无	⽂件类型

返回成功结果示例：

{
     "signatureUrl": "https://xylink-dev-filemanage.oss-cn-beijing.aliyuncs.com/video/20201117/513424192910139392.txt?
        Expires=1606609950&OSSAccessKeyId=LTAI4G9mjaH5UMtqMHtXy77i&Signature=lYiwTMl%2Bv3O9wkUDN8VdOtbw27c%3D&uploadId
        =D90EBA62BA4C45CC9F2F70809FD50E57&partNumber=1"
}

返回结果字段说明:

字段名称	备注
signatureUrl	分片上传的签名url

=================================================================================================================================

4.上传分片文件（基于获取的分片签名url）

RestUrl

PUT https://xylink-dev-filemanage.oss-cn-beijing.aliyuncs.com/video/20201117/513424192910139392.txt?Expires=1606609950&OSSAccessKeyId=LTAI4G9mjaH5UMtqMHtXy77i&Signature=lYiwTMl%2Bv3O9wkUDN8VdOtbw27c%3D&uploadId=D90EBA62

说明：需要在请求headers中传⼊Content-MD5、content-type

返回httpcode 200 表示上传成功

=================================================================================================================================

5.终止上传事务

RestUrl

DELETE https://sdk.xylink.com/api/rest/external/v1/file/manage/multipart/upload/remove?enterpriseId=***&preResourceId=***&signature=***

参数类型

参数	参数类型	参数位置	是否必须	默认值	说明
enterpriseId	String	Query	是	无	企业id
signature	String	Query	是	无	签名值
preResourceId	String	Query	是	无	预上传资源id

返回httpcode 204 表示成功

=================================================================================================================================

6.结束一个分片上传事务

RestUrl

POST https://sdk.xylink.com/api/rest/external/v1/file/manage/multipart/upload/end?enterpriseId=***&signature=***

参数类型

参数	参数类型	参数位置	是否必须	默认值	说明
enterpriseId	String	Query	是	无	企业id
signature	String	Query	是	无	签名值
preResourceId	String	Body	是	无	预上传资源id
partIndex	int	Body	是	无	文件分片索引
partTag	String	Body	是	无	文件分片标签

请求消息体示例（JSON）：

{
     "preResourceId": "513424192910139392",
     "tagList": [
         {
             "partIndex": 1,
             "partTag": "81DC9BDB52D04DC20036DBD8313ED055"
         }
     ]
}

返回成功结果示例：

{
     "path": "https://xylink-dev-filemanage.oss-cn-beijing.aliyuncs.com/video/20201117/513424192910139392.txt",
     "resourceId": "513424690560114688",
     "preResourceId": "513424192910139392"
}

返回结果字段说明:

字段名称	备注
path	文件预览路径
resourceId	资源id
preResourceId	预上传资源id

=================================================================================================================================

7.根据资源id获取资源信息

RestUrl

GET https://sdk.xylink.com/api/rest/external/v1/file/manage/multipart/resource/detail?enterpriseId=***&resourceId&signature=***

参数类型

参数	参数类型	参数位置	是否必须	默认值	说明
enterpriseId	String	Query	是	无	企业id
signature	String	Query	是	无	签名值
reourceId	String	Query	是	无	资源id

返回成功结果示例：

httpcode 204 表示⽆resourceId对应的资源信息

{
     "path": "https://xylink-dev-filemanage.oss-cn-beijing.aliyuncs.com/video/20201119/514158576118272000.txt",
     "resourceId": "514158934102118400",
     "storeType": "lanxin-video",
     "title": "test.txt",
     "fileSize": "4",
     "mimeType": "text/plain",
     "uploadTime": "2020-11-19 19:24:03"
}

返回结果字段说明:

字段名称	备注
path	文件预览路径
resourceId	资源id
storeType	分组
title	文件名称
fileSize	文件大小（字节）
mimeType	文件类型
uploadTime	上传时间

=================================================================================================================================

8.根据资源id删除资源

RestUrl

DELETE https://sdk.xylink.com/api/rest/external/v1/file/manage/multipart/resource/delete?enterpriseId=***&resourceId&signature=***

参数类型

参数	参数类型	参数位置	是否必须	默认值	说明
enterpriseId	String	Query	是	无	企业id
signature	String	Query	是	无	签名值
resourceId	String	Query	是	无	资源id

返回httpcode 204 表示成功

=================================================================================================================================

9.获取临时资源链接

RestUrl

POST https://sdk.xylink.com/api/rest/external/v1/file/manage/multipart/resource/cdnAuth?enterpriseId=***&signature=***

参数类型

参数	参数类型	参数位置	是否必须	默认值	说明
enterpriseId	String	Query	是	无	企业id
signature	String	Query	是	无	签名值
resourceId	String	Body	是	无	预上传资源id
expireln	long	Body	是	无	过期时间（秒）
linkAccessIpCount	Long	Body	否	无	可访问链接的 IP 数量限制，最小值为 1（仅公有云支持）

请求消息体示例（JSON）：

{
     "resourceId": "***",
     "expireIn": ***,
     "linkAccessIpCount":10
}

返回成功结果示例：

{
     "fileLink": "https://devfilemanagecdn.xylink.com/video/20201210/521738845922791424.mp4?auth_key=1608088635-22-
        7-ace373b6434f7cd9f750f8636268ee1c"
}

返回结果字段说明:

字段名称	备注
fileLink	文件上传资源链接

=================================================================================================================================

10.根据资源id获取资源信息

RestUrl

GET https://sdk.xylink.com/api/rest/external/v1/file/manage/multipart/preSignature/jsCode?enterpriseId=***&uploadNonce=**&signature=***

参数类型

参数	参数类型	参数位置	是否必须	默认值	说明
enterpriseId	String	Query	是	无	企业id
signature	String	Query	是	无	签名值
uploadNonce	String	Query	是	无	随机数，防⽌恶意请求，每次请求的随机数都要保证唯⼀（禁⽌存在特殊符号，尤其是⼀些需要转义的符号）

返回成功结果示例：

httpcode 204 表示⽆resourceId对应的资源信息

{
     "uploadNonce": "**",
     "jsCode": "**"
}

返回结果字段说明:

字段名称	备注
uploadNonce	你传⼊的uploadNonce参数，原样返回
jsCode	⽣成的临时jsCode：⼀次有效，有效时间为1分钟

2026-04-17 16:21:34

导出PDF文档