ThingsKit物联网平台API文档-系统管理（菜单管理）

云腾小编

2024年11月15日2024年11月14日

getMyMenus（待翻译）

接口地址:/api/yt/admin/me/menus{?needButton}

请求方式:GET

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

响应数据类型:*/*

请求参数:

响应参数:

参数名称	参数说明	类型
caseSensitive	区分大小写	boolean
children	子节点	array
caseSensitive	区分大小写	boolean
children	子节点	array
component	组件路径	string
createTime	创建时间	string(date-time)
creator	创建用户	string
id	ID	string
meta	元数据	JsonNode
name	菜单名称	string
parentId	上级ID	string
path	路由地址	string
permission	权限标识	string
redirect	重定向地址	string
sort	排序字段	integer(int32)
type	菜单类型,可用值:CUSTOM,SYSADMIN	string
updateTime	更新时间	string(date-time)
updater	更新用户	string
component	组件路径	string
createTime	创建时间	string(date-time)
creator	创建用户	string
id	ID	string
meta	元数据	JsonNode
name	菜单名称	string
parentId	上级ID	string
path	路由地址	string
permission	权限标识	string
redirect	重定向地址	string
sort	排序字段	integer(int32)
type	菜单类型,可用值:CUSTOM,SYSADMIN	string
updateTime	更新时间	string(date-time)
updater	更新用户	string

响应示例:

[
	{
		"caseSensitive": false,
		"children": [
			{
				"caseSensitive": false,
				"children": [],
				"component": "",
				"createTime": "",
				"creator": "",
				"id": "",
				"meta": "",
				"name": "",
				"parentId": "",
				"path": "",
				"permission": "",
				"redirect": "",
				"sort": 0,
				"type": "",
				"updateTime": "",
				"updater": ""
			}
		],
		"component": "",
		"createTime": "",
		"creator": "",
		"id": "",
		"meta": {},
		"name": "",
		"parentId": "",
		"path": "",
		"permission": "",
		"redirect": "",
		"sort": 0,
		"type": "",
		"updateTime": "",
		"updater": ""
	}
]

assignMenuToTenant（待翻译）

接口地址:/api/yt/admin/menu/assign/{tenantId}

请求方式:PUT

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

响应数据类型:*/*

接口描述:

请求示例:

[]

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型
tenantId	tenantId	path	true	string
strings	string	body	true	array

响应参数:

暂无

响应示例:

getMenus（待翻译）

接口地址:/api/yt/admin/menu/getAll

请求方式:GET

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

响应数据类型:*/*

请求参数:

暂无

响应参数:

参数名称	参数说明	类型
caseSensitive	区分大小写	boolean
children	子节点	array
caseSensitive	区分大小写	boolean
children	子节点	array
component	组件路径	string
createTime	创建时间	string(date-time)
creator	创建用户	string
id	ID	string
meta	元数据	JsonNode
name	菜单名称	string
parentId	上级ID	string
path	路由地址	string
permission	权限标识	string
redirect	重定向地址	string
sort	排序字段	integer(int32)
type	菜单类型,可用值:CUSTOM,SYSADMIN	string
updateTime	更新时间	string(date-time)
updater	更新用户	string
component	组件路径	string
createTime	创建时间	string(date-time)
creator	创建用户	string
id	ID	string
meta	元数据	JsonNode
name	菜单名称	string
parentId	上级ID	string
path	路由地址	string
permission	权限标识	string
redirect	重定向地址	string
sort	排序字段	integer(int32)
type	菜单类型,可用值:CUSTOM,SYSADMIN	string
updateTime	更新时间	string(date-time)
updater	更新用户	string

响应示例:

[
	{
		"caseSensitive": false,
		"children": [
			{
				"caseSensitive": false,
				"children": [],
				"component": "",
				"createTime": "",
				"creator": "",
				"id": "",
				"meta": "",
				"name": "",
				"parentId": "",
				"path": "",
				"permission": "",
				"redirect": "",
				"sort": 0,
				"type": "",
				"updateTime": "",
				"updater": ""
			}
		],
		"component": "",
		"createTime": "",
		"creator": "",
		"id": "",
		"meta": {},
		"name": "",
		"parentId": "",
		"path": "",
		"permission": "",
		"redirect": "",
		"sort": 0,
		"type": "",
		"updateTime": "",
		"updater": ""
	}
]

updateTenant（待翻译）

接口地址:/api/yt/admin/tenant

请求方式:PUT

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

响应数据类型:*/*

