Search Message Rules¶
查询消息规则。
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.2/message-service/rule/search
请求参数(Header)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
Authorization |
可选 |
String |
身份识别。 |
请求参数(URI)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
orgId |
必需 |
String |
组织 ID。 |
请求参数(Body)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
appId |
可选 |
String |
应用 ID。 |
identifier |
可选 |
String |
用户或用户组 ID。 |
identifierType |
可选 |
Integer |
绑定类型。0 为用户,1 为用户组。 |
ruleIds |
必需 |
List |
消息规则 ID 列表。 |
createdBy |
可选 |
String |
消息规则的创建者。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
messageRuleList |
MessageRuleDTO 结构体 |
消息规则列表。 |
MessageRuleDTO 结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
appId |
String |
应用 ID。 |
ruleId |
String |
消息规则 ID。 |
ruleName |
String |
消息规则名称。 |
relations |
relationDTO 结构体 |
消息规则关联的用户或用户组。 |
messageRule |
Object |
消息规则。 |
isEnable |
Integer |
规则是否启用。 |
createdBy |
String |
创建者。 |
createdAt |
String |
创建时间。 |
updatedBy |
String |
更新者。 |
updatedAt |
String |
更新时间。 |
deletedBy |
String |
删除者。 |
deletedAt |
String |
删除时间。 |
relationDTO 结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
type |
Integer |
类型。0为用户,1为用户组。 |
identifiers |
List |
用户或用户组 ID。 |
错误码¶
代码 |
描述 |
---|---|
31400 |
组织 ID 为空。 |
31404 |
组织、应用或消息规则不存在,或组织未购买应用。 |
31600 |
消息规则内容异常。 |
31601 |
用户消息规则数量超过阈值。 |
31602 |
规则中 mark 数量超过阈值。 |
31603 |
消息规则不匹配。 |
31604 |
消息规则 mark 为空。 |
31607 |
用户组织结构错误。 |
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.2/message-service/rule/search?orgId=your_org_id
method: POST
requestBody:
{
"appId": "your_app_id",
"ruleIds": ["your_rule_id_1","your_rule_id_2"],
"identifier": "your_user_id",
"identifierType": 0,
"createdBy": "your_user_id"
}
返回示例¶
{
"code": 0,
"message": "OK",
"data": {
"messageRuleList": [
{
"appId": "",
"ruleId": "",
"ruleName": "",
"relations": [
{
"type": 0,
"identifiers": ["your_user_id_1","your_user_id_2"]
},
{
"type": 1,
"identifiers": ["your_user_group_id"]
}
],
"messageRule": {
"mark1": ["siteA","siteB"],
"mark2": ["deviceA","deviceB"],
"mark3": ["fault"],
"mark4": [""],
"mark6": null
},
"isEnable": 1,
"createdBy": "your_user_id",
"createdAt": "2021-01-01 00:00:00",
"updatedBy": "your_user_id",
"updatedAt": "2021-01-01 00:00:00",
"deletedAt": null,
"deletedBy": null
}
]
}
}