主题
保存事项评价接口3.8.2.SP2+
接口说明
请求URL:http[s]://{网关地址}/itemAppraise/saveItemAppraise
请求方式: POST
请求内容类型: application/json
响应内容类型: application/json
请求说明
请求头
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 应用ID | appId | M | String(128) | 接入网关的应用ID |
| Token | accessToken | M | String | 接入网关的accessToken |
请求体
数据格式:
form-data
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 评价图片列表 | uploadFile | O | File | 事项评价的的图片格式JPG JPEG PNG 大小500k内 |
| 评价内容 | data | M | String | 评价的json串 |
json串字段说明
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 事项ID | serviceWid | M | String(128) | 事项的唯一Id |
| 评价内容 | suggest | O | String | 评价内容 |
| 用户工号 | userId | M | String | 用户工号 |
| 评分详情 | M | AppraiseDetail | 评分详情 |
AppraiseDetail(返回)
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 评分详情 | M | List<ItemDimensionScore> | 评分详情 |
ItemDimensionScore(返回)
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 评价维度id | dimenWid | M | String | 评价维度id |
| 评价维度得分 | dimenScore | M | int | 评分,分值范围1-5 |
请求示例
http
------WebKitFormBoundary3M1eo21nkrTJGF7J
Content-Disposition: form-data; name="uploadFile"; filename="Snipaste_2024-07-29_13-30-46.png"
Content-Type: image/png
------WebKitFormBoundary3M1eo21nkrTJGF7J
Content-Disposition: form-data; name="data"
{"userId":"ampadmin","serviceWid":"1323603575166570496","suggest":"图片上传测试","appraiseDetail":{"score":[{"dimenWid":"999375545789431808","dimenScore":"4"},{"dimenWid":"EVENT_INTEGRITY","dimenScore":"5"},{"dimenWid":"TOTAL_SATISFY","dimenScore":"5"},{"dimenWid":"SERVICE_SPEED","dimenScore":"4"}]}}
------WebKitFormBoundary3M1eo21nkrTJGF7J--1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
响应说明
响应体
| 字段名 | 参数名 | 类型 | 描述 |
|---|---|---|---|
| 返回码 | errcode | String | 0 成功,其他为不成功 |
| 返回码描述 | errmsg | String | 返回码描述 |
响应示例
json
{
"errcode": "0",
"errmsg": "请求成功",
"data": null
}1
2
3
4
5
2
3
4
5
错误码
| 错误码 | 描述 |
|---|---|
| 999 | 统一错误码,详细描述信息参见接口返回 |
Demo
java
// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
//.....
UserItemAppraiseRequest userItemAppraiseRequest = new UserItemAppraiseRequest();
userItemAppraiseRequest.setServiceWid("1323603575166570496");
userItemAppraiseRequest.setSuggest("学生证办理的评价-V2-测试代码1111");
userItemAppraiseRequest.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);
userItemAppraiseRequest.setAppraiseDetail(appraiseDetail);
List<String> appraiseImages = new java.util.ArrayList<String>();
appraiseImages.add("https://wechattest.wisedu.com/oss/userIcon/casp-portal/uploadInfos/20260113/10061596945084334081768284264119.jpeg?sign=UKL76Sy-nZ0WimOi561JtOtC1NxALgW6WEip69nqEFbQEchjIvdbhaTxYAuumu6678fYAIc47OadgAhXzxFwcg");
appraiseImages.add("https://wechattest.wisedu.com/oss/userIcon/casp-portal/uploadInfos/20260113/10061596945084334081768284264188.png?sign=wdd-GNkIkVFVS6bUvTsqxXfXtPgi6vm1EDlj1Gg8NZKb3dpECcM-Hx-lYwM0S2dcFBb1E4GgeNiPl1D4UXJVAw");
userItemAppraiseRequest.setAppraiseImages(appraiseImages);
BaseResponse response = client.execute(userItemAppraiseRequest);
//调用成功,则处理业务逻辑
if (response.isSuccess()) {
//.....
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

