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

注：专业版支持代码通过连接编码调用账户连接，查看详情

示例

• 实名认证（运营商三要素验证）

• 物流查询
  

• 企业工商信息查询

• 自定义模板文字识别

• 自定义模板文字识别（带表格）

账户

账户用于第三方验证连接者身份，选项来自于已配置账户，选择提供此连接服务的第三方账户。例如，连接阿里云API市场的运营商三要素验证服务，选择配置阿里云API市场第三方的账户。

请求

连接时第三方需要接收数据，知道连接者想要连接什么服务和数据，在氚云配置连接请求，发送请求数据至第三方。

请求由URL、Query、Header和Body组成，不同第三方的不同服务的请求配置不同，请根据连接服务的API文档配置请求。如果Query、Header和Body添加请求参数，请求参数名称必填，请求参数默认值选填，之后可在表单配置表单字段与请求参数的数据关联规则，从而引用表单数据作为请求数据。

示例

连接阿里云API市场的运营商三要素验证服务，验证身份证号、手机号和姓名是否真实和一致。

在服务详情页的API接口，调用地址对应的是URL（图中URL需要将http(s)改为https），请求方式对应请求方式，请求参数Headers、Query和Body分别对应Header、Query和Body。Body类型使用默认选项，拥有3个必选的请求参数，因此新增3个名称分别为idcard、mobile、name的Body请求参数（名称需要与API接口文档一致）

注：配置详情见连接运营商三要素验证服务

返回

连接成功后第三方返回数据，氚云需要明确接收什么数据。

返回格式：支持Json

返回数据：返回参数名称必填，返回参数的值需要通过JsonPath获取返回数据中的指定数据作为参数值。

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

示例

连接阿里云API市场的运营商三要素验证服务，验证身份证号、手机号和姓名是否真实和一致，在服务详情页的API接口，返回类型对应返回格式，返回示例对应返回数据。连接成功后，返回验证结果（一致、不一致、无记录、异常）、性别、生日和身份证地址。连接失败后，返回错误码和错误信息。因此我们添加6个返回参数（验证结果、性别、生日、地址、错误码、错误信息），通过Json Path（可直接配置或在调试中配置）获取指定返回数据。

常见问题

连接报错

• 400报错：请求参数不符合第三方要求，请检查配置。例如，第三方要求请求参数必填，调试时未填写参数值，第三方要求图表参数格式为base64，调试时填写的图片url等

• 如果第三方服务收费，请检查余额