图标卡片相关

通过此页接口可以实现，添加、修改 图标卡片。

创建一个新的项目卡片

URL

/openapi/v1/item/create

请求内容

参数说明

参数名	示例值	参数类型	是否必填	参数描述
onlyName	test_baidu	String	否	唯一标识
iconUrl	https://xxx.cc/favicon.ico	String	否	图像地址
title	Baidu	String	否	标题
url	https://xxx.cc	String	是	地址
lanUrl	-	String	否	内网地址
description	-	String	否	描述信息
itemGroupID	1	int	否	分组ID itemGroupOnlyName 二选一 优先使用 itemGroupID v1.7.* 开始支持
itemGroupOnlyName	group1	String	否	分组唯一标识 itemGroupID 二选一 优先使用 itemGroupID v1.7.* 开始支持
isSaveIcon	true	boolean	否	是否保存图标到项目本地 默认：false 如果为 true 会强制保存并更新 v1.7.* 开始支持

内容示例

{
    "iconUrl":"",
    "title": "Baidu",
    "onlyName": "test_baidu",
    "url": "https://xxx.cc",
    "lanUrl": "",
    "description": "",
    "itemGroupID": 100,// 分组ID， 与 itemGroupOnlyName 二选一
    // "itemGroupOnlyName": "sun-app",// 分组唯一标识，与 itemGroupID 二选一
    "isSaveIcon": true
}

成功响应

内容示例

{
    "code": 0,
    "msg": "OK"
}

错误响应

可能出现的错误码：1202，错误码具体含义 点此查看

内容示例

{
    "code": 1202, 
    "msg": "..."
}

根据唯一标识查询项目信息

URL

/openapi/v1/item/getInfoByOnlyName

请求内容

参数说明

参数名	示例值	参数类型	是否必填	参数描述
onlyName	test_baidu	String	是	唯一标识

内容示例

{
    "onlyName": "test_baidu"
}

成功响应

参数说明

参数名	示例值	参数类型	参数描述
iconUrl	-	String	图像地址
title	Baidu	String	标题
onlyName	test_baidu	String	唯一标识
url	https://xxx.cc	String	地址
lanUrl	-	String	内网地址
description	-	String	描述信息
description	-	String	描述信息
itemGroupID	1	int	分组ID v1.7.* 开始支持
itemGroupOnlyName	group1	String	分组唯一标识 v1.7.* 开始支持

内容示例

{
    "code": 0,
    "data": {
        "iconUrl": "",
		"title": "Sun-Panel",
		"onlyName": "sun-panel008",
		"url": "https://sun-panel.top",
		"lanUrl": "",
		"description": "",
		"itemGroupID": 40,
		"itemGroupOnlyName": "neizhi-app",
    },
    "msg": "OK"
}

错误响应

可能出现的错误码：1203，错误码具体含义 点此查看

内容示例

{
    "code": 1203,
    "msg": "..."
}

修改项目卡片

不需要修改的参数，无需传输。 v1.7.* 开始支持

URL

/openapi/v1/item/update

请求内容

参数说明

参数名	示例值	参数类型	是否必填	参数描述
onlyName	test_baidu	String	是	唯一标识
iconUrl	https://xxx.cc/favicon.ico	String	否	图像地址
title	Baidu	String	否	标题
url	https://xxx.cc	String	否	地址
lanUrl	-	String	否	内网地址
description	-	String	否	描述信息
itemGroupID	1	int	否	分组ID itemGroupOnlyName 二选一 优先使用 itemGroupID v1.7.* 开始支持
itemGroupOnlyName	group1	String	否	分组唯一标识 itemGroupID 二选一 优先使用 itemGroupID v1.7.* 开始支持
isSaveIcon	true	boolean	否	是否保存图标到项目本地 默认：false 如果为 true 会强制保存并更新 v1.7.* 开始支持

内容示例

{
    "iconUrl":"",
    "title": "Baidu",
    "onlyName": "test_baidu",
    "url": "https://xxx.cc",
    "lanUrl": "",
    "description": "",
    "itemGroupID": 100,// 分组ID， 与 itemGroupOnlyName 二选一
    // "itemGroupOnlyName": "sun-app",// 分组唯一标识，与 itemGroupID 二选一
    "isSaveIcon": true
}

成功响应

内容示例

{
    "code": 0,
    "msg": "OK"
}

错误响应

可能出现的错误码：1202、1203，错误码具体含义 点此查看

内容示例

{
    "code": 1202, 
    "msg": "..."
}