ThingsKit物联网平台API文档-监控运维（消息管理-消息配置）

云腾小编

2024年11月5日2024年11月4日

新增消息配置

接口地址:/api/yt/message

请求方式:POST

请求数据类型:application/x-www-form-urlencoded,application/json

响应数据类型:*/*

请求示例:

{
  "config": {},
  "configName": "",
  "createTime": "",
  "creator": "",
  "defaultConfig": "",
  "description": "",
  "enabled": false,
  "icon": "",
  "id": "",
  "messageType": "",
  "name": "",
  "platformType": "",
  "remark": "",
  "roleIds": [],
  "status": 0,
  "tenantExpireTime": "",
  "tenantId": "",
  "tenantProfileId": "",
  "tenantStatus": "",
  "updateTime": "",
  "updater": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型
messageConfigDTO	MessageConfigDTO	body	true	MessageConfigDTO
config	消息相关json配置		false	JsonNode
configName	配置名称		false	string
createTime	创建时间		false	string(date-time)
creator	创建用户		false	string
defaultConfig	租户默认配置		false	string
description	租户描述		false	string
enabled	租户状态：启用/禁用		false	boolean
icon	租户图标		false	string
id	ID		false	string
messageType	消息类型		false	string
name	租户名称		false	string
platformType	短信平台类型		false	string
remark	备注		false	string
roleIds	租户角色列表		false	array
status	状态：0禁用 1启用		false	integer(int32)
tenantExpireTime	租户到期时间		false	string(date-time)
tenantId	租户ID		false	string
tenantProfileId	租户配置		false	string
tenantStatus	可用值:DISABLED,EXPIRED,NORMAL		false	string
updateTime	更新时间		false	string(date-time)
updater	更新用户		false	string

响应参数:

参数名称	参数说明	类型
code		integer(int32)
data		MessageConfigDTO
config	消息相关json配置	JsonNode
configName	配置名称	string
createTime	创建时间	string(date-time)
creator	创建用户	string
defaultConfig	租户默认配置	string
description	租户描述	string
enabled	租户状态：启用/禁用	boolean
icon	租户图标	string
id	ID	string
messageType	消息类型	string
name	租户名称	string
platformType	短信平台类型	string
remark	备注	string
roleIds	租户角色列表	array
status	状态：0禁用 1启用	integer(int32)
tenantExpireTime	租户到期时间	string(date-time)
tenantId	租户ID	string
tenantProfileId	租户配置	string
tenantStatus	可用值:DISABLED,EXPIRED,NORMAL	string
updateTime	更新时间	string(date-time)
updater	更新用户	string
message		string

响应示例:

{
	"code": 0,
	"data": {
		"config": {},
		"configName": "",
		"createTime": "",
		"creator": "",
		"defaultConfig": "",
		"description": "",
		"enabled": false,
		"icon": "",
		"id": "",
		"messageType": "",
		"name": "",
		"platformType": "",
		"remark": "",
		"roleIds": [],
		"status": 0,
		"tenantExpireTime": "",
		"tenantId": "",
		"tenantProfileId": "",
		"tenantStatus": "",
		"updateTime": "",
		"updater": ""
	},
	"message": ""
}

修改消息配置

接口地址:/api/yt/message

请求方式:PUT

请求数据类型:application/x-www-form-urlencoded,application/json

响应数据类型:*/*

请求示例:

