查询用户收藏的事项列表3.7.3.SP4+

用于查询用户收藏的事项列表；

接口说明

请求URL：http[s]://{网关地址}/coosk/sim/queryFavoriteItemList

请求方式： POST

请求内容类型：application/json

响应内容类型： application/json

请求说明

请求体

字段名	参数名	必填	类型	描述
学工号	userAccount	M	String(20)	学工号
与我相关	isRelate	O	Integer	0：查询所有数据（默认） 1：查询与我相关数据
用户范围类型	objectScope	O	Integer	1：校内用户（默认） 2：校外用户

请求示例

{
    "userAccount":"xxx"
}

响应说明

响应体

参数名	类型	描述
errcode	String	返回码
errmsg	String	返回描述
data	List<ServiceFolderModel>	事项收藏夹列表

ServiceFolderModel

字段名	参数名	类型	描述
收藏夹名称	wid	String	收藏夹名称
收藏夹名称	folderName	String	收藏夹名称
收藏夹排序号	sortNum	Integer	收藏夹排序号
服务事项列表	folderItems	List<ServiceItemModel>	服务事项列表

ServiceItemModel

字段名	参数名	类型	描述
事项wid	itemWid	String	事项wid
事项名称	itemName	String	事项名称
责任部门	itemDept	String	责任部门
事项图标	iconLink	String	事项图标地址
事项分类	itemCategory	String	事项分类
是否展示办事指南	isShow	Integer	0：不展示 1：展示
事项启用状态	isEnabled	Integer	0：停用 1：启用
在线办理按钮状态	onlineServiceType	Integer	0：不显示 1：禁用 2：显示
排序号	sortNum	Integer	排序号
收藏时间	favoriteTime	String	yyyy-MM-dd HH:mm:ss
关联服务类别	serviceType	Integer	0：校园服务 1：第三方链接地址 2：办理须知
关联服务	linkedExtraService	LinkedExtraService	关联类型为第三方链接地址或办理须知

LinkedExtraService

字段名	参数名	类型	描述
第三方系统访问地址	linkUrl	String	关联类型为第三方链接地址
移动端访问地址	linkMobile	String	关联类型为第三方链接地址
按钮名称	buttonName	String	关联类型为第三方链接地址
按钮名称	instructionsButtonName	String	关联类型为办理须知
办理须知	instructions	List<MultiLang>	关联类型为办理须知

MultiLang

字段名	参数名	类型	描述
多语言国家	langCountry	String	zh_CN（简体中文，默认） en（英文） ru（俄文）
多语言值	langValue	String	多语言值

响应示例

{
    "errcode": "0",
    "errmsg": "success",
    "traceId": null,
    "data": [
        {
            "wid": "1011593917092438016_item_defaultFolder",
            "folderName": "默认收藏夹",
            "sortNum": 0,
            "folderItems": [
                {
                    "itemName": "itemName1",
                    "itemWid": "itemWid",
                    "itemDept": "部门1",
                    "iconLink": "iconLink",
                    "itemCategory": "itemCategory",
                    "isShow": 1,
                    "isEnabled": 1,
                    "onlineServiceType": 0,
                    "sortNum": 0,
                    "favoriteTime": "2025-02-12 11:11:02",
                    "serviceType": 0,
                    "linkedExtraService": null
                }
            ]
        }
    ]
}

错误码

错误码	描述
999	统一错误码，详细描述信息参见接口返回

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID,APP_SECRET);
// 创建请求对象
QueryFavoriteItemRequest request = new QueryFavoriteItemRequest();
request.setUserAccount("xxx");
QueryFavoriteItemResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
    //.....
}