Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-unicloud-zh
提交
a81fca77
U
unidocs-unicloud-zh
项目概览
DCloud
/
unidocs-unicloud-zh
通知
83
Star
2
Fork
19
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
1
列表
看板
标记
里程碑
合并请求
8
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-unicloud-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
1
Issue
1
列表
看板
标记
里程碑
合并请求
8
合并请求
8
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
a81fca77
编写于
10月 08, 2024
作者:
VK1688
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
uni-rpia/mobile-verify
上级
2b4579a6
变更
10
隐藏空白更改
内联
并排
Showing
10 changed file
with
437 addition
and
488 deletion
+437
-488
docs/uni-rpia/common/http.md
docs/uni-rpia/common/http.md
+0
-163
docs/uni-rpia/mobile-2meta-verify/dev.md
docs/uni-rpia/mobile-2meta-verify/dev.md
+0
-106
docs/uni-rpia/mobile-2meta-verify/price.md
docs/uni-rpia/mobile-2meta-verify/price.md
+0
-19
docs/uni-rpia/mobile-2meta-verify/service.md
docs/uni-rpia/mobile-2meta-verify/service.md
+0
-32
docs/uni-rpia/mobile-3meta-verify-pro/price.md
docs/uni-rpia/mobile-3meta-verify-pro/price.md
+0
-21
docs/uni-rpia/mobile-3meta-verify-pro/service.md
docs/uni-rpia/mobile-3meta-verify-pro/service.md
+0
-32
docs/uni-rpia/mobile-3meta-verify/dev.md
docs/uni-rpia/mobile-3meta-verify/dev.md
+0
-110
docs/uni-rpia/mobile-verify/dev.md
docs/uni-rpia/mobile-verify/dev.md
+382
-0
docs/uni-rpia/mobile-verify/price.md
docs/uni-rpia/mobile-verify/price.md
+53
-0
docs/uni-rpia/mobile-verify/service.md
docs/uni-rpia/mobile-verify/service.md
+2
-5
未找到文件。
docs/uni-rpia/common/http.md
已删除
100644 → 0
浏览文件 @
2b4579a6
## 通过http方式调用接口
1.
新建云对象
`uni-cloud-verify-co`
,云对象名字可自己修改,这里以
`uni-cloud-verify-co`
为例。
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/56e57aba-9c24-4482-b0f0-328e3b88242d.png
)
在弹窗的窗口中选择云对象,输入名称 uni-cloud-verify-co
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/f1575aef-48de-4ea9-bee7-4e73ce8325dc.png
)
2.
修改云对象下的
`package.json`
文件,完整替换内容如下
```
js
{
"
name
"
:
"
uni-cloud-verify-co
"
,
"
dependencies
"
:
{},
"
extensions
"
:
{
"
uni-cloud-verify
"
:
{}
},
"
cloudfunction-config
"
:
{
"
concurrency
"
:
1
,
"
memorySize
"
:
512
,
"
path
"
:
"
/http/uni-cloud-verify-co
"
,
"
timeout
"
:
60
,
"
triggers
"
:
[],
"
runtime
"
:
"
Nodejs18
"
}
}
```
3.
修改云对象下的
`index.obj.js`
文件,完整替换内容如下
**注意:请修改变量apiKey的值为你的通讯密钥**
如果你自己有更好的安全验证逻辑,可自行修改
`_before`
内的逻辑
```
js
const
apiKey
=
"
xxxxxx
"
;
// 请替换为你的通讯密钥
const
uniVerifyManager
=
uniCloud
.
getUniVerifyManager
({
provider
:
"
univerify
"
,
});
class
MyError
extends
Error
{
constructor
(
err
)
{
super
();
this
.
err
=
err
;
}
}
module
.
exports
=
{
_before
:
function
()
{
const
params
=
this
.
getParams
();
const
data
=
params
[
0
]
||
params
;
// 验证通讯密钥
if
(
data
.
key
!==
apiKey
)
{
throw
new
MyError
({
code
:
-
1
,
msg
:
"
非法请求
"
});
}
},
_after
:
function
(
error
,
result
)
{
if
(
error
)
{
if
(
error
.
err
)
{
return
error
.
err
;
}
throw
error
;
}
return
result
},
// 手机号三要素认证(简版)
async
mobile3MetaVerify
(
data
)
{
let
{
realName
,
idCard
,
mobile
,
}
=
data
;
const
res
=
await
uniVerifyManager
.
mobile3MetaVerify
({
realName
,
idCard
,
mobile
});
return
res
;
},
// 手机号三要素认证(详版)
async
mobile3MetaVerifyPro
(
data
)
{
let
{
realName
,
idCard
,
mobile
,
}
=
data
;
const
res
=
await
uniVerifyManager
.
mobile3MetaVerifyPro
({
realName
,
idCard
,
mobile
});
return
res
;
},
// 手机号二要素认证
async
mobile2MetaVerify
(
data
)
{
let
{
realName
,
idCard
,
mobile
,
}
=
data
;
const
res
=
await
uniVerifyManager
.
mobile2MetaVerify
({
realName
,
idCard
,
mobile
});
return
res
;
}
}
```
4.
上传云对象
`uni-cloud-verify-co`
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/828ae99b-21b1-4967-a987-26ef9eea4824.png
)
5.
查看http接口地址,登录
[
uniCloud控制台
](
https://unicloud.dcloud.net.cn/
)
,进入空间详情,点击左侧菜单 - 云函数/云对象 - 函数/对象列表,进入 uni-cloud-verify-co 的详情
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/8bd9c241-fdea-41a1-9547-86ce03005257.png
)
6.
进入详情后点击右下方的复制路径按钮
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/133c5359-503f-4d4b-b648-cdf86b5a4c66.png
)
假设复制的路径是:
`https://xxxxxxxxxx.next.bspapp.com/http/uni-cloud-verify-co`
则
请求手机号三要素认证(简版)的完整http请求地址为:
GET请求
```
https://xxxxxxxxxx.next.bspapp.com/http/uni-cloud-verify-co/mobile3MetaVerify?realName=姓名&idCard=身份证&mobile=手机号&key=通讯密钥
```
请求手机号三要素认证(详版)的完整http请求地址为:
GET请求
```
https://xxxxxxxxxx.next.bspapp.com/http/uni-cloud-verify-co/mobile3MetaVerifyPro?realName=姓名&idCard=身份证&mobile=手机号&key=通讯密钥
```
请求手机号二要素认证的完整http请求地址为:
GET请求
```
https://xxxxxxxxxx.next.bspapp.com/http/uni-cloud-verify-co/mobile2MetaVerify?realName=姓名&mobile=手机号&key=通讯密钥
```
docs/uni-rpia/mobile-2meta-verify/dev.md
已删除
100644 → 0
浏览文件 @
2b4579a6
# 开发指南
> 注意:暂只支持连接云端,不支持连接本地运行
## 接口说明@introduce
通过对比权威数据源,对用户上传的姓名、手机号进行验证,校验此二要素是否一致
-
只支持移动,电信,联通下发的手机卡,广电号暂不支持
## 添加 uni-cloud-verify 扩展库依赖@extend
在需要调用此API的云函数或云对象右键,添加依赖
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/b866f119-1427-49ba-b3a1-7915cebd5624.png
)
勾选 uni-cloud-verify 扩展库依赖
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/665b7307-7506-42ad-ad3f-6c7c1d59569f.png
)
## API@api
### 响应公共字段@publicreturn
|字段 |类型 |说明 |
|:-: |:-: |:- |
|errCode|Number |为0代表请求成功,其他均为请求失败,注意,请求成功不代表验证通过 |
|errMsg |String |请求失败的错误描述 |
|data |Object | 请求成功时,服务端返回的数据 |
### 获取uni认证管理对象@getuniverifymanager
云端在操作前,需要先获取 uniVerifyManager 对象实例,然后再通过 uniVerifyManager.xxx 调用对应的API
**云端代码**
```
js
const
uniVerifyManager
=
uniCloud
.
getUniVerifyManager
({
provider
:
"
univerify
"
});
```
**请求参数**
|参数名 |类型 |必填 |默认值 |说明 |
|:-: |:-: |:-: |:-: |:- |
|provider |String |是 |- |必填,当前固定填写 univerify 即可 |
### 获取手机号二要素认证结果@mobile2metaverify
接口名:mobile2MetaVerify
你可以在调用 extStorageManager.mobile2MetaVerify 前执行一些自己的业务逻辑,判断用户是否有权限执行此API等等
**云端代码**
```
js
const
uniVerifyManager
=
uniCloud
.
getUniVerifyManager
({
provider
:
"
univerify
"
});
let
verifyRes
=
await
uniVerifyManager
.
mobile2MetaVerify
({
realName
:
"
姓名
"
,
mobile
:
"
手机号
"
,
});
console
.
log
(
'
认证结果:
'
,
verifyRes
.
data
);
```
**请求参数**
|参数名 |类型 |必填 |默认值 |说明 |
|:- |:-: |:-: |:-: |:- |
|realName |String |是 |- |姓名 |
|mobile |String |是 |- |手机号 |
**响应参数**
响应字段如下,响应通用字段已省略,详细见
[
响应公共字段
](
#publicreturn
)
|名称 |类型 |必须返回 |描述 |
|:- |:-: |:-: |:- |
|status |Number |是 |认证结果,1-通过 2-不通过 3-查无结果 0-待定 |
|reasonType |Number |否 |原因详情:
<br/>
2-认证不一致
<br/>
3-查无此手机号
<br/>
4-认证信息格式错误
<br/>
7-结果获取失败,请重试 |
|logId |String |是 |本次请求日志id,可以根据该标识在控制台查询结果 |
|isPayed |Number |是 |本次请求是否收费标识,1代表收费,0代表不收费 |
|mobileType |String |是 |运营商类型:1-移动,2-联通,3- 电信,9,-未知 |
**响应体示例**
```
json
{
"errCode"
:
0
,
"errMsg"
:
""
,
"data"
:
{
"status"
:
1
,
"reasonType"
:
1
,
"logId"
:
"9f9def8638c74506b3f5ef17f893c8b9"
,
"isPayed"
:
1
,
"mobileType"
:
"3"
,
"note"
:
""
}
}
```
## 外部系统通过http方式调用接口@http
[
点击查看
](
../common/http
)
docs/uni-rpia/mobile-2meta-verify/price.md
已删除
100644 → 0
浏览文件 @
2b4579a6
## 费用说明
接口名称:手机号二要素认证
### 资源包价格
|规格(次数) |价格(元) | 单价(元) |
|-- |-- |-- |
|20(限购1个) |4.2 |0.21 |
|100 |30 |0.3 |
|200 |58 |0.29 |
|500 |140 |0.28 |
|1000 |270 |0.27 |
|2000 |520 |0.26 |
|5000 |1250 |0.25 |
|10000 |2400 |0.24 |
|20000 |4600 |0.23 |
|50000 |11000 |0.22 |
|100000 |21000 |0.21 |
docs/uni-rpia/mobile-2meta-verify/service.md
已删除
100644 → 0
浏览文件 @
2b4579a6
## 业务开通
### 开通流程
使用开发者账号登录
[
uniCloud控制台
](
https://unicloud.dcloud.net.cn/
)
,选择
`手机号实名核验`
栏目。在使用此功能前需要完成实名认证,可前往
[
开发者中心
](
https://dev.dcloud.net.cn/pages/user/info
)
完成实名认证。
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/292ad9fe-971e-4ff3-8ee6-0a3178119003.png
)
点击进入后会自动开通对应业务
### 购买资源包
手机号二要素认证为预付费业务,使用之前,需要先进行购买资源包。点击页面上的“购买资源包”按钮,购买相应的资源包(目前只支持资源包的付费方式)
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/9dc8f614-f913-4de4-8b8d-213a5b144a98.png
)
### 安全配置
系统提供了 uniCloud 服务空间白名单安全配置,可以提高接口调用安全性,防止被他人盗用。可点击“添加”按钮,选择相应的服务空间完成添加服务空间白名单,服务空间添加成功后,只有列表中的服务空间才可以调用API。此列表为空时,不校验调用方的服务空间。
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/b3ae2f7b-8cb6-4043-b97c-f29a812de55b.png
)
### 调用记录
可查看API的调用记录,但此业务数据量较大,为了维持服务的稳定性,只能查看30天内的某1天的全部调用记录,默认选择当天。
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/5225b726-af8e-47ee-95e4-9cfc02c5e6bf.png
)
### 调用统计
可查看按天分组的调用趋势、调用数量统计
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/6b991fbd-37d7-4d71-b616-a96e220e600d.png
)
\ No newline at end of file
docs/uni-rpia/mobile-3meta-verify-pro/price.md
已删除
100644 → 0
浏览文件 @
2b4579a6
## 费用说明
接口名称:手机号三要素认证(详版)
### 资源包价格
|规格(次数) |价格(元) | 单价(元) |
|-- |-- |-- |
|20(限购1个) |5 |0.25 |
|100 |34 |0.34 |
|200 |66 |0.33 |
|500 |160 |0.32 |
|1000 |310 |0.31 |
|2000 |600 |0.3 |
|5000 |1450 |0.29 |
|10000 |2800 |0.28 |
|20000 |5400 |0.27 |
|50000 |13000 |0.26 |
|100000 |25000 |0.25 |
docs/uni-rpia/mobile-3meta-verify-pro/service.md
已删除
100644 → 0
浏览文件 @
2b4579a6
## 业务开通
### 开通流程
使用开发者账号登录
[
uniCloud控制台
](
https://unicloud.dcloud.net.cn/
)
,选择
`手机号实名核验`
栏目。在使用此功能前需要完成实名认证,可前往
[
开发者中心
](
https://dev.dcloud.net.cn/pages/user/info
)
完成实名认证。
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/292ad9fe-971e-4ff3-8ee6-0a3178119003.png
)
点击进入后会自动开通对应业务
### 购买资源包
手机号三要素认证(详版)为预付费业务,使用之前,需要先进行购买资源包。点击页面上的“购买资源包”按钮,购买相应的资源包(目前只支持资源包的付费方式)
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/2e382604-ec95-4c80-bd4d-46c1af4166de.png
)
### 安全配置
系统提供了 uniCloud 服务空间白名单安全配置,可以提高接口调用安全性,防止被他人盗用。可点击“添加”按钮,选择相应的服务空间完成添加服务空间白名单,服务空间添加成功后,只有列表中的服务空间才可以调用API。此列表为空时,不校验调用方的服务空间。
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/cfdad51a-7fe7-4b64-ac44-179256f5d591.png
)
### 调用记录
可查看API的调用记录,但此业务数据量较大,为了维持服务的稳定性,只能查看30天内的某1天的全部调用记录,默认选择当天。
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/139ffc0b-32a4-495c-87dc-6c99fec1611d.png
)
### 调用统计
可查看按天分组的调用趋势、调用数量统计
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/8d392a1a-efbd-4f39-955d-c25d38df1bda.png
)
\ No newline at end of file
docs/uni-rpia/mobile-3meta-verify/dev.md
已删除
100644 → 0
浏览文件 @
2b4579a6
# 开发指南
> 注意:暂只支持连接云端,不支持连接本地运行
## 接口说明@introduce
通过对比权威数据源,对用户上传的姓名、身份证号和手机号进行验证,校验此三要素是否一致
-
支持携号转网,支持阿里宝卡、腾讯王卡等互联网公司与运营合作推出的手卡
-
只支持移动,电信,联通下发的手机主卡,广电号暂不支持
-
不支持物联网卡、虚拟运营商卡(如阿里小号)
## 添加 uni-cloud-verify 扩展库依赖@extend
在需要调用此API的云函数或云对象右键,添加依赖
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/b866f119-1427-49ba-b3a1-7915cebd5624.png
)
勾选 uni-cloud-verify 扩展库依赖
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/665b7307-7506-42ad-ad3f-6c7c1d59569f.png
)
## API@api
### 响应公共字段@publicreturn
|字段 |类型 |说明 |
|:-: |:-: |:- |
|errCode|Number |为0代表请求成功,其他均为请求失败,注意,请求成功不代表验证通过 |
|errMsg |String |请求失败的错误描述 |
|data |Object | 请求成功时,服务端返回的数据 |
### 获取uni认证管理对象@getuniverifymanager
云端在操作前,需要先获取 uniVerifyManager 对象实例,然后再通过 uniVerifyManager.xxx 调用对应的API
**云端代码**
```
js
const
uniVerifyManager
=
uniCloud
.
getUniVerifyManager
({
provider
:
"
univerify
"
});
```
**请求参数**
|参数名 |类型 |必填 |默认值 |说明 |
|:-: |:-: |:-: |:-: |:- |
|provider |String |是 |- |必填,当前固定填写 univerify 即可 |
### 获取手机号三要素认证结果@mobile3metaverify
接口名:mobile3MetaVerify
你可以在调用 extStorageManager.mobile3MetaVerify 前执行一些自己的业务逻辑,判断用户是否有权限执行此API等等
**云端代码**
```
js
const
uniVerifyManager
=
uniCloud
.
getUniVerifyManager
({
provider
:
"
univerify
"
});
let
verifyRes
=
await
uniVerifyManager
.
mobile3MetaVerify
({
realName
:
"
姓名
"
,
idCard
:
"
身份证
"
,
mobile
:
"
手机号
"
,
});
console
.
log
(
'
认证结果:
'
,
verifyRes
.
data
);
```
**请求参数**
|参数名 |类型 |必填 |默认值 |说明 |
|:- |:-: |:-: |:-: |:- |
|realName |String |是 |- |姓名 |
|idCard |String |是 |- |身份证 |
|mobile |String |是 |- |手机号 |
**响应参数**
响应字段如下,响应通用字段已省略,详细见
[
响应公共字段
](
#publicreturn
)
|名称 |类型 |必须返回 |描述 |
|:- |:-: |:-: |:- |
|status |Number |是 |认证结果,1-通过 2-不通过 3-查无结果 0-待定 |
|reasonType |Number |否 |原因详情:
<br/>
2-认证不一致
<br/>
3-该手机号查询无记录
<br/>
4-认证信息有误
<br/>
5-号码状态异常(空号、停机等)
<br/>
6-解析手机号运营商失败
<br/>
7-其他出错 |
|logId |String |是 |本次请求日志id,可以根据该标识在控制台查询结果 |
|isPayed |Number |是 |本次请求是否收费标识,1代表收费,0代表不收费 |
|mobileType |String |是 |运营商类型:1-移动,2-联通,3- 电信,9,-未知 |
**响应体示例**
```
json
{
"errCode"
:
0
,
"errMsg"
:
""
,
"data"
:
{
"status"
:
1
,
"reasonType"
:
1
,
"logId"
:
"9f9def8638c74506b3f5ef17f893c8b9"
,
"isPayed"
:
1
,
"mobileType"
:
"3"
,
"note"
:
""
}
}
```
## 外部系统通过http方式调用接口@http
[
点击查看
](
../common/http
)
docs/uni-rpia/mobile-
3meta-verify-pro
/dev.md
→
docs/uni-rpia/mobile-
verify
/dev.md
浏览文件 @
a81fca77
...
...
@@ -10,16 +10,6 @@
-
只支持移动,电信,联通下发的手机主卡,广电号暂不支持
-
不支持物联网卡、虚拟运营商卡(如阿里小号)
## 详版对比简版优势@introducepro
手机号三要素认证(详版)比手机号三要素认证(简版)在响应参数 reasonType 上有区别,以下是详版专属返回的类型
-
20:手机号已实名,姓名正确,但证件号错误
-
21:手机号已实名,证件号正确,但姓名错误
-
22:手机号已实名,但证件号和姓名均非该手机号绑定信息
因此详版优势为:在认证不一致时,会有更多的提示信息,方便用户排查问题。
## 添加 uni-cloud-verify 扩展库依赖@extend
在需要调用此API的云函数或云对象右键,添加依赖
...
...
@@ -58,11 +48,124 @@ const uniVerifyManager = uniCloud.getUniVerifyManager({
|:-: |:-: |:-: |:-: |:- |
|provider |String |是 |- |必填,当前固定填写 univerify 即可 |
### 获取手机号三要素认证(详版)结果@mobile3metaverify
接口名:mobile3MetaVerifyPro
### 获取手机号二要素认证结果@mobile2eleverify
接口名:mobile2EleVerify
你可以在调用 extStorageManager.mobile2EleVerify 前执行一些自己的业务逻辑,判断用户是否有权限执行此API等等
**云端代码**
```
js
const
uniVerifyManager
=
uniCloud
.
getUniVerifyManager
({
provider
:
"
univerify
"
});
let
verifyRes
=
await
uniVerifyManager
.
mobile2EleVerify
({
realName
:
"
姓名
"
,
mobile
:
"
手机号
"
,
});
console
.
log
(
'
认证结果:
'
,
verifyRes
.
data
);
```
**请求参数**
|参数名 |类型 |必填 |默认值 |说明 |
|:- |:-: |:-: |:-: |:- |
|realName |String |是 |- |姓名 |
|mobile |String |是 |- |手机号 |
**响应参数**
响应字段如下,响应通用字段已省略,详细见
[
响应公共字段
](
#publicreturn
)
|名称 |类型 |必须返回 |描述 |
|:- |:-: |:-: |:- |
|status |Number |是 |认证结果,1-通过 2-不通过 3-查无结果 0-待定 |
|reasonType |Number |否 |原因详情:
<br/>
2-认证不一致
<br/>
3-查无此手机号
<br/>
4-认证信息格式错误
<br/>
7-结果获取失败,请重试 |
|logId |String |是 |本次请求日志id,可以根据该标识在控制台查询结果 |
|isPayed |Number |是 |本次请求是否收费标识,1代表收费,0代表不收费 |
|mobileType |String |是 |运营商类型:1-移动,2-联通,3- 电信,9,-未知 |
**响应体示例**
```
json
{
"errCode"
:
0
,
"errMsg"
:
""
,
"data"
:
{
"status"
:
1
,
"reasonType"
:
1
,
"logId"
:
"9f9def8638c74506b3f5ef17f893c8b9"
,
"isPayed"
:
1
,
"mobileType"
:
"3"
,
"note"
:
""
}
}
```
### 获取手机号三要素(简版)认证结果@mobile3eleverify
接口名:mobile3EleVerify
你可以在调用 extStorageManager.mobile3EleVerify 前执行一些自己的业务逻辑,判断用户是否有权限执行此API等等
**云端代码**
```
js
const
uniVerifyManager
=
uniCloud
.
getUniVerifyManager
({
provider
:
"
univerify
"
});
let
verifyRes
=
await
uniVerifyManager
.
mobile3EleVerify
({
realName
:
"
姓名
"
,
idCard
:
"
身份证
"
,
mobile
:
"
手机号
"
,
});
console
.
log
(
'
认证结果:
'
,
verifyRes
.
data
);
```
**请求参数**
|参数名 |类型 |必填 |默认值 |说明 |
|:- |:-: |:-: |:-: |:- |
|realName |String |是 |- |姓名 |
|idCard |String |是 |- |身份证 |
|mobile |String |是 |- |手机号 |
**响应参数**
响应字段如下,响应通用字段已省略,详细见
[
响应公共字段
](
#publicreturn
)
|名称 |类型 |必须返回 |描述 |
|:- |:-: |:-: |:- |
|status |Number |是 |认证结果,1-通过 2-不通过 3-查无结果 0-待定 |
|reasonType |Number |否 |原因详情:
<br/>
2-认证不一致
<br/>
3-该手机号查询无记录
<br/>
4-认证信息有误
<br/>
5-号码状态异常(空号、停机等)
<br/>
6-解析手机号运营商失败
<br/>
7-其他出错 |
|logId |String |是 |本次请求日志id,可以根据该标识在控制台查询结果 |
|isPayed |Number |是 |本次请求是否收费标识,1代表收费,0代表不收费 |
|mobileType |String |是 |运营商类型:1-移动,2-联通,3- 电信,9,-未知 |
你可以在调用 extStorageManager.mobile3MetaVerifyPro 前执行一些自己的业务逻辑,判断用户是否有权限执行此API等等
**响应体示例**
```
json
{
"errCode"
:
0
,
"errMsg"
:
""
,
"data"
:
{
"status"
:
1
,
"reasonType"
:
1
,
"logId"
:
"9f9def8638c74506b3f5ef17f893c8b9"
,
"isPayed"
:
1
,
"mobileType"
:
"3"
,
"note"
:
""
}
}
```
### 获取手机号三要素认证(详版)结果@mobile3eleverify
接口名:mobile3EleVerifyPro
你可以在调用 extStorageManager.mobile3EleVerifyPro 前执行一些自己的业务逻辑,判断用户是否有权限执行此API等等
**云端代码**
...
...
@@ -70,7 +173,7 @@ const uniVerifyManager = uniCloud.getUniVerifyManager({
const
uniVerifyManager
=
uniCloud
.
getUniVerifyManager
({
provider
:
"
univerify
"
});
let
verifyRes
=
await
uniVerifyManager
.
mobile3
Meta
VerifyPro
({
let
verifyRes
=
await
uniVerifyManager
.
mobile3
Ele
VerifyPro
({
realName
:
"
姓名
"
,
idCard
:
"
身份证
"
,
mobile
:
"
手机号
"
,
...
...
@@ -117,4 +220,163 @@ console.log('认证结果: ', verifyRes.data);
## 外部系统通过http方式调用接口@http
[
点击查看
](
../common/http
)
1.
新建云对象
`uni-cloud-verify-co`
,云对象名字可自己修改,这里以
`uni-cloud-verify-co`
为例。
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/56e57aba-9c24-4482-b0f0-328e3b88242d.png
)
在弹窗的窗口中选择云对象,输入名称 uni-cloud-verify-co
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/f1575aef-48de-4ea9-bee7-4e73ce8325dc.png
)
2.
修改云对象下的
`package.json`
文件,完整替换内容如下
```
js
{
"
name
"
:
"
uni-cloud-verify-co
"
,
"
dependencies
"
:
{},
"
extensions
"
:
{
"
uni-cloud-verify
"
:
{}
},
"
cloudfunction-config
"
:
{
"
concurrency
"
:
1
,
"
memorySize
"
:
512
,
"
path
"
:
"
/http/uni-cloud-verify-co
"
,
"
timeout
"
:
60
,
"
triggers
"
:
[],
"
runtime
"
:
"
Nodejs18
"
}
}
```
3.
修改云对象下的
`index.obj.js`
文件,完整替换内容如下
**注意:请修改变量apiKey的值为你的通讯密钥**
如果你自己有更好的安全验证逻辑,可自行修改
`_before`
内的逻辑
```
js
const
apiKey
=
"
xxxxxx
"
;
// 请替换为你的通讯密钥
const
uniVerifyManager
=
uniCloud
.
getUniVerifyManager
({
provider
:
"
univerify
"
,
});
class
MyError
extends
Error
{
constructor
(
err
)
{
super
();
this
.
err
=
err
;
}
}
module
.
exports
=
{
_before
:
function
()
{
const
params
=
this
.
getParams
();
const
data
=
params
[
0
]
||
params
;
// 验证通讯密钥
if
(
data
.
key
!==
apiKey
)
{
throw
new
MyError
({
code
:
-
1
,
msg
:
"
非法请求
"
});
}
},
_after
:
function
(
error
,
result
)
{
if
(
error
)
{
if
(
error
.
err
)
{
return
error
.
err
;
}
throw
error
;
}
return
result
},
// 手机号三要素认证(简版)
async
mobile3EleVerify
(
data
)
{
let
{
realName
,
idCard
,
mobile
,
}
=
data
;
const
res
=
await
uniVerifyManager
.
mobile3EleVerify
({
realName
,
idCard
,
mobile
});
return
res
;
},
// 手机号三要素认证(详版)
async
mobile3EleVerifyPro
(
data
)
{
let
{
realName
,
idCard
,
mobile
,
}
=
data
;
const
res
=
await
uniVerifyManager
.
mobile3EleVerifyPro
({
realName
,
idCard
,
mobile
});
return
res
;
},
// 手机号二要素认证
async
mobile2EleVerify
(
data
)
{
let
{
realName
,
idCard
,
mobile
,
}
=
data
;
const
res
=
await
uniVerifyManager
.
mobile2EleVerify
({
realName
,
idCard
,
mobile
});
return
res
;
}
}
```
4.
上传云对象
`uni-cloud-verify-co`
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/828ae99b-21b1-4967-a987-26ef9eea4824.png
)
5.
查看http接口地址,登录
[
uniCloud控制台
](
https://unicloud.dcloud.net.cn/
)
,进入空间详情,点击左侧菜单 - 云函数/云对象 - 函数/对象列表,进入 uni-cloud-verify-co 的详情
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/8bd9c241-fdea-41a1-9547-86ce03005257.png
)
6.
进入详情后点击右下方的复制路径按钮
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/133c5359-503f-4d4b-b648-cdf86b5a4c66.png
)
假设复制的路径是:
`https://xxxxxxxxxx.next.bspapp.com/http/uni-cloud-verify-co`
则
请求手机号三要素认证(简版)的完整http请求地址为:
GET请求
```
https://xxxxxxxxxx.next.bspapp.com/http/uni-cloud-verify-co/mobile3EleVerify?realName=姓名&idCard=身份证&mobile=手机号&key=通讯密钥
```
请求手机号三要素认证(详版)的完整http请求地址为:
GET请求
```
https://xxxxxxxxxx.next.bspapp.com/http/uni-cloud-verify-co/mobile3EleVerifyPro?realName=姓名&idCard=身份证&mobile=手机号&key=通讯密钥
```
请求手机号二要素认证的完整http请求地址为:
GET请求
```
https://xxxxxxxxxx.next.bspapp.com/http/uni-cloud-verify-co/mobile2EleVerify?realName=姓名&mobile=手机号&key=通讯密钥
```
\ No newline at end of file
docs/uni-rpia/mobile-
3meta-
verify/price.md
→
docs/uni-rpia/mobile-verify/price.md
浏览文件 @
a81fca77
## 费用说明
接口名称:手机号三要素认证(简版)
手机号实名核验API的付费方式仅支持资源包形式
### 资源包价格
#### 手机号二要素认证
|规格(次数) |价格(元) | 单价(元) |
|-- |-- |-- |
|20(限购1个) |4.2 |0.21 |
|100 |30 |0.3 |
|200 |58 |0.29 |
|500 |140 |0.28 |
|1000 |270 |0.27 |
|2000 |520 |0.26 |
|5000 |1250 |0.25 |
|10000 |2400 |0.24 |
|20000 |4600 |0.23 |
|50000 |11000 |0.22 |
|100000 |21000 |0.21 |
#### 手机号三要素认证(简版)
|规格(次数) |价格(元) | 单价(元) |
|-- |-- |-- |
|20(限购1个) |4.6 |0.23 |
...
...
@@ -18,4 +36,18 @@
|50000 |12000 |0.24 |
|100000 |23000 |0.23 |
#### 手机号三要素认证(详版)
|规格(次数) |价格(元) | 单价(元) |
|-- |-- |-- |
|20(限购1个) |5 |0.25 |
|100 |34 |0.34 |
|200 |66 |0.33 |
|500 |160 |0.32 |
|1000 |310 |0.31 |
|2000 |600 |0.3 |
|5000 |1450 |0.29 |
|10000 |2800 |0.28 |
|20000 |5400 |0.27 |
|50000 |13000 |0.26 |
|100000 |25000 |0.25 |
docs/uni-rpia/mobile-
3meta-
verify/service.md
→
docs/uni-rpia/mobile-verify/service.md
浏览文件 @
a81fca77
##
业务开通
##
进入控制台
### 开通流程
使用开发者账号登录
[
uniCloud控制台
](
https://unicloud.dcloud.net.cn/
)
,选择
`手机号实名核验`
栏目。在使用此功能前需要完成实名认证,可前往
[
开发者中心
](
https://dev.dcloud.net.cn/pages/user/info
)
完成实名认证。
使用开发者账号登录
[
uniCloud控制台
](
https://unicloud.dcloud.net.cn/
)
,选择
`手机号实名核验`
栏目。在使用此功能前需要完成实名认证,可前往
[
开发者中心
](
https://dev.dcloud.net.cn/pages/user/info
)
完成实名认证。
![](
https://web-ext-storage.dcloud.net.cn/unicloud/uni-rpia/292ad9fe-971e-4ff3-8ee6-0a3178119003.png
)
点击进入后会自动开通对应业务
### 购买资源包
手机号三要素认证(简版)为预付费业务,使用之前,需要先进行购买资源包。点击页面上的“购买资源包”按钮,购买相应的资源包(目前只支持资源包的付费方式)
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录