阿里云市场接口配置文档——氚云篇
更新时间:2024-06-20
● 介绍 | ● 账户配置 | ● 连接配置 | ● 表单配置 | ● 表单调用 |
1. 介绍
在氚云中配置国阳云服务,可以实现以下场景:
- 短信发送:可以发送各类验证码、通知、营销等信息。
- 身份证实名认证:验证表单填写姓名、身份证号是否一致。
- 手机实名认证:验证表单填写姓名、身份证号和手机号等是否一致。
- 银行卡实名认证:验证表单填写姓名、身份证号和手机号、银行卡号等是否一致。
1.1 零代码使用流程
![1](https://img.alicdn.com/imgextra/i2/59977090/O1CN01Rzvyek22FH4XnvIN0_!!59977090.jpg)
- 账户配置:用于验证连接者身份,前往阿里云平台,注册并登录,开通和购买服务,之后在氚云插件中心配置账户。
- 连接配置:根据API接口文档,配置请求和返回参数。
- 表单配置:配置连接何时何地被触发调用,调用时数据关联规则。
- 表单调用
1.2 代码使用流程
无需配置中间层webservice,实现系统集成-氚云调用第三方接口,通过代码调用InvokeApi直接连接第三方API接口,详情见开发者手册。
2. 账户配置
账户:用于第三方验证连接者的身份,配置流程如下:
2.1 前往阿里云市场订购国阳云相关服务
2.1.1 在阿里云市场,搜索“国阳”,或者直接进入国阳云店铺,选择并订购服务。
![1](https://img.alicdn.com/imgextra/i1/59977090/O1CN01dt5Vhs22FH4ZzaBKM_!!59977090.jpg)
2.1.2 选择合适的套餐规格,点击“立即购买”。
![1](https://img.alicdn.com/imgextra/i1/59977090/O1CN01p5FZwn22FH4ZDiEXC_!!59977090.jpg)
2.1.3 购买成功后,前往阿里云控制台,在“已购买的服务”中,获取AppCode信息。
特别提醒:
请务必防止信息泄露。阿里云云市场所有服务的AppCode相同,因此只需要配置一个阿里云API市场账户,用此账户配置多个连接,连接阿里云API市场多个服务。
请务必防止信息泄露。阿里云云市场所有服务的AppCode相同,因此只需要配置一个阿里云API市场账户,用此账户配置多个连接,连接阿里云API市场多个服务。
![1](https://img.alicdn.com/imgextra/i2/59977090/O1CN01a8Sl6D22FGtrbO5T1_!!59977090.jpg)
2.2 在氚云插件中心配置账户
2.2.1 登录氚云,打开“插件中心”。
![1](https://img.alicdn.com/imgextra/i2/59977090/O1CN01dXZpgO22FH4ZDQzlE_!!59977090.jpg)
2.2.2 点击“新增”创建账户。
![1](https://img.alicdn.com/imgextra/i1/59977090/O1CN01DbKXDF22FH4ZPT8GT_!!59977090.jpg)
2.2.3 第三方选择“阿里云API市场”,然后输入已获取的“AppCode”。
![1](https://img.alicdn.com/imgextra/i1/59977090/O1CN01jEatmr22FH4ZDQvbe_!!59977090.jpg)
3. 连接配置
氚云连接第三方服务或数据,请求时,发送氚云指定数据至第三方,返回时,接收第三方指定数据至氚云
3.1 打开国阳云的商品页面,查看并准备好参数配置数据,如下图:
3.1.1 请求配置
![1](https://img.alicdn.com/imgextra/i2/59977090/O1CN01CHD8rF22FH4arkWHC_!!59977090.jpg)
3.1.2 返回示例
![1](https://img.alicdn.com/imgextra/i4/59977090/O1CN01sAXb2X22FH4bv0iRA_!!59977090.jpg)
3.2 在插件中心,打开“连接”菜单,新增连接
![1](https://img.alicdn.com/imgextra/i1/59977090/O1CN01npK0XO22FH4YGHR93_!!59977090.jpg)
3.3 对照国阳商品详情页面,填写和选择各项参数
3.3.1 账户
用于验证连接者身份,选项来自于已配置账户。选择“阿里云市场”
3.3.2 请求
请求由请求方式、URL、Query、Header和Body组成,请根据连接服务的API文档配置请求。请求参数名称必填(名称需要与API接口文档一致),请求参数默认值选填,之后可在氚云表单中,配置表单字段与请求参数的数据关联规则,从而引用表单数据作为请求数据。
注意:
URL需要将http(s)改为https,或者http。
URL需要将http(s)改为https,或者http。
![1](https://img.alicdn.com/imgextra/i2/59977090/O1CN01ih0jCi22FH4Wgq7ql_!!59977090.jpg)
3.3.3 返回
返回格式:支持Json
返回数据:返回参数名称必填,返回参数的值需要通过JsonPath获取返回数据中的指定数据作为参数值。了解如何配置JsonPath获取返回参数值
![1](https://img.alicdn.com/imgextra/i2/59977090/O1CN01EEf7U422FH4YGHq50_!!59977090.jpg)
4. 表单配置
连接之前,在氚云表单中,配置连接何时何地被触发调用,配置连接时表单数据传输至连接请求,配置连接成功且接收返回数据后将返回数据传输至表单数据。
4.1 组合控件配置
4.1.1 如您在国阳云模板配置中设置了多个变量,则在发送时,变量值需要通过接口参数param进行赋值。可以在表单中,配置一个文本组合控件(如:姓名+日期),与param关联。如下图:
![1](https://img.alicdn.com/imgextra/i2/59977090/O1CN0193y6eC22FH4ZPVD9z_!!59977090.jpg)
4.1.2 组合控件的计算公式,字符串编辑参考下图
![1](https://img.alicdn.com/imgextra/i4/59977090/O1CN01E0VNyY22FH4WKeCvE_!!59977090.jpg)
4.2 按钮控件配置
在表单中,添加按钮控件,控件属性“扩展配置”选择已经配置国阳云连接。
![1](https://img.alicdn.com/imgextra/i4/59977090/O1CN01N0HlZ522FH4WKcb62_!!59977090.jpg)
4.3 扩展配置
4.3.1 请求数据
输入固定值或选择表单字段值传输至国阳连接的请求参数。
![1](https://img.alicdn.com/imgextra/i1/59977090/O1CN01INj0je22FH4XpdrNI_!!59977090.jpg)
4.3.2 返回数据
输入固定值或选择第三方连接返回参数值填充至氚云表单字段。
5. 表单调用
在表单中,填写手机号、姓名和日期后,点击“发送到手机”按钮,连接成功即可发送。
![1](https://img.alicdn.com/imgextra/i4/59977090/O1CN01pwwFYS22FH4UTwih9_!!59977090.jpg)