{
  "config": {},
  "configName": "",
  "createTime": "",
  "creator": "",
  "defaultConfig": "",
  "description": "",
  "enabled": false,
  "icon": "",
  "id": "",
  "messageType": "",
  "name": "",
  "platformType": "",
  "remark": "",
  "roleIds": [],
  "status": 0,
  "tenantExpireTime": "",
  "tenantId": "",
  "tenantProfileId": "",
  "tenantStatus": "",
  "updateTime": "",
  "updater": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型
messageConfigDTO	MessageConfigDTO	body	true	MessageConfigDTO
config	消息相关json配置		false	JsonNode
configName	配置名称		false	string
createTime	创建时间		false	string(date-time)
creator	创建用户		false	string
defaultConfig	租户默认配置		false	string
description	租户描述		false	string
enabled	租户状态：启用/禁用		false	boolean
icon	租户图标		false	string
id	ID		false	string
messageType	消息类型		false	string
name	租户名称		false	string
platformType	短信平台类型		false	string
remark	备注		false	string
roleIds	租户角色列表		false	array
status	状态：0禁用 1启用		false	integer(int32)
tenantExpireTime	租户到期时间		false	string(date-time)
tenantId	租户ID		false	string
tenantProfileId	租户配置		false	string
tenantStatus	可用值:DISABLED,EXPIRED,NORMAL		false	string
updateTime	更新时间		false	string(date-time)
updater	更新用户		false	string

响应参数:

参数名称	参数说明	类型
config	消息相关json配置	JsonNode
configName	配置名称	string
createTime	创建时间	string(date-time)
creator	创建用户	string
defaultConfig	租户默认配置	string
description	租户描述	string
enabled	租户状态：启用/禁用	boolean
icon	租户图标	string
id	ID	string
messageType	消息类型	string
name	租户名称	string
platformType	短信平台类型	string
remark	备注	string
roleIds	租户角色列表	array
status	状态：0禁用 1启用	integer(int32)
tenantExpireTime	租户到期时间	string(date-time)
tenantId	租户ID	string
tenantProfileId	租户配置	string
tenantStatus	可用值:DISABLED,EXPIRED,NORMAL	string
updateTime	更新时间	string(date-time)
updater	更新用户	string

响应示例:

{
	"config": {},
	"configName": "",
	"createTime": "",
	"creator": "",
	"defaultConfig": "",
	"description": "",
	"enabled": false,
	"icon": "",
	"id": "",
	"messageType": "",
	"name": "",
	"platformType": "",
	"remark": "",
	"roleIds": [],
	"status": 0,
	"tenantExpireTime": "",
	"tenantId": "",
	"tenantProfileId": "",
	"tenantStatus": "",
	"updateTime": "",
	"updater": ""
}

删除消息配置

接口地址:/api/yt/message

请求方式:DELETE

请求数据类型:application/x-www-form-urlencoded,application/json

响应数据类型:*/*

请求示例:

{
  "ids": [],
  "tenantId": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型
deleteDTO	DeleteDTO	body	true	DeleteDTO
ids	删除ID列表		true	array
tenantId	租户ID		false	string

响应参数:

参数名称	参数说明	类型
code		integer(int32)
data		string
message		string

响应示例:

{
	"code": 0,
	"data": "",
	"message": ""
}

消息配置分页

接口地址:/api/yt/message{?messageType,orderFiled,orderType,page,pageSize,platformType,status}

请求方式:GET

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

请求参数:

参数名称	参数说明	是否必须	数据类型
page	page	true	int
pageSize	pageSize	true	int
platformType	platformType	false	string
messageType	messageType	false	string
status	status	false	integer(int32)
orderFiled	orderFiled	false	string
orderType	orderType,可用值:ASC,DESC	false	string

响应参数:

参数名称	参数说明	类型
items		array
config	消息相关json配置	JsonNode
configName	配置名称	string
createTime	创建时间	string(date-time)
creator	创建用户	string
defaultConfig	租户默认配置	string
description	租户描述	string
enabled	租户状态：启用/禁用	boolean
icon	租户图标	string
id	ID	string
messageType	消息类型	string
name	租户名称	string
platformType	短信平台类型	string
remark	备注	string
roleIds	租户角色列表	array
status	状态：0禁用 1启用	integer(int32)
tenantExpireTime	租户到期时间	string(date-time)
tenantId	租户ID	string
tenantProfileId	租户配置	string
tenantStatus	可用值:DISABLED,EXPIRED,NORMAL	string
updateTime	更新时间	string(date-time)
updater	更新用户	string
total		integer(int32)

响应示例:

{
	"items": [
		{
			"config": {},
			"configName": "",
			"createTime": "",
			"creator": "",
			"defaultConfig": "",
			"description": "",
			"enabled": false,
			"icon": "",
			"id": "",
			"messageType": "",
			"name": "",
			"platformType": "",
			"remark": "",
			"roleIds": [],
			"status": 0,
			"tenantExpireTime": "",
			"tenantId": "",
			"tenantProfileId": "",
			"tenantStatus": "",
			"updateTime": "",
			"updater": ""
		}
	],
	"total": 0
}