API开发文档 - 道一云

开发说明

开发说明

功能说明：表单流程数据回调接口，表单负责人审核通过或关闭表单后或者在管理后台特别设置了数据接口节点中，平台回调外部系统。

流程数据回调不成功时，排查是否出现以下情况：
1、检查表单设置 “填单设置 -> 高级设置” 中是否勾选数据接口，并开启对应节点的回调。
2、如果表单更换了流程，需要重新勾选开启回调的节点。

请求方式：POST（HTTPS）
请求地址：http://www.domain.com.cn/callbackapi?type=FORM_CALLBACK(示例链接，不能作为实际使用)

请求包体：

{
	"approvers":"小李,小张",
	"closePerson":"do1chenhandong",
	"closeReason":"同意。",
	"closeTime":"2017-07-05",
	"createaTime":"2017-07-05",
	"creator":"do1chenhandong",
	"currentNode":"财务审批",
	"currentNodeId":"f38e5ca7-d732-4774-8427-1737844b0f51",
	"data":
	{
		"fd2TNqGMpFhEBdB38K":"020-10964827",
		"fd5hob6F0t3XmI3S7g":"好好学习\r\n天天向上",
		"fd98XoXP9ymJvCFH7F":"1.69",
		"fd9bzaJoBf26WNb7an":"大本",
		"fdD8c59xlgHBIVzzWm":
		[
			"打球",
			"K歌"
		],
		"fdHS8BrzQSe5YIJ3Uu":"20000",
		"fdIJLJZi4aTM49WlZB":"9",
		"fdOPjjasyQ5JItj2Rd":
		[
			"/upload/img/b17efb43292e4cc9ac5d0b46bce059c4/20160420/f48752453daf4533a4170a7675eb25ae.jpg",
			"/upload/img/b17efb43292e4cc9ac5d0b46bce059c4/20170621/e8637ae7569f4ec29cdad764f4b8468a.jpeg"
		],
		"fdPFhAkyCpBDjbFbgm":"08:30",
		"fdWDSoTeCWJsmHRmS6":
		[
			{
				"fs0eCcCR2Bw1Ja6yKk":"阿娟",
				"fs7aW4up4VmmmJ1bM5":"29000000",
				"fs9KWyQY47KpxMVGBi":"12:12",
				"fsLrK08XvFrkykrOFu":"1983-12-12",
				"fsRunPTEKKfkXIoraD":"10",
				"fsVXBaR5SiWZOVHfEy":"441481198312120013",
				"fsYPSYuxNpSXarY2PC":"http://www.baidu.com/",
				"fsZTtIVG6dlmCjaXfJ":"020-00002222",
				"fse5Hcj2PPsIfwVZiU":"25",
				"fsgBGSJXTu1DcjWmLV":"女",
				"fsgaUlgVH4p209FDb0":"13900002222",
				"fsi6LJVGpPIrX29DvF":"姐",
				"fsjkeb4q68LjsfQaAf":"介绍介绍介绍介绍",
				"fsov2BMKpklfZenQRm":
				[
					"/upload/img/b17efb43292e4cc9ac5d0b46bce059c4/20160420/f48752453daf4533a4170a7675eb25ae.jpg",
					"/upload/img/b17efb43292e4cc9ac5d0b46bce059c4/20170621/e8637ae7569f4ec29cdad764f4b8468a.jpeg"
				],
				"fsqUqcJeNiEo78Vmzj":"juanjuan@do1.com.cn",
				"fsvXkksmsrukMjri0C":"35",
				"fszp6t5oeEsswJx3Uc":
				[
					"作曲",
					"K歌",
					"打球"
				]

			},
			{
				"fs0eCcCR2Bw1Ja6yKk":"阿丽",
				"fs7aW4up4VmmmJ1bM5":"19000000",
				"fs9KWyQY47KpxMVGBi":"12:12",
				"fsLrK08XvFrkykrOFu":"2003-12-12",
				"fsRunPTEKKfkXIoraD":"8",
				"fsVXBaR5SiWZOVHfEy":"441481200312120013",
				"fsYPSYuxNpSXarY2PC":"http://www.baidu.com/",
				"fsZTtIVG6dlmCjaXfJ":"020-00002222",
				"fse5Hcj2PPsIfwVZiU":"45",
				"fsgBGSJXTu1DcjWmLV":"女",
				"fsgaUlgVH4p209FDb0":"13900002222",
				"fsi6LJVGpPIrX29DvF":"姐",
				"fsjkeb4q68LjsfQaAf":"介绍介绍介绍介绍",
				"fsov2BMKpklfZenQRm":"/upload/img/b17efb43292e4cc9ac5d0b46bce059c4/20160420/f48752453daf4533a4170a7675eb25ae.jpg",
				"fsqUqcJeNiEo78Vmzj":"lili@do1.com.cn",
				"fsvXkksmsrukMjri0C":"15",
				"fszp6t5oeEsswJx3Uc":
				[
					"K歌",
					"打球",
					"作曲"
				]

			}

		],
		"fdYy8YJy0cZFt9l1ma":"1999-12-12",
		"fdeBZFegijVlPuw2G2":"13710964827",
		"fdeqYO1RJ8XUdNGMlD":"广东省:梅州市:兴宁市",
		"fdg7Y2z0blC7e5A7F4":"62",
		"fdhJiImL5ZJsBEPKfx":"http://www.baidu.com/",
		"fdhMBnlQljbB5bsoxl":"chenhandong@do1.com.cn",
		"fdiDWCVxZB2NPH5MUb":"21.7",
		"fdiXNEapyioD0pcmI5":"东东",
		"fdlPKNospgq2isrhp1":
		[
			{
				"000_departmentName":"润美康-vip客户-福建省-胡建阳-18519091813",
				"001_deptFullName":"2016级50班->润美康-vip客户-福建省-胡建阳-18519091813"
			},
			{
				"000_departmentName":"智能科技",
				"001_deptFullName":"2016级50班->智能科技"
			},
			{
				"000_departmentName":"1班",
				"001_deptFullName":"2016级50班->1班"
			}

		],
		"fdp0cHivoDGOLgMBxz":"球类运动:羽毛球",
		"fdpFnzZI2XhUqHzd8K":"441481199912120013",
		"fdrfTEaWlcYQubdaEb":
		[
			{
				"000_clientName":"潜在客户",
				"001_clientCode":"20170314155903"
			}

		],
		"fdthmMNYsgcEKjB6gP":"暂未从网页版获取到位置信息",
		"fdvNxuwN0AdvPWIinn":
		[
			{
				"000_personName":"庄剑",
				"004_sex":"1"
			},
			{
				"000_personName":"杨奇",
				"004_sex":"1"
			},
			{
				"000_personName":"马阳",
				"002_nickName":"ww1",
				"004_sex":"1"
			},
			{
				"000_personName":"谭强",
				"002_nickName":"风a",
				"004_sex":"1"
			}

		],
		"fdwiW1lzS7UL7DS6UE":"男",
		"fdzQMKcxccy0F5yWfs":"2017-06-20 13:54:00",
		"fo1b45334082034cb28e154cefdf8d79de":
		[
			{
				"fo78acdef04f094437816e767e577ca8de":"被关联"
			},
			{
				"fo78acdef04f094437816e767e577ca8de":"GHI3"
			},
			{
				"fo78acdef04f094437816e767e577ca8de":"被关联"
			}

		]

	},
	"definitionVersionsId":"dvidqbtXq0vvsEhWEQDi",
	"flowAuditStatus":1,
	"formTitle":"接口表单测试标题2",
	"id":"bb9ecfe-c03464c-05a17-e2fbb45bed4a3",
	"instanceTitle":"东东的简历8",
	"isClose":"1",
	"isover":"1",
	"nodeId":"2cc84790-6de9-4d3b-986f-7610a76252a2",
	"nodeName":"经理审批",
	"nodeRelative":"陈先生",
	"nodeRelativeAccount":"chensir",
	"nodeSuggestion":"同意。",
	"signImage":"/upload/img/1dca4756172e43318391487a5a68d59c/20180314/9e793f2918524c39aff1546b2bceaf9b.png",
	"status":"1"
}

