服务端订阅
更新时间: 2023-04-19

# 获取消费组订阅信息

# 基本信息~~~~

Path: /v1/services/:instanceId/consumers/:consumerGroupId

Method: GET

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
consumerGroupId

# 返回数据

名称类型是否必须默认值备注其他信息
hoststring非必须
portinteger非必须
vhoststring非必须
queuestring非必须

# 重置消费组用户名密码

# 基本信息

Path: /v1/services/:instanceId/consumers/:username/reset

Method: PUT

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
username

Body

# 返回数据

名称类型是否必须默认值备注其他信息
passwordstring非必须

# 创建消费组

# 基本信息

Path: /v1/services/:instanceId/consumers

Method: POST

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId

Body

名称类型是否必须默认值备注其他信息
namestring必须

# 返回数据

名称类型是否必须默认值备注其他信息
consumerGroupIdstring必须^[\u4e00-\u9fa5a-zA-Z0-9\-_]{1,16}$

# 删除消费组

# 基本信息

Path: /v1/services/:instanceId/consumers/:consumer_group_id

Method: DELETE

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
consumer_group_id

Body

# 返回数据

# 获取消费组列表

# 基本信息

Path: /v1/services/:instanceId/consumers

Method: GET

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId

Query

参数名称 是否必须 示例 备注
pageNo
pageSize
orderBy
order

# 返回数据

名称类型是否必须默认值备注其他信息
totalCountnumber非必须100
pageNonumber非必须1
pageSizenumber非必须10
resultobject []非必须

item 类型: object

├─ instanceIdstring非必须
├─ consumerGroupNamestring非必须

mock: @word

├─ consumerGroupIdstring非必须

mock: @character

├─ consumerGroupTypestring非必须DEFAULT 预置|CUSTOM 自定义

枚举: DEFAULT,CUSTOM

├─ createTimestring非必须
├─ updateTimestring非必须

# 获取订阅列表

# 基本信息

Path: /v1/services/:instanceId/subscriptions

Method: GET

接口描述:

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

路径参数

参数名称 示例 备注
instanceId

Query

参数名称 是否必须 示例 备注
pageNo
pageSize
orderBy
order

# 返回数据

名称类型是否必须默认值备注其他信息
totalCountnumber非必须
pageNonumber非必须
pageSizenumber非必须
resultobject []非必须

item 类型: object

├─ instanceIdstring非必须
├─ productKeystring非必须ID

mock: @word

├─ productNamestring非必须名称

mock: @string

├─ deviceTypestring非必须节点类型,同设备类型

枚举: DIRECT,SUBDEVICE,GATEWAY

├─ stateboolean非必须订阅true,没有订阅false
├─ createTimestring非必须
├─ updateTimestring非必须

# 修改订阅设置

# 基本信息

Path: /v1/services/:instanceId/:productKey/subscriptions

Method: PUT

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey

Body

名称类型是否必须默认值备注其他信息
consumerGroupIdsstring []必须

item 类型: string

├─非必须
messageTypesstring []必须枚举:DEVICE_MESSAGE 设备上报, DEVICE_STATE_CHANGE设备生命周期变更

item 类型: string

├─非必须

# 返回数据

# 启用/禁用订阅

# 基本信息

Path: /v1/services/:instanceId/:productKey/subscriptions

Method: POST

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey

Query

参数名称 是否必须 示例 备注
state false取消订阅,true订阅

Body

名称类型是否必须默认值备注其他信息
consumerGroupIdsstring []必须

item 类型: string

├─非必须
messageTypesstring []必须

item 类型: string

├─非必须

# 返回数据

# 推送消息类别及文案列表

# 基本信息

Path: /v1/services/:instanceId/message/type

Method: GET

接口描述:

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

路径参数

参数名称 示例 备注
instanceId

# 返回数据

名称类型是否必须默认值备注其他信息
messageTypeobject []非必须

item 类型: object

├─ enumNamestring非必须
├─ descriptionstring非必须

# 获取订阅详情

# 基本信息

Path: /v1/services/:instanceId/:productKey/subscriptions

Method: GET

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey

# 返回数据

名称类型是否必须默认值备注其他信息
updateTimestring非必须
productKeystring非必须
productNamestring非必须
instanceIdstring非必须
createTimestring非必须
deviceTypestring非必须
consumerGroupsobject []非必须

item 类型: object

├─ consumerGroupNamestring必须
├─ consumerGroupIdstring必须
messageTypesobject []非必须Deprecated, 以topics字段为准

item 类型: object

├─ enumNamestring非必须
├─ descriptionstring非必须
statestring非必须是否开启了订阅

# 获取服务组用户名密码

# 基本信息

Path: /v1/services/:instanceId/consumers/user

Method: GET

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId

# 返回数据

名称类型是否必须默认值备注其他信息
passwordstring非必须
usernamestring必须