MessageCenter/api/message.api

syntax = "v1"

info(
	title: // TODO: add title
	desc: // TODO: add description
	author: "jiaojiao7"
	email: "renjiaojiao@topnet.net.cn"
)

type response {
	Code    int64  `json:"code"`
	Message string `json:"message"`
}

//查询消息详情
type MessageDetailReq {
	Id string `json:"id"`
}
type MessageDetailResp {
	Code    int64                  `json:"code"`
	Message string                 `json:"message"`
	Data    map[string]interface{} `json:"data"`
}

type MessageUnreadCountReq {
	UserId string `header:"mgoUserId"`
	AppId  string `header:"appId"`
}
type MessageUnreadCountRes {
	Code    int64                  `json:"code"`
	Message string                 `json:"message"`
	Data    map[string]interface{} `json:"data"`
}
type GetMsgTypeReq {
	UserId string `header:"userId"`
	AppId  string `header:"appId"`
}
type GetMsgTypeRes {
	Code    int64                    `json:"code"`
	Message string                   `json:"message"`
	Data    []map[string]interface{} `json:"data"`
}

//修改指定用户某个分类的消息为已读
type MsgReadStatusReq {
	UserId  string `form:"userId"`
	AppId   string `form:"appId"`
	MsgType int    `form:"msgType"`
}
type MsgReadStatusResp {
	Code    int64  `json:"code"`
	Message string `json:"message"`
	Status  int64  `json:"status"`
}

type MarkReadReq {
	MsgId string `form:"msgId"`
	AppId string `form:"appId"`
}
type MarkReadRes {
	Code    int64  `json:"code"`
	Message string `json:"message"`
	Data    int64  `json:"data"`
}

//批量保存消息
type MultipleSaveMsgReq {
	MsgInfo     map[string]interface{} `json:"msgInfo"`
	UserIds     string                 `json:"userIds"`
	UserNames   string                 `json:"userNames"`
	PositionIds string                 `json:"positionIds,optional"` // 职位id 如果是多个就逗号分割 和用户id一一对应
}
type MultipleSaveMsgResp {
	Code     int64  `json:"code"`
	Message  string `json:"message"`
	ErrCount int64  `json:"errCount"`
}

type GetBuoyMsgReq {
	UserId string `header:"mgoUserId"`
	AppId  string `header:"appId"`
	Size   int64  `json:"size,optional"`
}

type GetBuoyMsgResp {
	Code    int64                    `json:"error_code"`
	Message string                   `json:"error_msg"`
	Data    []map[string]interface{} `json:"data"`
}

type ClearUnreadMsgReq {
	UserId     string `header:"mgoUserId"`
	AppId      string `header:"appId"`
	EntId      int64  `header:"entId,optional"`
	PositionId int64  `header:"positionId,optional"`
}

type MessageListReq {
	UserId         string `header:"mgoUserId"`
	AppId          string `header:"appId"`
	EntId          int64  `header:"entId,optional"`
	SortSize       int64  `json:"sortSize,optional"` //分类获取数
	Offset         int64  `json:"offset"`            //
	Size           int64  `json:"size,optional"`
	MsgType        int64  `json:"msgType,optional"`
	IsRead         int64  `json:"isRead,optional"`
	NewUserId      int64  `header:"newUserId,optional"`  //私信相关
	PositionId     int64  `header:"positionId,optional"` //私信相关
	IsColumn       bool   `json:"isColumn"`              //是否需要获取栏目
	IsColumnNewMsg bool   `json:"isColumnNewMsg"`        //是否需各栏目获取最新消息
	IsMsgList      bool   `json:"isMsgList"`             //是否需要列表信息
}

type MessageListResp {
	Code    int64                    `json:"code"`
	Message string                   `json:"message"`
	Data    []map[string]interface{} `json:"data"`
	Last    map[string]interface{}   `json:"last"`
	Total   int64                    `json:"total"`
	Column  []map[string]interface{} `json:"column"`
	Unread  int64                    `json:"unread"`
}
type UnreadMessageReq {
	UserId   string `header:"mgoUserId"`
	AppId    string `header:"appId"`
	Offset   int64  `json:"offset"` //
	PageSize int64  `json:"pageSize"`
}
type UnreadMessageResp {
	Code    int64                    `json:"code"`
	Message string                   `json:"message"`
	Data    []map[string]interface{} `json:"data"`
	Total   int64                    `json:"total"`
}

type WxTmplMessageReq {
	UserIds     string `json:"userIds,optional"`     // 用户id如果是多个就逗号分割
	PositionIds string `json:"positionIds,optional"` //用户职位id
	Title       string `json:"title"`
	Date        string `json:"date"`
	Detail      string `json:"detail"`
	Class       string `json:"class"`
	Url         string `json:"url"`
}

type WxTmplMessageResponse {
	Code    int64  `json:"code"`
	Total   int64  `json:"total"`
	Message string `json:"message"`
}

service message-api {
	
	//查询消息详情
	@handler MessageDetailHandler
	get /messageCenter/messageDetail (MessageDetailReq) returns (MessageDetailResp)
	// 获取用户未读消息总量
	@handler MessageUnreadCountHandler
	post /messageCenter/messageUnreadCount (MessageUnreadCountReq) returns (MessageUnreadCountRes)
	// 获取用户接收到的消息分类
	@handler GetMsgTypeHandler
	get /messageCenter/getMsgType (GetMsgTypeReq) returns (GetMsgTypeRes)
	// 标记为已读
	@handler MarkReadHandler
	post /messageCenter/markRead (MarkReadReq) returns (MarkReadRes)
	
	// 发送消息
	@handler MultipleSaveMsgHandler
	post /messageCenter/MultipleSaveMsg (MultipleSaveMsgReq) returns (MultipleSaveMsgResp)
	
	// 查询浮标信息
	@handler GetBuoyMsgHandler
	post /messageCenter/GetBuoyMsg (GetBuoyMsgReq) returns (GetBuoyMsgResp)
	
	// 一键清空未读消息
	@handler ClearUnreadMessages
	post /messageCenter/ClearUnreadMsg (ClearUnreadMsgReq) returns (response)
	
	@handler MessageList
	post /messageCenter/MessageList (MessageListReq) returns (MessageListResp)
	
	@handler UnreadMessages
	post /messageCenter/unreadMessages (UnreadMessageReq) returns (UnreadMessageResp)
	
	// 发送微信模版消息
	@handler SendWxTmplMsg
	post /messageCenter/sendWxTmplMsg (WxTmplMessageReq) returns (WxTmplMessageResponse)
}