比对RGB掌纹

上传 RGB 掌图并与指定用户的已注册掌纹进行 1:1 比对，用于身份核验（如二次确认、支付前刷掌确认）。单因子认证。

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

输入参数

参数名称	必选	类型	描述
RgbImage	是	Image	RGB 掌图；Data 与 ImageType 必填
CompareUserId	是	String	待比对的目标用户 ID。该用户必须已通过 RegisterRgbPalm 在你的应用下注册

输出参数（data）

参数名称	类型	描述
IsMatch	Boolean	掌图是否与该用户匹配。true = 匹配，false = 不匹配
Score	Integer	相似度得分，0–100，越高越相似
AlgorithmVersion	String	本次比对使用的算法版本
PalmDirection	Integer	识别出的手掌方向，见 PalmDirectionType
SessionId	String	本次核验结果的临时查询凭据（UUID，有效期 2 小时）

示例

输入示例

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

{
  "RgbImage": {
    "Data": "base64encodedRgbImageData...",
    "ImageType": 1
  },
  "CompareUserId": "user001"
}

输出示例

{
  "code": 0,
  "message": "ok",
  "requestId": "4d5912a82af144f8a982c2da031c1035",
  "data": {
    "IsMatch": true,
    "Score": 95,
    "AlgorithmVersion": "v2.0",
    "PalmDirection": 1,
    "SessionId": "3f2b1a6d-8c4e-4b7a-9d5f-1e2c3a4b5c6d"
  }
}

cURL 示例

curl -X POST "https://open.intl.palm.tencent.com/palm/openai/compare_rgb_palm" \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Authorization: Bearer ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "RgbImage": {
      "Data": "'"$(base64 -w0 palm.jpg)"'",
      "ImageType": 1
    },
    "CompareUserId": "user001"
  }'

说明

• 请信任 IsMatch 的判定，不要自行对 Score 设置阈值。将 false 视为拒绝，并对连续失败进行限流（如 15 分钟内失败 5 次后冻结），以防暴力尝试。
• 比对未注册用户返回 2080016（user does not exist in DB）或 2080017（该手掌方向未注册）。