阿里云市场接口配置文档——氚云篇

更新时间：2024-06-20

● 介绍	● 账户配置	● 连接配置
● 表单配置	● 表单调用

1. 介绍

在氚云中配置国阳云服务，可以实现以下场景：

短信发送：可以发送各类验证码、通知、营销等信息。
身份证实名认证：验证表单填写姓名、身份证号是否一致。
手机实名认证：验证表单填写姓名、身份证号和手机号等是否一致。
银行卡实名认证：验证表单填写姓名、身份证号和手机号、银行卡号等是否一致。

1.1 零代码使用流程

账户配置：用于验证连接者身份，前往阿里云平台，注册并登录，开通和购买服务，之后在氚云插件中心配置账户。
连接配置：根据API接口文档，配置请求和返回参数。
表单配置：配置连接何时何地被触发调用，调用时数据关联规则。
表单调用

1.2 代码使用流程

无需配置中间层webservice，实现系统集成-氚云调用第三方接口，通过代码调用InvokeApi直接连接第三方API接口，详情见开发者手册。

2. 账户配置

账户：用于第三方验证连接者的身份，配置流程如下：

2.1 前往阿里云市场订购国阳云相关服务
2.1.1 在阿里云市场，搜索“国阳”，或者直接进入国阳云店铺，选择并订购服务。

2.1.2 选择合适的套餐规格，点击“立即购买”。

2.1.3 购买成功后，前往阿里云控制台，在“已购买的服务”中，获取AppCode信息。

特别提醒：
请务必防止信息泄露。阿里云云市场所有服务的AppCode相同，因此只需要配置一个阿里云API市场账户，用此账户配置多个连接，连接阿里云API市场多个服务。

2.2 在氚云插件中心配置账户
2.2.1 登录氚云，打开“插件中心”。

2.2.2 点击“新增”创建账户。

2.2.3 第三方选择“阿里云API市场”，然后输入已获取的“AppCode”。

3. 连接配置

氚云连接第三方服务或数据，请求时，发送氚云指定数据至第三方，返回时，接收第三方指定数据至氚云

3.1 打开国阳云的商品页面，查看并准备好参数配置数据，如下图:
3.1.1 请求配置

3.1.2 返回示例

3.2 在插件中心，打开“连接”菜单，新增连接

3.3 对照国阳商品详情页面，填写和选择各项参数
3.3.1 账户
用于验证连接者身份，选项来自于已配置账户。选择“阿里云市场”
3.3.2 请求
请求由请求方式、URL、Query、Header和Body组成，请根据连接服务的API文档配置请求。请求参数名称必填（名称需要与API接口文档一致），请求参数默认值选填，之后可在氚云表单中，配置表单字段与请求参数的数据关联规则，从而引用表单数据作为请求数据。

注意：
URL需要将http(s)改为https，或者http。

3.3.3 返回
返回格式：支持Json
返回数据：返回参数名称必填，返回参数的值需要通过JsonPath获取返回数据中的指定数据作为参数值。了解如何配置JsonPath获取返回参数值

4. 表单配置

连接之前，在氚云表单中，配置连接何时何地被触发调用，配置连接时表单数据传输至连接请求，配置连接成功且接收返回数据后将返回数据传输至表单数据。

4.1 组合控件配置
4.1.1 如您在国阳云模板配置中设置了多个变量，则在发送时，变量值需要通过接口参数param进行赋值。可以在表单中，配置一个文本组合控件（如：姓名+日期），与param关联。如下图：