门禁卡管理

API列表

请求方式	API	描述
POST	/v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/card/{card_no}	新增门禁卡信息
PUT	/v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/card/{card_no}	修改门禁卡信息
DELETE	/v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/card/{card_no}	删除门禁卡信息
PUT	/v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/card/{card_no}/freeze	冻结门禁卡
PUT	/v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/card/{card_no}/unfreeze	解冻门禁卡

新增门禁卡信息

功能描述

新增门禁卡信息。

接口地址

POST	/v1.0/iot-02/third/doors/{device_id}/persons/{person_id}/card/{card_no}

请求参数

请求参数	类型	参数类型	描述	是否必传
device_id	String	URI	设备id	是
person_id	String	URI	涂鸦用户id，不超过32个字符	是
card_no	String	URI	门禁卡号	是

请求示例

POST	/v1.0/iot-02/third/doors/002dj00118fe34d9****/persons/162627/card/d9e2816da0f54**

返回信息

参数名	类型	说明
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}/card/{card_no}

请求参数

请求参数	类型	参数类型	描述	是否必传
device_id	String	URI	设备id	是
user_id	String	URI	涂鸦用户id，不超过32个字符	是
card_no	String	URI	门禁卡号	是

请求示例

PUT	/v1.0/iot-02/third/doors/002dj00118fe34d9****/persons/162627/card/d9e2816da0f54**

返回信息

参数名	类型	说明
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}/card/{card_no}

请求参数

请求参数	类型	参数类型	描述	是否必传
device_id	String	URI	设备id	是
person_id	String	URI	涂鸦用户id，不超过32个字符	是
card_no	String	URI	门禁卡号	是

请求示例

DELETE  /v1.0/iot-02/third/doors/002dj00118fe34d9****/persons/162627/card/d9e2816da0f54**

返回信息

参数名	类型	说明
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}/card/{card_no}/freeze

请求参数

请求参数	类型	参数类型	描述	是否必传
device_id	String	URI	设备id	是
person_id	String	URI	涂鸦用户id，不超过32个字符	是
card_no	String	URI	门禁卡号	是

请求示例

POST	/v1.0/iot-02/third/doors/002dj00118fe34d9****/persons/162627/card/d9e2816da0f54**/freeze

返回信息

参数名	类型	说明
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}/card/{card_no}/unfreeze

请求参数

请求参数	类型	参数类型	描述	是否必传
device_id	String	URI	设备id	是
person_id	String	URI	涂鸦用户id，不超过32个字符	是
card_no	String	URI	门禁卡号	是

请求示例

POST	/v1.0/iot-02/third/doors/002dj00118fe34d9****/persons/162627/card/d9e2816da0f54**/unfreeze

返回信息

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

result 说明

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

返回结果示例

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