create_ticket.md

功能描述

创建单据接口

请求参数

{{ common_args_desc }}

接口参数

字段	类型	必选	描述
service_id	int	否	服务id
creator	string	是	单据创建者
fields	array	是	提单字段
fast_approval	boolean	否	是否为单点快速审批单
meta	dict	否	扩展信息

fields

字段	类型	必选	描述
key	string	是	提单字段唯一标识
value	string	是	提单字段值

meta

字段	类型	必选	描述
callback_url	string	否	回调url，若有则会触发回调
state_processors	object	否	节点处理人，若有则单据流转时会按此处理人设置

请求参数示例

{
	"bk_app_secret": "xxxx",
	"bk_app_code": "xxxx",
	"bk_token": "xxxx",
	"service_id": 17,
	"creator": "xxx",
	"fields": [{
		"key": "title",
		"value": "测试内置审批"
	}, {
		"key": "APPROVER",
		"value": "xx,xxx,xxxx"
	}, {
		"key": "APPROVAL_CONTENT",
		"value": "这是一个审批单"
	}],
	"fast_approval": false,
	"meta": {
		"callback_url": "http://***",
		"state_processors": {
			"407": "xxx,xxxx"
		}
	}
}  

返回结果示例

{
	"result": true,
	"message": "success",
	"code": 0,
	"data": {
		"sn": "NO2019090519542603",
		"id": 101,
		"ticket_url": "http://bk_itsm/#/ticket/detail?id=101"
	}
}

返回结果参数说明

字段	类型	描述
result	bool	返回结果，true为成功，false为失败
code	int	返回码，0表示成功，其他值表示失败
message	string	错误信息
data	object	返回数据

data

字段	类型	描述
sn	string	单号
id	int	单据ID
ticket_url	string	单据链接