连接第三方服务与数据
连接第三方服务与数据（请求与返回配置）
氚云支持连接第三方服务或数据接口。在连接调用过程中：
- 请求时：将氚云中指定的数据发送至第三方服务。
- 返回时：接收第三方返回的数据并写回至氚云。
💡 提示 专业版支持通过代码，使用连接编码调用账户连接，查看详情。
示例
账户说明
账户用于验证第三方服务调用者身份。在配置连接时，需要选择一个已配置的第三方账户，用于当前连接的身份认证。
账户来源说明：
- 账户选项来自
插件中心中已配置的账户。 - 一个连接只能选择一个账户。
- 账户需与当前连接的第三方服务一致。
示例：连接阿里云 API 市场的 运营商三要素验证 服务时，需选择已配置的阿里云 API 市场账户。
请求配置
第三方服务在调用时，需要接收请求数据，用于识别调用的服务类型及校验的数据内容。在氚云中，通过配置请求信息，将数据发送给第三方。
请求组成
请求由以下部分组成：
- URL：第三方接口地址
- 请求方式：GET / POST 等
- Query：URL 查询参数
- Header：请求头参数
- Body：请求体参数
不同第三方、不同接口的请求配置存在差异，请严格按照对应服务的 API 接口文档进行配置。
请求参数配置说明
- 参数名称：必填，需与 API 文档中的参数名保持一致。
- 默认值：选填，可用于调试。
- 配置完成后，可在
表单配置中，将表单字段与请求参数建立数据映射关系，从而将表单数据作为请求参数发送。
请求配置示例：运营商三要素验证
场景说明：连接阿里云 API 市场的 运营商三要素验证 服务，用于校验身份证号、手机号、姓名是否一致。
配置说明：
- API 文档中的
调用地址配置为 URL（需将 http(s) 改为 https）。 - API 文档中的
请求方式配置为请求方式。 - API 文档中的 Headers / Query / Body 分别配置到 Header / Query / Body。
- Body 类型使用默认选项。
- 根据接口文档，新增 3 个必填 Body 参数：
idcard、mobile、name。
💡 提示 参数名称必须与 API 文档保持一致。
详细配置可参考：连接运营商三要素验证服务。
返回配置
连接调用成功后，第三方会返回结果数据，氚云需要明确接收哪些返回数据，以及如何解析。
返回格式
目前支持 JSON 格式返回。
返回参数配置
- 返回参数名称：必填。
- 返回参数值：通过 JsonPath 从返回数据中提取。
返回配置示例：运营商三要素验证
返回说明：
调用成功时，第三方返回：验证结果（一致 / 不一致 / 无记录 / 异常）、性别、出生日期、身份证地址。调用失败时，返回：错误码、错误信息。
配置方式：
- 在连接中新增 6 个返回参数：验证结果、性别、生日、地址、错误码、错误信息。
- 使用 JsonPath（可直接配置，或在调试过程中生成）获取对应返回值。
💡 提示 参考如何配置 JsonPath 获取返回参数值。
常见问题
连接报错（400 错误）
400 错误通常表示请求参数不符合第三方要求，请重点检查：
- API 文档要求的必填参数是否遗漏。
- 调试时是否未填写参数值。
- 参数格式是否符合要求（例如第三方要求 Base64，但填写了图片 URL）。
第三方服务计费问题
- 若第三方服务为收费服务，请检查账户余额。
- 调试调用同样会消耗调用次数。