company.api 1.5 KB
syntax = "v1"

info(
	title: "天联鹰蜓"
	desc: "天联鹰蜓"
	author: "email"
	email: "email"
	version: "v1"
)

// 小程序接口
@server(
	prefix: v1
	group: company
)
service Core {
	@doc "公司搜索(公开的)"
	@handler miniCompanySearch
	post /mini/company/search(CompanySearchRequest) returns (CompanySearchResponse)
}

// 小程序接口
@server(
	prefix: v1
	group: company
	jwt : MiniAuth
)
service Core {
	@doc "搜索已加入的公司"
	@handler miniCompanySearchJoined
	post /mini/company/search-joined(CompanySearchRequest) returns (CompanySearchResponse)
}

// 小程序接口
@server(
	prefix: v1
	group: company
	jwt : SystemAuth
)
service Core {
	@doc "公司搜索"
	@handler systemCompanySearch
	post /system/company/search(CompanySearchRequest) returns (CompanySearchResponse)
}

type (
	CompanySearchRequest {
		Page   int    `json:"page,optional"`
		Size   int    `json:"size,optional"`
		Flag   int    `json:"flag,optional"`   // 1:用户已加入的 2:用户未加入的公司
		UserId int64  `json:"userId,optional"` // 按用户搜索(用户所加入的企业)
		Code   string `json:"code,optional"`   // 按编码搜索
	}
	CompanySearchResponse {
		List  []Company `json:"list"`
		Total int64     `json:"total"`
	}
	Company {
		Id   int64  `json:"id,omitempty"`   // 唯一标识
		Name string `json:"name,omitempty"` // 名称
		Code string `json:"code,omitempty"` // 编码(搜索使用,4位字母数字)
		Logo string `json:"logo,omitempty"` // 公司LOGO
	}
)