明道云集成我司API接口范例
有个客户购买了我司的智能快递地址解析接口,需要集成到明道云系统,所以写这个教程帮助大家。
第一步,在明道云创建如下表单
其中第二个解析地址查询按钮为:左侧组件–高级–API查询
第二步,在集成中心添加API
点击 解析地址 查询按钮 在右侧 选择调用已集成的API,在弹出窗口的左下方选择 去集成中心添加
第三步,创建自定义连接
在集成中心,选择左侧的 API集成–连接与认证
右侧页面选择 我的连接,点击创建 自定义连接
第四步,选择鉴权方式为 APIkey或无需授权
第五步,开始创建API
选择API管理,点击下方创建API按钮
最重要的页面来了
在这个页面一步步来
A、输入参数配置
B、API请求参数配置
注意下图的参数配置,header中APPCODE和后面的值有一个空格
点击 下方测试API按钮,弹出地址填写窗口,输入后可请求成功(注意此处填写的内容不得有空格)
成功返回如下:得到以下内容则保存返回
第六步,处理输入参数空格报错问题(明道云bug)
选择插入代码,选择Javascript代码
按下图添加如下代码,(注意该代码为固定格式,第一个text为后续API获取的参数,第一个text为前一步输入的text,为了方便统一命名,注意区分)
output = {text: input.text.replace(" ", "")}
保存返回后,进入 API请求参数配置
将之前的原始地址改为代码块中输出的地址
保存返回
第七步,输出参数配置
选择需要的参数进行生成
填写对应说明,参考我方文档
进行保存并发布
第八步,回到表单设置
点击 解析地址–查询按钮,右侧 调用已集成API 中选择刚才制作的API
输入参数选择原始的地址字段
设置 将数据写入表单
建立数据与表单字段的映射