换卡

GET

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

功能描述

将已开通的卡片进行替换（旧卡将变为空白卡）。

返回码

返回码	返回消息	描述
510001	参数错误	必填项为空、参数长度不符合等参数异常情况
511106	卡号已被使用	新卡号已绑定人员无法使用，空白卡可以使用
511107	卡号不存在	旧卡不存在
511109	只有正常卡才能换卡	其他状态的卡片无法换卡，比如挂失的卡片
511033	没有该设备权限
511113	卡号长度超过20
511116	卡号只能是数字
511145	设备数量超出限制

请求示例

Shell

JavaScript

Java

Swift

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

         
    "unionId": "",

         
    "cardId": "00a795f4a25d4de09edd091f28747eb4",

         
    "cardNumber": "12345678",

         
    "deviceIds": [

         
        "0f8f9ecdbfab7c78238088a4e3c81f31",

         
        "4e3c81f310f8b7c78238088af9ecdbfa"

         
    ]

         
}'

响应示例

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

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

unionId

string

关联ID,保留字段

可选

cardId

string

旧卡片ID

必需

cardNumber

string

新卡号

必需

仅支持数字

deviceIds

array[string]

需要下发的设备ID列表

必需

清除所有的旧卡权限，并将新卡下发到指定设备，若未传，将下发到所有有权限的设备

示例

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

返回消息

必需

data

object

节点对象

必需

cardId

string

新卡片ID

必需

退卡

挂失