注册RGB掌纹

上传 RGB 掌图创建掌纹并绑定到指定用户，用于首次录入。单因子认证。

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

输入参数

参数名称	必选	类型	描述
UserId	是	String	用户唯一标识，由你自行定义，在你的应用内唯一
RgbImage	是	Image	RGB 掌图；Data 与 ImageType 必填
IsForce	否	Boolean	是否强制覆盖已有绑定。true = 覆盖；false（默认）= 已绑定时返回错误

输出参数（data）

参数名称	类型	描述
PalmId	String	绑定到该用户的掌纹 ID。若用户已有掌纹，系统将原位更新现有记录（PalmId 保持不变）并返回该已注册的 PalmId
PalmDirection	Integer	识别出的手掌方向，见 PalmDirectionType

示例

输入示例

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

{
  "UserId": "user001",
  "RgbImage": {
    "Data": "base64encodedRgbImageData...",
    "ImageType": 1
  },
  "IsForce": false
}

输出示例

{
  "code": 0,
  "message": "ok",
  "requestId": "4d5912a82af144f8a982c2da031c1035",
  "data": {
    "PalmId": "8db884f9-1fb8-44f5-bdaa-f98fdcb3cd47",
    "PalmDirection": 1
  }
}

cURL 示例

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

说明

• 每次成功注册会占用应用的掌纹库容量。容量占满后接口返回 2080014（palm capacity full），可联系官方申请扩容，或先删除历史掌纹。
• 未设置 IsForce 时重复注册返回 2080007（already bound）——这是正常业务结果，不是系统故障。