请求示例:

{
  "createTime": "",
  "creator": "",
  "defaultConfig": "",
  "description": "",
  "enabled": false,
  "icon": "",
  "id": "",
  "name": "",
  "roleIds": [],
  "tenantExpireTime": "",
  "tenantId": "",
  "tenantProfileId": "",
  "tenantStatus": "",
  "updateTime": "",
  "updater": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型
tenantDTO	TenantDTO	body	true	TenantDTO

响应参数:

参数名称	参数说明	类型
createTime	创建时间	string(date-time)
creator	创建用户	string
defaultConfig	租户默认配置	string
description	租户描述	string
enabled	租户状态：启用/禁用	boolean
icon	租户图标	string
id	ID	string
name	租户名称	string
roleIds	租户角色列表	array
tenantExpireTime	租户到期时间	string(date-time)
tenantId	租户ID	string
tenantProfileId	租户配置	string
tenantStatus	可用值:DISABLED,EXPIRED,NORMAL	string
updateTime	更新时间	string(date-time)
updater	更新用户	string

响应示例:

{
	"createTime": "",
	"creator": "",
	"defaultConfig": "",
	"description": "",
	"enabled": false,
	"icon": "",
	"id": "",
	"name": "",
	"roleIds": [],
	"tenantExpireTime": "",
	"tenantId": "",
	"tenantProfileId": "",
	"tenantStatus": "",
	"updateTime": "",
	"updater": ""
}

deleteTenant（待翻译）

接口地址:/api/yt/admin/tenant

请求方式:DELETE

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

响应数据类型:*/*

接口描述:

请求示例:

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

请求参数:

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

响应参数:

参数名称	参数说明	类型
errorCode	Platform error code:\n2 – General error (HTTP: 500 – Internal Server Error)\n\n10 – Authentication failed (HTTP: 401 – Unauthorized)\n\n11 – JWT token expired (HTTP: 401 – Unauthorized)\n\n15 – Credentials expired (HTTP: 401 – Unauthorized)\n\n20 – Permission denied (HTTP: 403 – Forbidden)\n\n30 – Invalid arguments (HTTP: 400 – Bad Request)\n\n31 – Bad request params (HTTP: 400 – Bad Request)\n\n32 – Item not found (HTTP: 404 – Not Found)\n\n33 – Too many requests (HTTP: 429 – Too Many Requests)\n\n34 – Too many updates (Too many updates over Websocket session)\n\n* 40 – Subscription violation (HTTP: 403 – Forbidden)	object
message	Error message	string
status	HTTP Response Status Code	integer(int32)
timestamp	Timestamp	string(date-time)

响应示例:

{}

createTenantAdmin（待翻译）

接口地址:/api/yt/admin/tenant/adminUser{?sendEmail,sendMsg}

请求方式:POST

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

响应数据类型:*/*

请求示例:

{
  "accountExpireTime": "",
  "activateToken": "",
  "avatar": "",
  "createTime": "",
  "creator": "",
  "customerId": "",
  "email": "",
  "enabled": false,
  "hasPassword": false,
  "id": "",
  "level": 0,
  "organizationIds": [],
  "password": "",
  "phoneNumber": "",
  "realName": "",
  "remark": "",
  "roleIds": [],
  "roles": [
    {
      "roleId": "",
      "roleName": ""
    }
  ],
  "tbUser": "",
  "tenantId": "",
  "tenantName": "",
  "updateTime": "",
  "updater": "",
  "userStatusEnum": "",
  "username": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型
userDTO	UserDTO	body	true	UserDTO

响应参数:

参数名称	参数说明	类型
accountExpireTime	账号失效时间	string(date-time)
activateToken	激活token	string
avatar	头像	string
createTime	创建时间	string(date-time)
creator	创建用户	string
customerId	客户ID	string
email	邮箱	string
enabled	账号状态	boolean
hasPassword	是否已重置密码	boolean
id	ID	string
level	角色级别：0：超级管理员；1：平台管理员 2：租户账号 3：租户下的账号	integer(int32)
organizationIds	所辖组织ids	array
password	密码	string
phoneNumber	电话号码	string
realName	真实名称	string
remark	备注	string
roleIds	角色ids	array
roles	角色信息列表	array
roleId	角色ID	string
roleName	角色名称	string
tbUser	TB的UserId	string
tenantId	租户ID	string
tenantName	租户名称	string
updateTime	更新时间	string(date-time)
updater	更新用户	string
userStatusEnum	用户状态,可用值:DISABLED,EXPIRED,NORMAL	string
username	用户名	string

响应示例:

{
	"accountExpireTime": "",
	"activateToken": "",
	"avatar": "",
	"createTime": "",
	"creator": "",
	"customerId": "",
	"email": "",
	"enabled": false,
	"hasPassword": false,
	"id": "",
	"level": 0,
	"organizationIds": [],
	"password": "",
	"phoneNumber": "",
	"realName": "",
	"remark": "",
	"roleIds": [],
	"roles": [
		{
			"roleId": "",
			"roleName": ""
		}
	],
	"tbUser": "",
	"tenantId": "",
	"tenantName": "",
	"updateTime": "",
	"updater": "",
	"userStatusEnum": "",
	"username": ""
}

getTenant（待翻译）

接口地址:/api/yt/admin/tenant/getById/{id}

请求方式:GET

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

响应数据类型:*/*

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型
id	id	path	true	string

响应参数:

参数名称	参数说明	类型
createTime	创建时间	string(date-time)
creator	创建用户	string
defaultConfig	租户默认配置	string
description	租户描述	string
enabled	租户状态：启用/禁用	boolean
icon	租户图标	string
id	ID	string
name	租户名称	string
roleIds	租户角色列表	array
tenantExpireTime	租户到期时间	string(date-time)
tenantId	租户ID	string
tenantProfileId	租户配置	string
tenantStatus	可用值:DISABLED,EXPIRED,NORMAL	string
updateTime	更新时间	string(date-time)
updater	更新用户	string

响应示例:

{
	"createTime": "",
	"creator": "",
	"defaultConfig": "",
	"description": "",
	"enabled": false,
	"icon": "",
	"id": "",
	"name": "",
	"roleIds": [],
	"tenantExpireTime": "",
	"tenantId": "",
	"tenantProfileId": "",
	"tenantStatus": "",
	"updateTime": "",
	"updater": ""
}

pageUser（待翻译）

接口地址:/api/yt/admin/tenant/page{?orderFiled,orderType,page,pageSize,tenantName}

请求方式:GET

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

响应数据类型:*/*

请求参数:

参数名称	参数说明	是否必须	数据类型
page	page	true	int
pageSize	pageSize	true	int

响应参数:

参数名称	参数说明	类型
items		array
createTime	创建时间	string(date-time)
creator	创建用户	string
defaultConfig	租户默认配置	string
description	租户描述	string
enabled	租户状态：启用/禁用	boolean
icon	租户图标	string
id	ID	string
name	租户名称	string
roleIds	租户角色列表	array
tenantExpireTime	租户到期时间	string(date-time)
tenantId	租户ID	string
tenantProfileId	租户配置	string
tenantStatus	可用值:DISABLED,EXPIRED,NORMAL	string
updateTime	更新时间	string(date-time)
updater	更新用户	string
total		integer(int32)

响应示例:

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

getTenantRolesByTenantId（待翻译）

接口地址:/api/yt/admin/tenant/roles/{tenantId}

请求方式:GET

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

响应数据类型:*/*

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型
tenantId	tenantId	path	true	string

响应参数:

参数名称	参数说明	类型
errorCode	Platform error code:\n2 – General error (HTTP: 500 – Internal Server Error)\n\n10 – Authentication failed (HTTP: 401 – Unauthorized)\n\n11 – JWT token expired (HTTP: 401 – Unauthorized)\n\n15 – Credentials expired (HTTP: 401 – Unauthorized)\n\n20 – Permission denied (HTTP: 403 – Forbidden)\n\n30 – Invalid arguments (HTTP: 400 – Bad Request)\n\n31 – Bad request params (HTTP: 400 – Bad Request)\n\n32 – Item not found (HTTP: 404 – Not Found)\n\n33 – Too many requests (HTTP: 429 – Too Many Requests)\n\n34 – Too many updates (Too many updates over Websocket session)\n\n* 40 – Subscription violation (HTTP: 403 – Forbidden)	object
message	Error message	string
status	HTTP Response Status Code	integer(int32)
timestamp	Timestamp	string(date-time)

响应示例:

[
	{}
]

updateOrCreateTenant（待翻译）

接口地址:/api/yt/admin/tenant/updateOrCreateTenant

请求方式:POST

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

响应数据类型:*/*

请求示例:

{
  "defaultConfig": "",
  "description": "",
  "enabled": true,
  "icon": "",
  "id": "",
  "name": "",
  "roleIds": [],
  "tenantExpireTime": "",
  "tenantId": "",
  "tenantProfileId": {
    "entityType": "TENANT_PROFILE",
    "id": "784f394c-42b6-435a-983c-b7beff2784f9"
  },
  "tenantStatus": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型
tenantReqDTO	TenantReqDTO	body	true	TenantReqDTO
name			true	string
roleIds			true	array
entityType	string,可用值:TENANT_PROFILE		true	string
id	ID of the entity, time-based UUID v1		true	string

响应参数:

参数名称	参数说明	类型
createTime	创建时间	string(date-time)
creator	创建用户	string
defaultConfig	租户默认配置	string
description	租户描述	string
enabled	租户状态：启用/禁用	boolean
icon	租户图标	string
id	ID	string
name	租户名称	string
roleIds	租户角色列表	array
tenantExpireTime	租户到期时间	string(date-time)
tenantId	租户ID	string
tenantProfileId	租户配置	string
tenantStatus	可用值:DISABLED,EXPIRED,NORMAL	string
updateTime	更新时间	string(date-time)
updater	更新用户	string

响应示例:

{
	"createTime": "",
	"creator": "",
	"defaultConfig": "",
	"description": "",
	"enabled": false,
	"icon": "",
	"id": "",
	"name": "",
	"roleIds": [],
	"tenantExpireTime": "",
	"tenantId": "",
	"tenantProfileId": "",
	"tenantStatus": "",
	"updateTime": "",
	"updater": ""
}

deleteTenantAdmin（待翻译）

接口地址:/api/yt/admin/user/deleteTenantAdmin

请求方式:DELETE

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

响应数据类型:*/*

请求示例:

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

请求参数:

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

响应参数:

参数名称	参数说明	类型
errorCode	Platform error code:\n2 – General error (HTTP: 500 – Internal Server Error)\n\n10 – Authentication failed (HTTP: 401 – Unauthorized)\n\n11 – JWT token expired (HTTP: 401 – Unauthorized)\n\n15 – Credentials expired (HTTP: 401 – Unauthorized)\n\n20 – Permission denied (HTTP: 403 – Forbidden)\n\n30 – Invalid arguments (HTTP: 400 – Bad Request)\n\n31 – Bad request params (HTTP: 400 – Bad Request)\n\n32 – Item not found (HTTP: 404 – Not Found)\n\n33 – Too many requests (HTTP: 429 – Too Many Requests)\n\n34 – Too many updates (Too many updates over Websocket session)\n\n* 40 – Subscription violation (HTTP: 403 – Forbidden)	object
message	Error message	string
status	HTTP Response Status Code	integer(int32)
timestamp	Timestamp	string(date-time)

响应示例:

{}

2022年1月22日

云腾五洲科技2022年春节放假通知

2022年3月17日

团队就地解散！苹果汽车彻底“凉凉”了；华为最新全屋智能售价4万，简直比去年便宜太多；全球股市大反弹，抄底人赚翻？| 物联网头条

2022年3月19日

ThingsKit物联网平台API文档-系统管理（菜单管理）

getMyMenus（待翻译）

assignMenuToTenant（待翻译）

getMenus（待翻译）

updateTenant（待翻译）

deleteTenant（待翻译）

createTenantAdmin（待翻译）

getTenant（待翻译）

pageUser（待翻译）

getTenantRolesByTenantId（待翻译）

updateOrCreateTenant（待翻译）

deleteTenantAdmin（待翻译）

Related Articles

云腾五洲科技2022年春节放假通知

团队就地解散！苹果汽车彻底“凉凉”了；华为最新全屋智能售价4万，简直比去年便宜太多；全球股市大反弹，抄底人赚翻？| 物联网头条

罗永浩拿上亿分手费？传交个朋友天价买账号；百度被裁员工爆料：团队曾超额完成业绩；华为自研编程语言可试用；中芯国际换帅 | 物联网头条