人脸照片信息管理

API列表

请求方式	API	描述
POST	/v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/faces/{face_id}	新增用户人脸照片信息
PUT	/v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/faces/{face_id}	修改用户人脸照片信息
DELETE	/v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/faces/{face_id}	删除用户人脸照片信息

新增用户人脸照片信息

功能描述

新增用户人脸照片信息。

接口地址

POST /v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/faces/{face_id}

请求参数

请求参数	类型	参数类型	描述	是否必传
device_id	String	URI	设备id	是
person_id	String	URI	涂鸦用户id，不超过32个字符	是
face_id	String	URI	人脸id，不超过32个字符	是
url	String	BODY	人脸照片的url, 照片格式: jpg, 照片大小建议不超过1M	是

请求示例

POST  /v1.0/iot-02/third/doors/002dj00118fe34d9****/persons/162627/faces/12345
{
 "url":"http://xxxx.jpg"
}

返回信息

参数名	类型	说明
code	Integer	响应码（详情见错误码章节）
success	Boolean	本次请求是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功为空
result	Object	返回结果
result 说明

参数名	类型	说明
sn	String	指令记录id，一个指令记录id对应一个指令集

返回结果示例

{
    "success": true,
    "t": 1561456817168,
    "result": {
      "sn":"1212581947449081****"
    }
}

修改用户人脸照片信息

功能描述

修改用户人脸照片信息。

接口地址

PUT /v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/faces/{face_id}

请求参数

请求参数	类型	参数类型	描述	是否必传
device_id	String	URI	设备id	是
person_id	String	URI	涂鸦用户id，不超过32个字符	是
face_id	String	URI	人脸id，不超过32个字符	是
url	String	BODY	人脸照片的url, 照片格式: jpg, 照片大小建议不超过1M	是

请求示例

PUT  /v1.0/iot-02/third/doors/002dj00118fe34d9****/persons/162627/faces/12345
{
  "url":"http://xxxx.jpg"
}

返回信息

参数名	类型	说明
code	Integer	响应码（详情见错误码章节）
success	Boolean	本次请求是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功为空
result	Object	返回结果
result 说明

参数名	类型	说明
sn	String	指令记录id，一个指令记录id对应一个指令集

返回结果示例

{
    "success": true,
    "t": 1561456817168,
    "result": {
      "sn":"1212581947449081****"
    }
}

删除用户人脸照片信息

功能描述

删除用户人脸照片信息。

接口地址

DELETE /v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/faces/{face_id}

请求参数

请求参数	类型	参数类型	描述	是否必传
device_id	String	URI	设备id	是
person_id	String	URI	涂鸦用户id，不超过32个字符	是
face_id	String	URI	人脸id，不超过32个字符	是

请求示例

DELETE  /v1.0/iot-02/third/doors/002dj00118fe34d9****/persons/162627/faces/12345

返回信息

参数名	类型	说明
code	Integer	响应码（详情见错误码章节）
success	Boolean	本次请求是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功为空
result	Object	返回结果

result 说明

参数名	类型	说明
sn	String	指令记录id，一个指令记录id对应一个指令集

返回结果示例

{
    "success": true,
    "t": 1561456817168,
    "result": {
      "sn":"1212581947449081****"
    }
}