示例:连接运营商三要素验证服务
行业协会举办线下沙龙,支持线上报名,为了报名信息真实准确性,连接阿里云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、表单调用
打开表单外链,填写姓名、手机号、身份证号,点击实名认证,连接成功后,提交表单。