Create & Init Project...

app/interface/live/app-ucenter/api/http/api.md

@@ -0,0 +1 @@
+# HTTP API文档

app/interface/live/app-ucenter/api/http/v1/BUILD

@@ -0,0 +1,62 @@
+load(
+    "@io_bazel_rules_go//proto:def.bzl",
+    "go_proto_library",
+)
+
+package(default_visibility = ["//visibility:public"])
+
+load(
+    "@io_bazel_rules_go//go:def.bzl",
+    "go_library",
+)
+
+go_library(
+    name = "go_default_library",
+    srcs = [
+        "appUcenter.bm.go",
+        "service.bm.go",
+    ],
+    embed = [":v1_go_proto"],
+    importpath = "go-common/app/interface/live/app-ucenter/api/http/v1",
+    tags = ["automanaged"],
+    visibility = ["//visibility:public"],
+    deps = [
+        "//library/net/http/blademaster:go_default_library",
+        "//library/net/http/blademaster/binding:go_default_library",
+        "@com_github_gogo_protobuf//gogoproto:go_default_library",
+        "@com_github_gogo_protobuf//proto:go_default_library",
+    ],
+)
+
+filegroup(
+    name = "package-srcs",
+    srcs = glob(["**"]),
+    tags = ["automanaged"],
+    visibility = ["//visibility:private"],
+)
+
+filegroup(
+    name = "all-srcs",
+    srcs = [":package-srcs"],
+    tags = ["automanaged"],
+    visibility = ["//visibility:public"],
+)
+
+proto_library(
+    name = "v1_proto",
+    srcs = [
+        "appUcenter.proto",
+        "service.proto",
+    ],
+    tags = ["automanaged"],
+    deps = ["@gogo_special_proto//github.com/gogo/protobuf/gogoproto"],
+)
+
+go_proto_library(
+    name = "v1_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:gogofast_grpc"],
+    importpath = "go-common/app/interface/live/app-ucenter/api/http/v1",
+    proto = ":v1_proto",
+    tags = ["automanaged"],
+    deps = ["@com_github_gogo_protobuf//gogoproto:go_default_library"],
+)

app/interface/live/app-ucenter/api/http/v1/appUcenter.bm.go

