company.api 1.6 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 struct{
        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 struct{
        Id   int64  `json:"id,omitempty"`   // 唯一标识
        Name string `json:"name,omitempty"` // 名称
        Code string `json:"code,omitempty"` // 编码(搜索使用,4位字母数字)
        Logo string `json:"logo,omitempty"` // 公司LOGO
    }
)