数据结构

本页描述 Palm X RGB 掌纹识别接口使用的数据结构与枚举类型。

公共业务结构

Image

RGB 掌图结构。

名称	类型	必填	描述
Data	String	是	掌图的 Base64 编码内容（JPEG/PNG），建议单图 ≤ 1 MB
ImageType	ImageType	是	图片类型枚举，见下文。本文档接口固定传 1（RGB）

📸 拍摄约定（重要）：掌图必须以前置摄像头（自拍视角）上传。如客户端使用后置摄像头拍摄，上传前需将图片水平镜像，否则算法将误判左右手方向，导致注册/比对失败。

枚举类型

ImageType

图片类型。

返回类型：整数，取值为下表枚举值。

枚举值	描述
1	RGB（彩色图像）
2	IR（红外图像）—— 预留

PalmDirectionType

手掌方向。

返回类型：整数，取值为下表枚举值。

枚举值	描述
1	左手（LEFT_PALM）
2	右手（RIGHT_PALM）

说明

• 所有请求/响应字段均采用 PascalCase 命名（如 UserId、PalmId）。
• 掌纹由注册时返回的 PalmId 唯一标识，且始终关联唯一的 UserId 与一个 PalmDirection。