分页查询事项评价数据接口3.8.2.SP2+

接口说明

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

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求头

字段名	参数名	必填	类型	描述
应用ID	appId	M	String(128)	接入网关的应用ID
Token	accessToken	M	String	接入网关的accessToken

请求体

字段名	参数名	必填	类型	描述
要查询的事项wid列表	wids	M	List	要查询的事项wid列表
查询的当前页	pageNumber	O	int	用于分页查询使用，从1开始,默认1
查询的每页数量	pageSize	O	int	用户分页查询使用，默认10，最大允许100
评价类型	appraiseType	O	int	默认全部，1-好评，2-中评（受配置项控制，未开启查询到的值为空），3-差评，其他数字默认查询全部

请求示例

{
  "wids":["b2014832-2589-4071-b224-a831c06392a9"],
  "pageNumber":1,
  "pageSize":10,
  "appraiseType": 1
}

响应说明

响应体

字段名	参数名	类型	描述
返回码	errcode	String	0 成功，其他为不成功
返回码描述	errmsg	String	返回码描述
查询的当前页	pageNumber	int	用于分页查询使用，从1开始
查询的每页数量	pageSize	int	用户分页查询使用，默认10，最大允许100
查询的总条数	totalSize	long	用户分页查询使用，默认10，最大允许100
全部评价数量	sumCount	int	全部评价数量
好评数量	goodCount	int	好评数量
差评数量	badCount	int	差评数量
中评数量	mediumCount	int	中评数量
返回对象	data	List<ItemUserAppraiseExt>	事项评价数据列表

评价数据列表(返回)

字段名	类型	描述
userId	String	用户账号
userName	String	用户姓名
itemWid	String	事项wid
itemName	String	事项名称
langList	List<MultiLangInfo>	事项名称的多语言数据
score	Float	评价分数
content	String	评价内容
adminComment	String	管理员反馈
appraiseTime	String	评价时间
appraisePics	List<String>	评价图片列表（oss图片地址）
dimensionScoreList	List<ItemDimensionScore>	多维度评价数据列表

事项名称的多语言数据(返回)

字段名	类型	描述
langCountry	String	国家编码
langValue	String	多语言值

ItemDimensionScore(返回)

字段名	类型	描述
dimensionWid	String	评价维度id
dimensionName	String	评价维度名称
score	Integer	评价维度得分
langList	List<MultiLangInfo>	评价维度名称的多语言数据

响应示例

{
  "data": [
    {
      "userId": "1006159694508433408",
      "userName": "超级管理员",
      "score": 4.3,
      "content": "学生证办理的评价",
      "adminComment": null,
      "appraiseTime": "2026-01-13 14:04:24",
      "dimensionScoreList": [
        {
          "dimensionWid": "999375545789431808",
          "dimensionName": "1",
          "score": 4,
          "langList": [
            {
              "langCountry": "en",
              "langValue": ""
            },
            {
              "langCountry": "zh_CN",
              "langValue": "1"
            }
          ]
        },
        {
          "dimensionWid": "EVENT_INTEGRITY",
          "dimensionName": "信息完整度",
          "score": 5,
          "langList": [
            {
              "langCountry": "en",
              "langValue": null
            },
            {
              "langCountry": "zh_CN",
              "langValue": "信息完整度"
            }
          ]
        },
        {
          "dimensionWid": "SERVICE_SPEED",
          "dimensionName": "办事速度",
          "score": 3,
          "langList": [
            {
              "langCountry": "en",
              "langValue": null
            },
            {
              "langCountry": "zh_CN",
              "langValue": "办事速度"
            }
          ]
        },
        {
          "dimensionWid": "SERVICE_MANNER",
          "dimensionName": "服务态度",
          "score": 5,
          "langList": [
            {
              "langCountry": "en",
              "langValue": null
            },
            {
              "langCountry": "zh_CN",
              "langValue": "服务态度"
            }
          ]
        }
      ],
      "itemWid": "1323603575166570496",
      "langList": [
        {
          "langCountry": "en",
          "langValue": ""
        },
        {
          "langCountry": "zh_CN",
          "langValue": "学生证办理"
        }
      ],
      "appraisePics": [
        "https://wechattest.wisedu.com/oss/userIcon/casp-portal/uploadInfos/20260113/10061596945084334081768284264119.jpeg?sign=AVaiti6TnkfaPL3EPa9EWc31vKFJuB_2lPK5aJanOZlFjYzJt_JUrqiAscbs4qpE82Bl86XUdKH9-OdDHjmC3g",
        "https://wechattest.wisedu.com/oss/userIcon/casp-portal/uploadInfos/20260113/10061596945084334081768284264188.png?sign=Mms_SCin8ke5t4pQVsWZ9h-VjqGsYKjG3POC929aTEtMGhVb57zpOx-lUmIKAxmyxYdkBBTjqZLu6MKDU_mBmQ"
      ],
      "itemName": null
    }
  ],
  "pageNumber": 1,
  "pageSize": 10,
  "totalSize": 2,
  "errcode": "0",
  "errmsg": "请求成功",
  "traceId": null,
  "sumCount": 10,
  "badCount": 2,
  "mediumCount": 3,
  "goodCount": 5
}

错误码

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

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
//.....
UserItemAppraiseRequest userItemAppraiseRequest = new UserItemAppraiseRequest();

ItemAppraiseRequestContent content = new ItemAppraiseRequestContent();
content.setServiceWid("1323603575166570496");
content.setSuggest("学生证办理的评价-V2-测试代码1111");
content.setUserId("01123338");

AppraiseDetail appraiseDetail = new AppraiseDetail();
java.util.List<ItemDimenScore> scores = new java.util.ArrayList<ItemDimenScore>();

ItemDimenScore score1 = new ItemDimenScore();
score1.setDimenWid("999375545789431808");
score1.setDimenScore(4);
scores.add(score1);

ItemDimenScore score2 = new ItemDimenScore();
score2.setDimenWid("EVENT_INTEGRITY");
score2.setDimenScore(5);
scores.add(score2);

ItemDimenScore score3 = new ItemDimenScore();
score3.setDimenWid("SERVICE_SPEED");
score3.setDimenScore(3);
scores.add(score3);

ItemDimenScore score4 = new ItemDimenScore();
score4.setDimenWid("SERVICE_MANNER");
score4.setDimenScore(5);
scores.add(score4);

appraiseDetail.setScore(scores);
content.setAppraiseDetail(appraiseDetail);

List<File> uploadFile = new ArrayList<File>();
File file = new File("/Users/wf/Downloads/11111.png");
uploadFile.add( file);
File file1 = new File("/Users/wf/Downloads/0217586993572863cdae1c3974ac2ed201a335174294e69a9e01b_0.jpeg");
uploadFile.add( file1);
userItemAppraiseRequest.setUploadFile(uploadFile);
userItemAppraiseRequest.setContent(content);
BaseResponse response = client.execute(userItemAppraiseRequest);

//调用成功，则处理业务逻辑
if (response.isSuccess()) {
//.....

}