阿里宜搭和吉客云接口打通对接实战
数据源平台:阿里宜搭
宜搭是阿里巴巴自研的基于钉钉和阿里云的低代码平台,可让用户通过简单的拖拽、配置即可完成应用搭建,为每个组织提供低门槛、高效率的数字化业务应用生产新模式。有效缩减企业应用开发时间,助力企业数字化升级。
对接目标系统:吉客云
“吉客云”是一站式企业数字化解决方案系统,可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案,“吉客云”具有业务流程更流畅,数据共享更充分,使用成本更低廉等优势。不仅如此,通过“吉链”,可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道,数据对接就像加微信好友一样方便!
系统对接接口配置
通过轻易云系统数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:阿里宜搭,并且选择对应的连接器(关于阿里宜搭的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的搜索表单实例详情列表接口作为数据对接来源。然后再通过写入目标平台配置目标系统为吉客云,并且选择对应连接器。选择对应的客户新增接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。
阿里宜搭接口明细
- API:/yida_vpc/form/searchFormDatas.json
- NAME:搜索表单实例详情列表
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
appType | 应用ID | APP_EQUY89HH94OVSSW0HTU0 | 示例:APP_PBKT0MFBEBTDO8T7SLVP |
systemToken | 应用秘钥 | TL866181GQYUZ7PHZKBO33SDTHYG25YI09GVKS1 | |
userId | 管理员用户钉钉ID | 16000443318138909 | 钉钉的userId |
language | 语言 | zh_CN | |
formUuid | 表单ID | FORM-T2B66FA1XDM0JM0L8KIUHB1BUJBI2Z9CA7V3LD1 | |
instanceStatus | 实例状态 | COMPLETED | |
currentPage | 当前页 | {{PAGINATION_START_PAGE}} | |
pageSize | 每页记录数 | {{PAGINATION_PAGE_SIZE}} | |
originatorId | 数据提交人工号 | | 用户钉钉ID |
createFrom | 创建开始时间 | | |
createTo | 创建结束时间 | | |
modifiedFrom | 修改开始时间 | | |
modifiedTo | 修改结束时间 | | |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
gmtCreate | 创建时间 | | |
gmtModified | 最近修改时间 | | |
originatorUserId | 创建人ID | | |
originator | 创建人 | | |
textField_kvg91fco | 客户编码 | | |
textField_kvg91fcr | 客户名称 | | |
textField_kvg91fcn | 渠道编码 | | |
textField_kvg91fcq | 渠道名称 | | |
吉客云接口明细
- 接口:crm.customer.add
- 接口名称:客户新增
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
customerCode | 客户编号 | string | C201907050001 |
nickname | 客户名称 | string | 张三 |
alias | 别名 | string | 张飞 |
vipLevel | 会员等级id | string | ad1a2w3q1ada65zc5621asd |
vipLevelName | 会员等级名称 | string | 金牌会员 |
contacts | 联系人 | string | 李四 |
country | 国家 | string | 中国 |
state | 省份 | string | 浙江省 |
city | 城市 | string | 杭州市 |
district | 区 | string | 西湖区 |
town | 镇 | string | 三墩镇 |
address | 基本信息地址-地址 | string | 浙江省杭州市西湖区三墩镇 |
detailedAddress | 基本信息地址-详细地址 | string | 西园十路8号笛佛大厦 |
zip | 邮编 | string | 310000 |
gender | 性别(枚举) | string | 0(男),1(女) |
age | 年龄 | string | 18 |
birthday | 生日 | string | 43671 |
calendarType | 生日日期类型(枚举) | string | 0(公历),1(阴历) |
phone | 联系电话 | string | 13588889999 |
email | email | string | 13588889999@163.com |
qq | QQ | string | 1135888899 |
weiXin | 微信 | string | chat11111 |
taxNumber | 开票税号 | string | SH123456798 |
customerManager | 客户经理id | string | a1d56ad1q56da321 |
customerManagerName | 客户经理名称 | string | 王五 |
refereeId | 客户经理名称 | string | 52691345816821 |
referee | 推荐人名称 | string | 王五 |
specialReminding | 特别提醒 | string | 重点客户 |
customerType | 客户类别id | string | ada8z32c1a56asdc |
customerTypeName | 客户类别名称 | string | 类别1 |
系统数据对接
全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务,很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象,减少各业务系统间的维护成本,减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题,将企业数据平滑对接,减少信息竖井。