Palm X API 文档
本文档为 Palm X API 文档，覆盖 RGB 掌纹识别相关接口。
概述
Palm X 提供掌纹注册、1:1 核验（比对）、1:N 识别（检索）、删除掌纹等核心掌纹识别 API 能力，使用 API Key（ak_ 前缀）认证，通过 HTTPS Bearer Auth 调用。
Palm X 提供单 RGB 模态方案：所有接口接收手机或电脑摄像头拍摄的 RGB 掌图，无需专用红外硬件，兼容移动端与 PC 端浏览器采集场景。
注意 — 使用限制
Palm X 仅限个人开发者非商业用途，不得用于生产环境。
说明
- 默认频率限制为每个接口 20 次/秒，超出限制将返回 HTTP
429；如需更高限额，可联系官方申请提额（详见 API 概览）。- 试用与付费：自应用创建起 90 天内可免费使用；90 天后将受到调用次数与掌纹库容量限制，付费购买 License 即可解除限制。具体计费规则以后续官方公告为准。
术语表
Palm X API 接口的常见术语请参见下表：
| 术语 | 说明 |
|---|---|
| RGB | 彩色图像。Palm X 接口接收普通手机或电脑摄像头拍摄的 RGB 掌图。 |
| PalmId | 已注册掌纹的唯一标识，由 RegisterRgbPalm 返回。 |
| PalmDirection | 注册或识别掌纹的手掌方向。1 = 左手（LEFT_PALM），2 = 右手（RIGHT_PALM）。 |
| 1:1 核验 | 将掌图与指定用户的已注册掌纹进行比对（CompareRgbPalm）。 |
| 1:N 识别 | 将掌图与掌纹库中所有已注册掌纹比对，返回最相似的用户（SearchRgbPalm）。 |
| API Key | 应用凭证（ak_ 前缀），通过每个请求的 Authorization: Bearer 头传递。 |