连接
更新时间: 2023-12-01 浏览次数: {{ hits }}

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

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


示例


账户

账户用于第三方验证连接者身份,选项来自于已配置账户,选择提供此连接服务的第三方账户。例如,连接阿里云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等

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