用途:主要使用在登录、需要人机校验或其他限制调用的场景
验证码生成、校验都在服务端。页面使用返回的 base64 显示。云端一体登陆模板已集成,可下载体验。
数据表使用opendb-verify-codes
用法:uniCaptcha.create(Object params);
参数说明
字段 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
scene | String | 是 | 4 | 使用场景值,用于防止不同功能的验证码混用 |
| deviceId | String | - | - | 设备 id,如果不传,将自动从 uniCloud 上下文获取 |
| width | Number | - | 100 | 图片宽度 |
| height | Number | - | 40 | 图片高度 |
| backgroundColor | String | - | #FFFAE8 | 验证码背景色 |
| size | Number | - | 4 | 验证码长度,最多 6 个字符 |
| noise | Number | - | 4 | 验证码干扰线条数 |
| expiresDate | Number | - | 180 | 验证码过期时间(s) |
响应参数
字段 | 类型 | 说明 |
---|---|---|
code | Number | 错误码,0 表示成功 |
message | String | 详细信息 |
captchaBase64 | String | 验证码:base64 格式 |
注意:
用法:uniCaptcha.verify(Object params);
参数说明
字段 | 类型 | 必填 | 默认值 | 说明 |
---|
| scene | String | 是 | - | 类型,用于防止不同功能的验证码混用 |
| captcha | String | 是 | - | 验证码 |
| deviceId | String | - | - | 设备 id,如果不传,将自动从 uniCloud 上下文获取 |
响应参数
字段 | 类型 | 说明 |
---|---|---|
code | Number | 错误码,0 表示成功 |
message | String | 详细信息 |
注意:
用法:uniCaptcha.refresh(Object params);
参数说明
字段 | 类型 | 必填 | 默认值 | 说明 |
---|
| scene | String | 是 | - | 类型,用于防止不同功能的验证码混用 |
| deviceId | String | - | - | 设备 id,如果不传,将自动从 uniCloud 上下文获取 |
响应参数
字段 | 类型 | 说明 |
---|---|---|
code | Number | 错误码,0 表示成功 |
message | String | 详细信息 |
captchaBase64 | String | 验证码:base64 格式 |
注意:
详细信息请查看 message 中查看
模块 | 模块码 | 错误代码 | 错误信息 |
---|---|---|---|
验证码 | 100 | 01 | (10001)验证码生成失败 |
02 | (10002)验证码校验失败 | ||
03 | (10003)验证码刷新失败 |