退卡

POST

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

功能描述

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

返回码

返回码	返回消息	描述
510001	参数错误	必填项为空、参数长度不符合等参数异常情况
511107	卡号不存在
511108	只有正常卡才能退卡	其他状态的卡片无法退卡，比如挂失的卡片

请求示例

Shell

JavaScript

Java

Swift

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

         
    "cardId": "00a795f4a25d4de09edd091f28747eb4"

         
}'

响应示例

{
    "code": 200,
    "message": "操作成功"
}

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

cardId

string

卡片ID

必需

示例

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

返回消息

必需

开卡

换卡