开卡

POST

https://api2.hik-cloud.com/api/v1/estate/system/cards/actions/openCard

功能描述

给人员开通卡片。

返回码

返回码	返回消息	描述
510001	参数错误	必填项为空、参数长度不符合等参数异常情况
511046	该人员不存在
511104	住户只能有三张卡
511105	物业人员只能有一张卡
511106	卡号已被使用	卡号已绑定人员，空白卡可以使用
511033	没有该设备权限
511113	卡号长度超过20
511114	人员类型不合法
511116	卡号只能是数字
511145	设备数量超出限制

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api2.hik-cloud.com/api/v1/estate/system/cards/actions/openCard' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{

         
    "unionId": "",

         
    "cardNumber": "12345678",

         
    "personId": "00a795f4a25d4de09edd091f28747eb4",

         
    "personType": 1,

         
    "deviceIds": [

         
        "0f8f9ecdbfab7c78238088a4e3c81f31",

         
        "4e3c81f310f8b7c78238088af9ecdbfa"

         
    ]

         
}'

响应示例

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "cardId": "00a795f4a25d4de09edd091f28747eb4"
    }
}

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

unionId

string

关联ID,保留字段

可选

cardNumber

string

卡号

必需

仅支持数字

personId

string

人员ID

必需

personType

integer

人员类型

必需

[0]物业;[1]住户;

deviceIds

array[string]

需要下发的设备ID列表

可选

若未传设备ID，将对所有有权限的设备进行下发

示例

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

返回消息

必需

data

object

节点对象

必需

cardId

string

卡片ID

必需

删除卡片（白卡）

退卡