请求参数说明：

参数名	释义	类型	是否必须	备注
type	回调接口类型	String	是	固定FORM_CALLBACK
timestamp	时间戳	Long	是	传递从北京时间1970年1月1日上午八点整到现在的毫秒数，用于校验消息的及时性
data参数,以json 格式传送
id	work工单明细id	String	是
definitionVersionsId	form表单id	String	是
status	表单状态	String	否	0，草稿 1，提交
creator	表单创建者账号	String	是
createaTime	表单创建时间	String	否	yyyy-MM-dd HH:mm:ss
closeTime	表单关闭时间	String	否	yyyy-MM-dd HH:mm:ss
closePerson	表单关闭账号	String	否
closeReason	表单关闭原因	String	否
isClose	是否已关闭	Int	否	1，是 0，否
isover	是否已完结	Int	否	-1，关闭 0，退审 1，全部审核通过 2，流转中
formTitle	表单标题	String	否
instanceTitle	表单数据标题	String	否
nodeId	回调节点Id	String	否	节点审核回调时必填
nodeName	回调节点名称	String	否	节点审核回调时必填
nodeRelativeAccount	回调节点审核人账号	String	否	节点审核回调时必填
nodeRelative	回调节点审核人姓名	String	否	节点审核回调时必填
nodeSuggestion	回调节点审批意见	String	否	节点审核回调时必填
flowAuditStatus	回调节点操作结果	Int	否	1，审批，未结束 2，审批，结束 3，退审，到提单人 4，关闭 5，退审，到指定节点 6，撤回，到提单节点 7，撤回，到上一节点 8，关闭，审批人关闭 9，退审，到外部提单人 13，撤回，到外部提单人
signImage	当前节点审批签名	String	否
currentNodeId	当前节点Id	String	否
currentNode	待办节点名称	String	否
approvers	待办当前处理人姓名	String	否	多个处理人用','英文逗号隔开,超过100字截断打点显示
data	数据json	Object	否	{ 字段id1:值, 字段id2:值, …. 子表单:[{ 子表单子段1:值, 子表单子段2:值 … }] } 值格式参考附录4和示例

返回结果：

{
	"code":"0",
	"desc":"接收成功"
}

企业微信

表单流程数据回调接口

开发说明