人员注册
请求数据
|--------|---------------------------------|
| Method | URL |
| POST | http://设备 IP:8090/person/create |
Header域
|--------------|-------|--------|----|-----------------------------------|
| 参数名 | 描述 | 类型 | 必传 | 附加说明 |
| Content-Type | 请求体类型 | String | Y | application/x-www-form-urlencoded |
Body域
|--------|--------|--------|----|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 参数名 | 描述 | 类型 | 必传 | 附加说明 |
| pass | 设备密码 | String | Y |
| person | 人员信息集合 | Json | Y | Json 示例： { " id":"001", "name":"", "idcardNum":"", "facePermission":2, "idCardPermission":2, "faceAndCardPermission":2, "faceAndQrCodePermission":2, "iDNumberPermission":2, "qrCode":"", "tag":"", "phone":"", "password":"", |
杭州宇泛智能科技有限公司 - 杭州·对外公开
Add：杭州市文一西路 1217 号 IT 公园 A 座 10-13 楼 Tel：0571-87293191
Web： www.uni-ubi.com
96
Person参数
注意： 不带☆符号的参数为海思设备特有参数， 安卓设备中无此参数。
|------------------|-------------|--------|----|------------------------------------------------------------------------------------------|
| 参数名 | 描述 | 类型 | 必传 | 附加说明 |
| ☆id | 人员 Id | String | N | 内容可传空。 内容只允许数字和英文字母， 区分大小写， 长度限制 255 个字符, 若 personId 未传入或为空， 则系统生成 32 位 的 personId |
| ☆name | 人员名称 | String | Y | name 参数必传且内容不可为空。 长度限制 32 个字符、 内容无限制。 注： 海外设备非必传 |
| ☆idcardNum | 人员卡号 | String | N | 注册时可以不填， 长度限制 32 个字符， 内 容只允许数字和英文字母。 若注册人员时填 写了卡号， 可直接刷对应卡号的卡进行识 别， 屏幕也会显示与该卡号对应的人员的名 字。 |
| ☆iDNumber | 身份证号 | String | N | 注册时可以不填， 填写正确身份证 注： 海外不支持该字段 |
| ☆ facePermission | 单一验证方式 人像验证 | Int | N | 1： 关 2： 开 (默认) 单一验证方式可多选， 可与复合验证方式共 存(存在同一读头的情况除外， 比如不允许 |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|------|---|-------------------------------------------------------------------------------------------------------------------------------------------------------|
| "passwordPermission":2, "fingerPermission":1, "qrCodePermission":1, "cardAndPasswordPermission":1, } 注意， 部分属性 ( cardAndPasswordPermission / faceAndQrCodePermission/ qrCode / qrCodePermission)仅支持海外设备 |
| face1 | 注册照 1 信息 | Json | N | { "faceId":"001", "url":"url", "base64":"base64", "isEasyWay":"false", "bbox":{"bottom":206,"empty":fal se,"left":100,"right":407,"top":95} } 仅支持海外设备 |
| face2 | 注册照 2 信息 | Json | N | 同 face1 仅支持海外设备 |
| Face3 | 注册照 3 信息 | Json | N | 同 face1 仅支持海外设备 |
杭州宇泛智能科技有限公司 - 杭州·对外公开
Add：杭州市文一西路 1217 号 IT 公园 A 座 10-13 楼 Tel：0571-87293191
Web： www.uni-ubi.com
97
|----------------------------|----------------|-------------|---|---------------------------------------------------------------------------------|
| 同时选择人像验证和人像&卡验证方式) |
| ☆ idCardPermissi on | 单一验证方式 刷卡验证 | Int | N | 1 2： ： 关 开 (默认) |
| ☆ iDNumberPermis sion | 单一验证方式 身份证验证 | Int | N | 1 2： ： 关 开 (默认) |
| passwordPermis sion | 单一验证方式 密码验证 | Int | N | 1 2： ： 关 开（默认） |
| fingerPermissi on | 单一验证方式 指纹验证 | Int | N | 1 2： ： 关 开（默认） |
| qrCodePermissi on | 二维码比对 | Int | N | 二维码权限开关 1. 关 (默认) 2. 开 仅支持海外设备 该 属 性 和 2.0 的 二 维 码 权 限 属 性 (qrCodePermit)禁止同时出现 |
| ☆ faceAndCardPer mission | 复合验证方式 人像&卡验证 | Int | N | 1： 关(默认) 2： 开 可与单一验证方式共存(存在同一读头的情 况除外， 比如不允许同时选择人像验证和人 像&卡验证方式) |
| cardAndPasswor dPermission | 刷卡+密码开门 权限 | Int | N | 1： 关 (默认) 2： 开 与单一验证方式互斥 仅支持海外设备 |
| faceAndQrCodeP ermission | 人像+二维码开 门权限 | Int | N | 1： 关 (默认) 2： 开 与单一验证方式互斥 仅支持海外设备 |
| tag | 人员备注 | String | N | 注册时可以不填， 长度限制 60 个字符,内容 无限制。 用户可自定义使用 |
| qrCode | 二维码内容 | String | N | 二维码中包含的内容 仅支持海外设备 |
| password | 用户密码 | String | N | 注册时可以不填， 如果填了不能为空值， 长 度 6， 只允许数字， 不允许使用对称密码例 如(123321) |
| role | 人员类型 | Int | N | 0： 长期人员（默认） ， 人员有效期到期后， 不删除设备中存储的人员信息 1： 临时员工， 人员有效期到期后， 删除设 备中存储的人员信息 仅支持海外设备 |
| scheduleId | 关联的计划表 | String | N | 关联的计划表 id 可通过， 逗号分隔传入多个 scheduleId 仅支持海外设备 暂未实 现 |
| phone | 手机号 | String | N | 注册时可以不填， 长度限制 255 个字符,内 容无限制。 用户可自定义使用 |
| rule | 人员关联规则 信息 | Object [] | N |
杭州宇泛智能科技有限公司 - 杭州·对外公开
Add：杭州市文一西路 1217 号 IT 公园 A 座 10-13 楼 Tel：0571-87293191
Web： www.uni-ubi.com
98
|---------------|-------|--------|---|-------|
| +timezoneRule | 时间规则 | Object | N | 时间规则 |
| ++ruleId | 规则 id | String | N | 规则 id |
face示例
仅支持海外设备
|-----------|---------------------|----------|---|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| faceId | 照片 ID | String | Y | 若 faceId 传入内容为空， 则系统会自动生成一个 32 位的 faceId 并在照片注册成功后返回 faceId 内容只允许数字和英文字母， 区分大小写， 长度限制 255 个字符 |
| url | 照片 url | String | N | 若 base64、 url 都传， 以 url 优先。 即： 若传参传 入 url， 只会对 url 及其内容进行检验， base64 不 会进行检验 若使用 base64 方式注册， 传参请勿传入 url 若 base64、 url 均未传， 则会报错 只支持 http 协议存储位置的图片， 不支持本地路径 |
| base64 | 照片的 base64 编码 字符串 | String | N | 不加头部， 如： data:image/jpg;base64, |
| isEasyWay | 宽松 or 严格 照片注册方式 | Boolea n | N | 非必传， 默认 false： 严格检测照片质量， 若传 true： 宽松检测照片质量； |
| bbox | 人像框位置， 用于对注册照 原图提特征 | Json | N | 示例 {"bottom":206,"empty":false,"left":100,"right" :407,"top":95} 设备提特征时： 若传入此字段且格式正确， 则使用此字段； 若未传入 bbox 或 bbox 格式不正确， 则由设备自己画 框提特征； |
阿雪技术观
在科技发展浪潮中，我们不妨积极投身技术共享。不满足于做受益者，更要主动担当贡献者。无论是分享代码、撰写技术博客，还是参与开源项目维护改进，每一个微小举动都可能蕴含推动技术进步的巨大能量。东方仙盟是汇聚力量的天地，我们携手在此探索硅基生命，为科技进步添砖加瓦。
Hey folks, in this wild tech - driven world, why not dive headfirst into the whole tech - sharing scene? Don't just be the one reaping all the benefits; step up and be a contributor too. Whether you're tossing out your code snippets, hammering out some tech blogs, or getting your hands dirty with maintaining and sprucing up open - source projects, every little thing you do might just end up being a massive force that pushes tech forward. And guess what? The Eastern FairyAlliance is this awesome place where we all come together. We're gonna team up