检查资源文件是否已存在
1.接口描述
接口说明:检查资源文件是否已存在。
请求方式:
- 固件版本 V2.6.0 及以上:POST [ip]/mwapi/V2.0/source/check-source-exist
- 固件版本 V2.5.0 及以下:POST [ip]/mwapi/check-source-exist
管理员权限 | 登录认证 |
---|---|
否 | 是 |
2.输入参数
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
md5 | 否 | String | 文件MD5值,sourceType为 14 时为非必要参数 |
url | 否 | String | Url,仅在 sourceType 为 14 时生效 |
sourceType | 是 | Int | 资源类型 1:图片;2:视频;6:音乐;10:GFX;11:画面背景图;13:PDF;14:网页 |
3.输出参数
参数名称 | 类型 | 描述 |
---|---|---|
result | Int | 状态码 |
message | String | 状态描述 |
info | InfoData | 资源存在状态信息 |
InfoData
参数名称 | 类型 | 描述 |
---|---|---|
find | Int | 资源是否已存在 0:否;1:是 |
source | SourceData | 资源实体信息 |
SourceData
参数名称 | 类型 | 描述 |
---|---|---|
duration | Int | 资源持续时间。仅视频音乐有效。 |
filePath | String | 资源文件相对路径。可通过http访问http://[设备IP]/file/相对路径 。 |
height | Int | 资源高度 |
homeUrl | String | 主页地址。仅网页有效 |
id | Int | 资源ID,资源在设备中的唯一身份标识。 |
md5 | String | 文件MD5值 |
name | String | 资源名称 |
rotation | Int | 旋转角度,逆时针方向,范围[0~360] |
thumbHeight | Int | 资源缩略图高度 |
thumbWidth | Int | 资源缩略图宽度 |
thumbnailPath | String | 资源缩略图相对路径。可通过http访问http://[设备IP]/file/相对路径 |
type | Int | 资源类型 0:预置资源(采集+图片+视频)1:图片;2:视频;6:音乐;7:笔记背景图片;10:GFX图片;11:画面背景图片;12:画面背景色;13:PDF 文件;14:网页 |
url | String | 网页地址。仅网页有效 |
width | Int | 资源宽度 |
4.示例
检查图片文件是否已存在。
输入示例
{
"md5": "asdfghjklkjhgfdsdfghjk",
"sourceType": 1
}
输出示例
{
"info": {
"find": 1,
"source": {
"duration": 0,
"filePath": "2009/2009.JPG",
"height": 1080,
"id": 2009,
"md5": "f7e7f0cd578a44c77aed69e7c147d676",
"name": "IMG_3010",
"rotation": 0,
"secondaryType": 0,
"thumbHeight": 144,
"thumbWidth": 256,
"thumbnailPath": "2009/2009.thumb.jpeg",
"type": 1,
"width": 1920,
"url": ""
}
},
"message": "success",
"result": 0
}
5.错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 定义 | 说明 |
---|---|---|
7 | MW_STATUS_INVALID_ARG | 参数缺失 |
29 | MW_STATUS_NO_SPACE | 磁盘空间不足 |