@@ -0,0 +1,129 @@
+// Code generated by protoc-gen-bm v0.1, DO NOT EDIT.
+// source: appUcenter.proto
+
+/*
+Package v1 is a generated blademaster stub package.
+This code was generated with go-common/app/tool/bmgen/protoc-gen-bm v0.1.
+
+It is generated from these files:
+	appUcenter.proto
+*/
+package v1
+
+import (
+	"context"
+
+	bm "go-common/library/net/http/blademaster"
+	"go-common/library/net/http/blademaster/binding"
+)
+
+// to suppressed 'imported but not used warning'
+var _ *bm.Context
+var _ context.Context
+var _ binding.StructValidator
+
+var PathRoomGetInfo = "/live.appucenter.v1.Room/GetInfo"
+var PathRoomCreate = "/live.appucenter.v1.Room/Create"
+
+var PathTopicGetTopicList = "/live.appucenter.v1.Topic/GetTopicList"
+var PathTopicCheckTopic = "/live.appucenter.v1.Topic/CheckTopic"
+
+// ==============
+// Room Interface
+// ==============
+
+type RoomBMServer interface {
+	// 获取房间基本信息
+	// `method:"GET" midware:"auth"`
+	GetInfo(ctx context.Context, req *GetRoomInfoReq) (resp *GetRoomInfoResp, err error)
+
+	// 创建房间
+	// `method:"POST" midware:"auth"`
+	Create(ctx context.Context, req *CreateReq) (resp *CreateResp, err error)
+}
+
+var v1RoomSvc RoomBMServer
+
+func roomGetInfo(c *bm.Context) {
+	p := new(GetRoomInfoReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1RoomSvc.GetInfo(c, p)
+	c.JSON(resp, err)
+}
+
+func roomCreate(c *bm.Context) {
+	p := new(CreateReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1RoomSvc.Create(c, p)
+	c.JSON(resp, err)
+}
+
+// RegisterV1RoomService Register the blademaster route with middleware map
+// midMap is the middleware map, the key is defined in proto
+func RegisterV1RoomService(e *bm.Engine, svc RoomBMServer, midMap map[string]bm.HandlerFunc) {
+	auth := midMap["auth"]
+	v1RoomSvc = svc
+	e.GET("/xlive/app-ucenter/v1/room/GetInfo", auth, roomGetInfo)
+	e.POST("/xlive/app-ucenter/v1/room/Create", auth, roomCreate)
+}
+
+// RegisterRoomBMServer Register the blademaster route
+func RegisterRoomBMServer(e *bm.Engine, server RoomBMServer) {
+	v1RoomSvc = server
+	e.GET("/live.appucenter.v1.Room/GetInfo", roomGetInfo)
+	e.POST("/live.appucenter.v1.Room/Create", roomCreate)
+}
+
+// ===============
+// Topic Interface
+// ===============
+
+type TopicBMServer interface {
+	// 获取话题列表
+	// `method:"GET" midware:"auth"`
+	GetTopicList(ctx context.Context, req *GetTopicListReq) (resp *GetTopicListResp, err error)
+
+	// 检验话题是否有效
+	// `method:"GET" midware:"auth"`
+	CheckTopic(ctx context.Context, req *CheckTopicReq) (resp *CheckTopicResp, err error)
+}
+
+var v1TopicSvc TopicBMServer
+
+func topicGetTopicList(c *bm.Context) {
+	p := new(GetTopicListReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1TopicSvc.GetTopicList(c, p)
+	c.JSON(resp, err)
+}
+
+func topicCheckTopic(c *bm.Context) {
+	p := new(CheckTopicReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1TopicSvc.CheckTopic(c, p)
+	c.JSON(resp, err)
+}
+
+// RegisterV1TopicService Register the blademaster route with middleware map
+// midMap is the middleware map, the key is defined in proto
+func RegisterV1TopicService(e *bm.Engine, svc TopicBMServer, midMap map[string]bm.HandlerFunc) {
+	auth := midMap["auth"]
+	v1TopicSvc = svc
+	e.GET("/xlive/app-ucenter/v1/topic/GetTopicList", auth, topicGetTopicList)
+	e.GET("/xlive/app-ucenter/v1/topic/CheckTopic", auth, topicCheckTopic)
+}
+
+// RegisterTopicBMServer Register the blademaster route
+func RegisterTopicBMServer(e *bm.Engine, server TopicBMServer) {
+	v1TopicSvc = server
+	e.GET("/live.appucenter.v1.Topic/GetTopicList", topicGetTopicList)
+	e.GET("/live.appucenter.v1.Topic/CheckTopic", topicCheckTopic)
+}

app/interface/live/app-ucenter/api/http/v1/appUcenter.proto

@@ -0,0 +1,82 @@
+syntax = "proto3";
+package live.appucenter.v1;
+option go_package = "v1";
+
+import "github.com/gogo/protobuf/gogoproto/gogo.proto";
+
+message GetRoomInfoResp {
+    int64 room_id = 1 [(gogoproto.jsontag) = 'room_id'];
+    int64 uid = 2 [(gogoproto.jsontag) = 'uid'];
+    string uname = 3 [(gogoproto.jsontag) = 'uname'];
+    string title = 4 [(gogoproto.jsontag) = 'title'];
+    string face = 5 [(gogoproto.jsontag) = 'face'];
+    string try_time = 7 [(gogoproto.jsontag) = 'try_time'];
+    int64 live_status = 8 [(gogoproto.jsontag) = 'live_status'];
+    string area_v2_name = 9 [(gogoproto.jsontag) = 'area_v2_name'];
+    int64 area_v2_id = 10 [(gogoproto.jsontag) = 'area_v2_id'];
+    int64 master_level = 11 [(gogoproto.jsontag) = 'master_level'];
+    int64 master_level_color = 12 [(gogoproto.jsontag) = 'master_level_color'];
+    int64 master_score = 13 [(gogoproto.jsontag) = 'master_score'];
+    int64 master_next_level = 14 [(gogoproto.jsontag) = 'master_next_level'];
+    int64 max_level = 15 [(gogoproto.jsontag) = 'max_level'];
+    int64 fc_num = 16 [(gogoproto.jsontag) = 'fc_num'];
+    int64 rcost = 17 [(gogoproto.jsontag) = 'rcost'];
+    int64 medal_status = 18 [(gogoproto.jsontag) = 'medal_status'];
+    string medal_name = 19 [(gogoproto.jsontag) = 'medal_name'];
+    int64 medal_rename_status = 20 [(gogoproto.jsontag) = 'medal_rename_status'];
+    int64 is_medal = 21 [(gogoproto.jsontag) = 'is_medal'];
+    string full_text = 22 [(gogoproto.jsontag) = 'full_text'];
+    int64 identify_status = 23 [(gogoproto.jsontag) = 'identify_status'];
+    int64 lock_status = 24 [(gogoproto.jsontag) = 'lock_status'];
+    string lock_time = 25 [(gogoproto.jsontag) = 'lock_time'];
+    int64 open_medal_level = 26 [(gogoproto.jsontag) = 'open_medal_level'];
+    int64 master_next_level_score = 27 [(gogoproto.jsontag) = 'master_next_level_score'];
+    int64 parent_id = 28 [(gogoproto.jsontag) = 'parent_id'];
+    string parent_name = 29 [(gogoproto.jsontag) = 'parent_name'];
+}
+message GetRoomInfoReq {
+    string platform = 1 [(gogoproto.moretags) = 'form:"platform" validate:"required"'];
+
+}
+
+message CreateResp {
+    string room_id = 1 [(gogoproto.jsontag) = 'room_id'];
+}
+message CreateReq {
+    string platform = 1 [(gogoproto.moretags) = 'form:"platform" validate:"required"'];
+}
+
+message GetTopicListReq {
+    string platform = 1 [(gogoproto.moretags) = 'form:"platform" validate:"required"'];
+}
+message GetTopicListResp {
+    repeated string topic_list = 1 [(gogoproto.jsontag) = 'topic_list'];
+}
+
+message CheckTopicReq {
+    string platform = 1 [(gogoproto.moretags) = 'form:"platform" validate:"required"'];
+    string topic = 2 [(gogoproto.moretags) = 'form:"topic" validate:"required"'];
+}
+message CheckTopicResp {
+
+}
+
+service Room {
+    //获取房间基本信息
+    //`method:"GET" midware:"auth"`
+    rpc GetInfo(GetRoomInfoReq) returns (GetRoomInfoResp);
+    //创建房间
+    //`method:"POST" midware:"auth"`
+    rpc Create(CreateReq) returns (CreateResp);
+}
+
+service Topic {
+     //获取话题列表
+     //`method:"GET" midware:"auth"`
+     rpc GetTopicList(GetTopicListReq) returns (GetTopicListResp);
+
+     //检验话题是否有效
+     //`method:"GET" midware:"auth"`
+     rpc CheckTopic(CheckTopicReq) returns (CheckTopicResp);
+
+ }

app/interface/live/app-ucenter/api/http/v1/appUcenter.room.md

@@ -0,0 +1,82 @@
+<!-- package=live.appucenter.v1 -->
+- [/xlive/app-ucenter/v1/room/GetInfo](#xliveapp-ucenterv1roomGetInfo) 获取房间基本信息
+- [/xlive/app-ucenter/v1/room/Create](#xliveapp-ucenterv1roomCreate) 创建房间
+
+## /xlive/app-ucenter/v1/room/GetInfo
+###获取房间基本信息
+
+> 需要登录
+
+#### 方法：GET
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|platform|是|string||
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "room_id": 0,
+        "uid": 0,
+        "uname": "",
+        "title": "",
+        "face": "",
+        "try_time": "",
+        "live_status": 0,
+        "area_v2_name": "",
+        "area_v2_id": 0,
+        "master_level": 0,
+        "master_level_color": 0,
+        "master_score": 0,
+        "master_next_level": 0,
+        "max_level": 0,
+        "fc_num": 0,
+        "rcost": 0,
+        "medal_status": 0,
+        "medal_name": "",
+        "medal_rename_status": 0,
+        "is_medal": 0,
+        "full_text": "",
+        "identify_status": 0,
+        "lock_status": 0,
+        "lock_time": "",
+        "open_medal_level": 0,
+        "master_next_level_score": 0,
+        "parent_id": 0,
+        "parent_name": ""
+    }
+}
+```
+
+
+## /xlive/app-ucenter/v1/room/Create
+###创建房间
+
+> 需要登录
+
+#### 方法：POST
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|platform|是|string||
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "room_id": ""
+    }
+}
+```
+

app/interface/live/app-ucenter/api/http/v1/appUcenter.topic.md

@@ -0,0 +1,57 @@
+<!-- package=live.appucenter.v1 -->
+- [/xlive/app-ucenter/v1/topic/GetTopicList](#xliveapp-ucenterv1topicGetTopicList) 获取话题列表
+- [/xlive/app-ucenter/v1/topic/CheckTopic](#xliveapp-ucenterv1topicCheckTopic) 检验话题是否有效
+
+## /xlive/app-ucenter/v1/topic/GetTopicList
+###获取话题列表
+
+> 需要登录
+
+#### 方法：GET
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|platform|是|string||
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "topic_list": [
+            ""
+        ]
+    }
+}
+```
+
+
+## /xlive/app-ucenter/v1/topic/CheckTopic
+###检验话题是否有效
+
+> 需要登录
+
+#### 方法：GET
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|platform|是|string||
+|topic|是|string||
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+    }
+}
+```
+

app/interface/live/app-ucenter/api/http/v1/service.bm.go

@@ -0,0 +1,157 @@
+// Code generated by protoc-gen-bm v0.1, DO NOT EDIT.
+// source: service.proto
+
+/*
+Package v1 is a generated blademaster stub package.
+This code was generated with go-common/app/tool/bmgen/protoc-gen-bm v0.1.
+
+It is generated from these files:
+	service.proto
+*/
+package v1
+
+import (
+	"context"
+
+	bm "go-common/library/net/http/blademaster"
+	"go-common/library/net/http/blademaster/binding"
+)
+
+// to suppressed 'imported but not used warning'
+var _ *bm.Context
+var _ context.Context
+var _ binding.StructValidator
+
+var PathRoomAdminIsAny = "/live.appucenter.v1.RoomAdmin/is_any"
+var PathRoomAdminGetByUid = "/live.appucenter.v1.RoomAdmin/get_by_uid"
+var PathRoomAdminResign = "/live.appucenter.v1.RoomAdmin/resign"
+var PathRoomAdminSearchForAdmin = "/live.appucenter.v1.RoomAdmin/search_for_admin"
+var PathRoomAdminGetByAnchor = "/live.appucenter.v1.RoomAdmin/get_by_anchor"
+var PathRoomAdminDismiss = "/live.appucenter.v1.RoomAdmin/dismiss"
+var PathRoomAdminAppoint = "/live.appucenter.v1.RoomAdmin/appoint"
+
+// ===================
+// RoomAdmin Interface
+// ===================
+
+// History 相关服务
+type RoomAdminBMServer interface {
+	// 根据登录态获取功能入口是否显示, 需要登录态
+	// `method:"GET" midware:"auth"`
+	IsAny(ctx context.Context, req *ShowEntryReq) (resp *ShowEntryResp, err error)
+
+	// 获取用户拥有的的所有房管身份
+	// `method:"GET" midware:"auth"`
+	GetByUid(ctx context.Context, req *RoomAdminGetByUidReq) (resp *RoomAdminGetByUidResp, err error)
+
+	// 辞职房管
+	// `method:"POST" midware:"auth"`
+	Resign(ctx context.Context, req *RoomAdminResignRoomAdminReq) (resp *RoomAdminResignRoomAdminResp, err error)
+
+	// 查询需要添加的房管
+	// `method:"POST" midware:"auth"`
+	SearchForAdmin(ctx context.Context, req *RoomAdminSearchForAdminReq) (resp *RoomAdminSearchForAdminResp, err error)
+
+	// 获取主播拥有的的所有房管
+	// `method:"GET" midware:"auth"`
+	GetByAnchor(ctx context.Context, req *RoomAdminGetByAnchorReq) (resp *RoomAdminGetByAnchorResp, err error)
+
+	// 撤销房管
+	// `method:"POST" midware:"auth"`
+	Dismiss(ctx context.Context, req *RoomAdminDismissAdminReq) (resp *RoomAdminDismissAdminResp, err error)
+
+	// 任命房管
+	// `method:"POST" midware:"auth"`
+	Appoint(ctx context.Context, req *RoomAdminAddReq) (resp *RoomAdminAddResp, err error)
+}
+
+var v1RoomAdminSvc RoomAdminBMServer
+
+func roomAdminIsAny(c *bm.Context) {
+	p := new(ShowEntryReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1RoomAdminSvc.IsAny(c, p)
+	c.JSON(resp, err)
+}
+
+func roomAdminGetByUid(c *bm.Context) {
+	p := new(RoomAdminGetByUidReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1RoomAdminSvc.GetByUid(c, p)
+	c.JSON(resp, err)
+}
+
+func roomAdminResign(c *bm.Context) {
+	p := new(RoomAdminResignRoomAdminReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1RoomAdminSvc.Resign(c, p)
+	c.JSON(resp, err)
+}
+
+func roomAdminSearchForAdmin(c *bm.Context) {
+	p := new(RoomAdminSearchForAdminReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1RoomAdminSvc.SearchForAdmin(c, p)
+	c.JSON(resp, err)
+}
+
+func roomAdminGetByAnchor(c *bm.Context) {
+	p := new(RoomAdminGetByAnchorReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1RoomAdminSvc.GetByAnchor(c, p)
+	c.JSON(resp, err)
+}
+
+func roomAdminDismiss(c *bm.Context) {
+	p := new(RoomAdminDismissAdminReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1RoomAdminSvc.Dismiss(c, p)
+	c.JSON(resp, err)
+}
+
+func roomAdminAppoint(c *bm.Context) {
+	p := new(RoomAdminAddReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := v1RoomAdminSvc.Appoint(c, p)
+	c.JSON(resp, err)
+}
+
+// RegisterV1RoomAdminService Register the blademaster route with middleware map
+// midMap is the middleware map, the key is defined in proto
+func RegisterV1RoomAdminService(e *bm.Engine, svc RoomAdminBMServer, midMap map[string]bm.HandlerFunc) {
+	auth := midMap["auth"]
+	v1RoomAdminSvc = svc
+	e.GET("/xlive/app-ucenter/v1/roomAdmin/is_any", auth, roomAdminIsAny)
+	e.GET("/xlive/app-ucenter/v1/roomAdmin/get_by_uid", auth, roomAdminGetByUid)
+	e.POST("/xlive/app-ucenter/v1/roomAdmin/resign", auth, roomAdminResign)
+	e.POST("/xlive/app-ucenter/v1/roomAdmin/search_for_admin", auth, roomAdminSearchForAdmin)
+	e.GET("/xlive/app-ucenter/v1/roomAdmin/get_by_anchor", auth, roomAdminGetByAnchor)
+	e.POST("/xlive/app-ucenter/v1/roomAdmin/dismiss", auth, roomAdminDismiss)
+	e.POST("/xlive/app-ucenter/v1/roomAdmin/appoint", auth, roomAdminAppoint)
+}
+
+// RegisterRoomAdminBMServer Register the blademaster route
+func RegisterRoomAdminBMServer(e *bm.Engine, server RoomAdminBMServer) {
+	v1RoomAdminSvc = server
+	e.GET("/live.appucenter.v1.RoomAdmin/is_any", roomAdminIsAny)
+	e.GET("/live.appucenter.v1.RoomAdmin/get_by_uid", roomAdminGetByUid)
+	e.POST("/live.appucenter.v1.RoomAdmin/resign", roomAdminResign)
+	e.POST("/live.appucenter.v1.RoomAdmin/search_for_admin", roomAdminSearchForAdmin)
+	e.GET("/live.appucenter.v1.RoomAdmin/get_by_anchor", roomAdminGetByAnchor)
+	e.POST("/live.appucenter.v1.RoomAdmin/dismiss", roomAdminDismiss)
+	e.POST("/live.appucenter.v1.RoomAdmin/appoint", roomAdminAppoint)
+}

app/interface/live/app-ucenter/api/http/v1/service.proto

@@ -0,0 +1,186 @@
+syntax = "proto3";
+
+package live.appucenter.v1;
+option go_package = "v1";
+
+import "github.com/gogo/protobuf/gogoproto/gogo.proto";
+
+// History 相关服务
+service RoomAdmin {
+    // 根据登录态获取功能入口是否显示, 需要登录态
+    // `method:"GET" midware:"auth"`
+    rpc is_any (ShowEntryReq) returns (ShowEntryResp);
+    // 获取用户拥有的的所有房管身份
+    // `method:"GET" midware:"auth"`
+    rpc get_by_uid (RoomAdminGetByUidReq) returns (RoomAdminGetByUidResp);
+    // 辞职房管
+    // `method:"POST" midware:"auth"`
+    rpc resign (RoomAdminResignRoomAdminReq) returns (RoomAdminResignRoomAdminResp);
+    // 查询需要添加的房管
+    // `method:"POST" midware:"auth"`
+    rpc search_for_admin (RoomAdminSearchForAdminReq) returns (RoomAdminSearchForAdminResp);
+    // 获取主播拥有的的所有房管
+    // `method:"GET" midware:"auth"`
+    rpc get_by_anchor (RoomAdminGetByAnchorReq) returns (RoomAdminGetByAnchorResp);
+    // 撤销房管
+    // `method:"POST" midware:"auth"`
+    rpc dismiss (RoomAdminDismissAdminReq) returns (RoomAdminDismissAdminResp);
+    // 任命房管
+    // `method:"POST" midware:"auth"`
+    rpc appoint (RoomAdminAddReq) returns (RoomAdminAddResp);
+}
+
+// 历史记录请求参数定义
+message ShowEntryReq {
+
+}
+
+// 获取接口返回响应
+message ShowEntryResp {
+    // 是否有房管
+    int64 has_admin = 1;
+}
+
+message RoomAdminSearchForAdminReq {
+    string key_word = 1 [(gogoproto.moretags) = 'form:"key_word" validate:"required"'];
+}
+
+message RoomAdminSearchForAdminResp {
+    repeated Data data = 3 [(gogoproto.jsontag) = "data"];
+
+    message Data {
+        // 用户id
+        int64 uid = 1 [(gogoproto.jsontag) = "uid"];
+        // 是否房管
+        int64 is_admin = 2 [(gogoproto.jsontag) = "is_admin"];
+        // 用户名
+        string uname = 4 [(gogoproto.jsontag) = "uname"];
+        // 用户头像
+        string face = 5 [(gogoproto.jsontag) = "face"];
+        // 粉丝勋章名称
+        string medal_name = 6 [(gogoproto.jsontag) = "medal_name"];
+        // 粉丝勋章等级
+        int64 level = 7 [(gogoproto.jsontag) = "level"];
+    }
+}
+
+
+message RoomAdminResignRoomAdminReq {
+    // 房间号
+    int64 roomid = 1 [(gogoproto.moretags) = 'form:"roomid" validate:"required"'];
+}
+
+message RoomAdminResignRoomAdminResp {
+
+}
+
+message RoomAdminGetByUidReq {
+    // 页数
+    int64 page = 1 [(gogoproto.moretags) = 'form:"page"'];
+}
+
+message RoomAdminGetByUidResp {
+    //
+    Page page = 1;
+
+    //
+    repeated Data data = 3 [(gogoproto.jsontag) = "data"];
+
+    message Data {
+        // 用户id
+        int64 uid = 1 [(gogoproto.jsontag) = "uid"];
+        // 房间号
+        int64 roomid = 2 [(gogoproto.jsontag) = "roomid"];
+        // 主播的用户id
+        int64 anchor_id = 3 [(gogoproto.jsontag) = "anchor_id"];
+        // 主播用户名
+        string uname = 4 [(gogoproto.jsontag) = "uname"];
+        // 主播封面
+        string anchor_cover = 5 [(gogoproto.jsontag) = "anchor_cover"];
+        // 上任时间
+        string ctime = 6 [(gogoproto.jsontag) = "ctime"];
+    }
+
+    message Page {
+        // 当前页码
+        int64 page = 1;
+        // 每页大小
+        int64 page_size = 2;
+        // 总页数
+        int64 total_page = 3;
+        // 总记录数
+        int64 total_count = 4;
+    }
+}
+
+message RoomAdminGetByAnchorReq {
+    // 页数
+    int64 page = 1 [(gogoproto.moretags) = 'form:"page"'];
+}
+
+message RoomAdminGetByAnchorResp {
+    //
+    Page page = 1;
+
+    //
+    repeated Data data = 3 [(gogoproto.jsontag) = "data"];
+
+    message Data {
+        // 用户id
+        int64 uid = 1 [(gogoproto.jsontag) = "uid"];
+        // 用户名
+        string uname = 4 [(gogoproto.jsontag) = "uname"];
+        // 用户头像
+        string face = 5 [(gogoproto.jsontag) = "face"];
+        // 上任时间
+        string ctime = 6 [(gogoproto.jsontag) = "ctime"];
+        // 粉丝勋章名称
+        string medal_name = 8 [(gogoproto.jsontag) = "medal_name"];
+        // 粉丝勋章等级
+        int64 level = 9 [(gogoproto.jsontag) = "level"];
+    }
+
+    message Page {
+        // 当前页码
+        int64 page = 1;
+        // 每页大小
+        int64 page_size = 2;
+        // 总页数
+        int64 total_page = 3;
+        // 总记录数
+        int64 total_count = 4;
+    }
+}
+
+message RoomAdminDismissAdminReq {
+    // 房管的用户uid
+    int64 uid = 1 [(gogoproto.moretags) = 'form:"uid" validate:"required"'];
+}
+
+message RoomAdminDismissAdminResp {
+
+}
+
+message RoomAdminAddReq {
+    // 房管的uid
+    int64 uid = 1 [(gogoproto.moretags) = 'form:"uid" validate:"required"'];
+}
+
+message RoomAdminAddResp {
+
+    message UI {
+        // 用户id
+        int64 uid = 1 [(gogoproto.jsontag) = "uid"];
+        // 用户名
+        string uname = 2 [(gogoproto.jsontag) = "uname"];
+    }
+
+    // banner
+    UI userinfo = 1 [(gogoproto.jsontag) = "userinfo"];
+    // 房管的用户id
+    int64 uid = 2 [(gogoproto.jsontag) = "uid"];
+    // 房间号
+    int64 roomid = 3 [(gogoproto.jsontag) = "roomid"];
+    // 创建时间　"2017-07-26 17:12:51"
+    string ctime = 4 [(gogoproto.jsontag) = "ctime"];
+}

app/interface/live/app-ucenter/api/http/v1/service.roomAdmin.md

@@ -0,0 +1,263 @@
+<!-- package=live.appucenter.v1 -->
+- [/xlive/app-ucenter/v1/roomAdmin/is_any](#xliveapp-ucenterv1roomAdminis_any)  根据登录态获取功能入口是否显示, 需要登录态
+- [/xlive/app-ucenter/v1/roomAdmin/get_by_uid](#xliveapp-ucenterv1roomAdminget_by_uid)  获取用户拥有的的所有房管身份
+- [/xlive/app-ucenter/v1/roomAdmin/resign](#xliveapp-ucenterv1roomAdminresign)  辞职房管
+- [/xlive/app-ucenter/v1/roomAdmin/search_for_admin](#xliveapp-ucenterv1roomAdminsearch_for_admin)  查询需要添加的房管
+- [/xlive/app-ucenter/v1/roomAdmin/get_by_anchor](#xliveapp-ucenterv1roomAdminget_by_anchor)  获取主播拥有的的所有房管
+- [/xlive/app-ucenter/v1/roomAdmin/dismiss](#xliveapp-ucenterv1roomAdmindismiss)  撤销房管
+- [/xlive/app-ucenter/v1/roomAdmin/appoint](#xliveapp-ucenterv1roomAdminappoint)  任命房管
+
+## /xlive/app-ucenter/v1/roomAdmin/is_any
+### 根据登录态获取功能入口是否显示, 需要登录态
+
+> 需要登录
+
+#### 方法：GET
+
+#### 请求参数
+
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        //  是否有房管
+        "has_admin": 0
+    }
+}
+```
+
+
+## /xlive/app-ucenter/v1/roomAdmin/get_by_uid
+### 获取用户拥有的的所有房管身份
+
+> 需要登录
+
+#### 方法：GET
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|page|否|integer| 页数|
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "page": {
+            //  当前页码
+            "page": 0,
+            //  每页大小
+            "page_size": 0,
+            //  总页数
+            "total_page": 0,
+            //  总记录数
+            "total_count": 0
+        },
+        "data": [
+            {
+                //  用户id
+                "uid": 0,
+                //  房间号
+                "roomid": 0,
+                //  主播的用户id
+                "anchor_id": 0,
+                //  主播用户名
+                "uname": "",
+                //  主播封面
+                "anchor_cover": "",
+                //  上任时间
+                "ctime": ""
+            }
+        ]
+    }
+}
+```
+
+
+## /xlive/app-ucenter/v1/roomAdmin/resign
+### 辞职房管
+
+> 需要登录
+
+#### 方法：POST
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|roomid|是|integer| 房间号|
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+    }
+}
+```
+
+
+## /xlive/app-ucenter/v1/roomAdmin/search_for_admin
+### 查询需要添加的房管
+
+> 需要登录
+
+#### 方法：POST
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|key_word|是|string||
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "data": [
+            {
+                //  用户id
+                "uid": 0,
+                //  是否房管
+                "is_admin": 0,
+                //  用户名
+                "uname": "",
+                //  用户头像
+                "face": "",
+                //  粉丝勋章名称
+                "medal_name": "",
+                //  粉丝勋章等级
+                "level": 0
+            }
+        ]
+    }
+}
+```
+
+
+## /xlive/app-ucenter/v1/roomAdmin/get_by_anchor
+### 获取主播拥有的的所有房管
+
+> 需要登录
+
+#### 方法：GET
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|page|否|integer| 页数|
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        "page": {
+            //  当前页码
+            "page": 0,
+            //  每页大小
+            "page_size": 0,
+            //  总页数
+            "total_page": 0,
+            //  总记录数
+            "total_count": 0
+        },
+        "data": [
+            {
+                //  用户id
+                "uid": 0,
+                //  用户名
+                "uname": "",
+                //  用户头像
+                "face": "",
+                //  上任时间
+                "ctime": "",
+                //  粉丝勋章名称
+                "medal_name": "",
+                //  粉丝勋章等级
+                "level": 0
+            }
+        ]
+    }
+}
+```
+
+
+## /xlive/app-ucenter/v1/roomAdmin/dismiss
+### 撤销房管
+
+> 需要登录
+
+#### 方法：POST
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|uid|是|integer| 房管的用户uid|
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+    }
+}
+```
+
+
+## /xlive/app-ucenter/v1/roomAdmin/appoint
+### 任命房管
+
+> 需要登录
+
+#### 方法：POST
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|uid|是|integer| 房管的uid|
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        //  banner
+        "userinfo": {
+            //  用户id
+            "uid": 0,
+            //  用户名
+            "uname": ""
+        },
+        //  房管的用户id
+        "uid": 0,
+        //  房间号
+        "roomid": 0,
+        //  创建时间　"2017-07-26 17:12:51"
+        "ctime": ""
+    }
+}
+```
+