表单   ->   自定义API调用

第三方数据对接: 表单调用自定义API


红小豆数字通过用户自定义URL,实现和用户第三方数据自动对接。

表单作者通过配置;可以调用用户自定义的URL实现和第三方数据对接。 第三方数据需要满足:

配置


在表单中;点击右上角的【配置】按钮,用户可以开始配置:

Tip: 用户可以自定义对接按钮的名字。

点击上面图片中【具体信息】的按钮,用户可以开始配置信息。

 

参数配置说明


在配置的时候;用户必须提供一个URL。执行这个URL会返回JSON数据。下面是一个例子。

https://app.redbeandata.cn/cubedrive/formRestAPITest/json?apiKey=1234567
{"success":true,"response_code":0,"verbose_msg":"","content":[{"data":"94.237.43.47","now":[{"severity":"high","type":"漏洞利用"},{"severity":"low","type":"扫描"}],"machinename":"10.176.20.9","location":{"country":"荷兰","province":"北荷兰省","city":"阿姆斯特丹"},"asn":"UPCLOUD, FI"}]}
Tip: 只有表单作者可以看到URL地址信息。普通表单使用用户的浏览器没有这个URL信息,也看不到这个信息。URL数据是安全的。

通常情况下;用户需要在URL带一些参数过去。这些参数可以是终端用户在表单中输入。例如:IP地址。

Tip: 参数名字是用户自定义的,并且可以和表单的终端匹配。匹配好之后,系统就会以GET的方式送给第三方以获取信息。

第三方查询返回的信息必须是JSON格式,并且用户还可以和表单字段匹配。结果变量必须以$result开始:

Tip: 如果结果是一个数组;系统以逗号分开。

结果


在配置好之后;普通用户打开表单,点击查询按钮;系统就把返回的结果自动填到表单中。

Tip: 如果参数配置了,用户在填表的时候没有输入参数,系统会自动报错。