主题
增加和修改照片 3.4.1.beta2+
接口说明
请求URL:http[s]://{网关地址}/minos-platform/user/addOrUpdateFace
请求方式: POST
请求内容类型: form-data
响应内容类型: application/json
请求说明
请求体
| 字段名 | 参数名 | 是否必填 | 类型 | 描述 |
|---|---|---|---|---|
| 用户ID | userId | M | String | 用户名/学工号 |
| 照片文件 | file | M | file | 人脸照片不超过4M,长宽均大于500px,支持jpg/jpeg格式; 头像不超过2M,长宽均小于100px,支持jpg/png格式。 |
| 照片类型3.5.4.beta3+ | imageType | O | String | 1 人脸(默认) 2头像 3证件照 |
提示
重新上传会覆盖原来图片
请求示例
参考demo
响应说明
响应体
| 字段名 | 参数名 | 是否必填 | 类型 | 描述 |
|---|---|---|---|---|
| 返回码 | errcode | M | String | 0 成功,其他为不成功 |
| 返回码描述 | errmsg | O | String | 返回码描述 |
| 返回对象 | data | O | Object | 返回的对象信息 |
响应示例
json
{
"errcode": "0",
"errmsg": "success",
"data": null
}1
2
3
4
5
2
3
4
5
错误码
| 错误码 | 描述 |
|---|---|
| 111001 | 必填参数不能为空 |
| 111002 | 请求参数格式错误,例如:参数值不在要求范围内。 |
| 117005 | 文件格式不对,不是jpg或jpeg图片! |
| 117008 | 头像照片长宽不能超过100px |
| 117009 | 照片大小不能超过xxxM |
| 999 | 统一错误码,详细描述信息参见接口返回 |
java
// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
AddOrUpdateFaceRequest request = new AddOrUpdateFaceRequest();
request.setUserId("campususertest001");
//文件路径
File file = new File("C:\\Users\\sltang\\Pictures\\sltang001.jpg");
request.setFileName(file.getName());
request.setInputStream(new FileInputStream(file));
request.setImageType("1");
BaseResponse response = client.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()) {
//.....
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

