跳到主要内容

删除掌纹

删除指定用户的掌纹信息。支持按手掌方向（左/右）单独删除或一并删除。删除后，对应的掌纹将无法再被 1:1 比对或 1:N 检索命中。

项目值
请求方式POST
请求地址https://open.intl.palm.tencent.com/palm/openai/delete_palm
Content-Typeapplication/json; charset=utf-8
鉴权方式Bearer <api_key>
默认频率限制20 次/秒

删除操作是幂等的：删除不存在的手掌方向不会报错。

输入参数​

参数名称必选类型描述
UserId是String用户唯一标识
PalmDirectionList是Array<Integer>待删除的手掌方向列表，见 PalmDirectionType。双手删除传 [1, 2]，也可只传单侧；传空数组 [] 表示删除该用户所有方向的掌纹

输出参数（data）​

无业务字段——data 为空对象 {}。返回成功即表示删除完成。

示例​

输入示例（删除双手掌纹）​

POST /palm/openai/delete_palm HTTP/1.1
Host: open.intl.palm.tencent.com
Content-Type: application/json; charset=utf-8
Authorization: Bearer ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

{
  "UserId": "user001",
  "PalmDirectionList": [1, 2]
}

输出示例​

{
  "code": 0,
  "message": "ok",
  "requestId": "4d5912a82af144f8a982c2da031c1035",
  "data": {}
}

cURL 示例​

curl -X POST "https://open.intl.palm.tencent.com/palm/openai/delete_palm" \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Authorization: Bearer ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "UserId": "user001",
    "PalmDirectionList": [1, 2]
  }'

说明​

  • 删除掌纹后会释放应用的掌纹库容量。
  • 删除前请在你侧完成调用者身份核验——Palm X 只执行删除操作，不管理你的业务侧用户状态。