示例:连接运营商三要素验证服务

行业协会举办线下沙龙,支持线上报名,为了报名信息真实准确性,连接阿里云API市场运营商三要素验证服务,外链表单填写姓名、身份证号和手机号后,进行实名认证才能成功报名。


1、配置账户

前往阿里云API市场,注册并登录,开通和购买运营商三要素验证服务

注:请务必防止信息泄露。


购买成功后,前往阿里云控制台,通过左侧导航栏进入云市场,云市场中的服务对应的就是阿里云API市场服务,获取服务的AppCode信息。


根据获取的服务AppCode信息,在氚云配置账户,第三方选择阿里云API市场。

注:阿里云云市场所有服务的AppCode相同,因此只需要配置一个阿里云API市场账户,用此账户配置多个连接,连接阿里云API市场多个服务,了解更多阿里云API市场账户配置


2、配置连接

根据运营商三要素验证服务的API接口,配置请求的URL(图中URL需要将http(s)改为https)、请求方式、Header、Query和Body。Body类型使用默认选项,拥有3个必选的请求参数,因此新增3个名称分别为idcard、mobile、name的请求参数(名称需要与API接口文档一致)。



配置返回数据:返回数据添加6个返回参数,包括成功时的验证结果(一致、不一致、无记录、异常)(description)、性别(sex)、生日(birthday)和身份证地址(address),失败时的错误码(code)、错误信息(result)。

调试:配置返回参数时,暂时不需要配置返回参数的JsonPath,填写请求参数默认值,点击调试,在调试弹窗中配置JsonPath,确保JsonPath能获取到正确数据作为返回参数值,点击确定。

注:了解如何配置JsonPath获取返回参数值

验证结果:$.result.description

性别:$.result.sex

生日:$.result.birthday

地址:$.result.address

错误码:$.code

错误信息:$.message


3、表单配置

在表单设计,添加扩展按钮控件。


按钮配置中,执行动作选择刚刚配置的连接。


数据关联规则的请求中,“姓名”字段填充至“name”请求参数,“手机号”字段填充至“mobile”请求参数,“身份证号”填充至“idcard”请求参数。

数据关联规则的返回中,“验证结果”返回参数填充至“认证结果”字段。


设置提交校验,认证结果不等于一致时,不允许提交。设置外链填单字段权限,“认证结果”字段不可填写。


4、表单调用

打开表单外链,填写姓名、手机号、身份证号,点击实名认证,连接成功后,提交表单。