身份分类查询 3.5.5.Beta1+

接口说明

请求URL：http[s]://{网关地址}/minos-platform/category/search

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求体

字段名	参数名	是否必填	类型	描述
身份分类代码3.8.2.Beta3+	code	O	String(20)	身份分类代码
身份分类名称	name	O	String(30)	身份分类名称模糊查询

请求示例

{
    "name":"教师1111"
}

响应说明

响应体

字段名	参数名	类型	描述
返回码	errcode	String	0 成功，其他为不成功
返回码描述	errmsg	String	返回码描述
返回对象	data	List<Category>	返回的对象信息

Category

字段名	参数名	类型	描述
身份分类wid	wid	String	身份分类wid
编码	code	String	身份分类编码
名称	name	String	名称
父分类的wid	pwid	String	父分类的wid
分类类型	onoroffCampusType	int	分类类型 1：校内 2：校外

响应示例

{
    "errcode": "0",
    "errmsg": "success",
    "traceId": "OpenV2Api_1085189279401345024",
    "data": [
        {
            "wid": "school",
            "code": "IDS-DEV",
            "name": "IDS-DEV",
            "pwid": "-1",
            "onoroffCampusType": null
        },
        {
            "wid": "10000",
            "code": "10000",
            "name": "教师11111111",
            "pwid": "school",
            "onoroffCampusType": 1
        },
        {
            "wid": "20000",
            "code": "20000",
            "name": "学生",
            "pwid": "school",
            "onoroffCampusType": 1
        },
        {
            "wid": "2000001",
            "code": "2000001",
            "name": "本科生",
            "pwid": "20000",
            "onoroffCampusType": 1
        },
        {
            "wid": "2000002",
            "code": "2000002",
            "name": "研究生",
            "pwid": "20000",
            "onoroffCampusType": 1
        },
        {
            "wid": "10000000",
            "code": "10000000",
            "name": "校外用户",
            "pwid": "school",
            "onoroffCampusType": 2
        },
        {
            "wid": "10010000",
            "code": "10010000",
            "name": "访客",
            "pwid": "10000000",
            "onoroffCampusType": 2
        },
        {
            "wid": "10020000",
            "code": "10020000",
            "name": "家长",
            "pwid": "10000000",
            "onoroffCampusType": 2
        },
        {
            "wid": "10030000",
            "code": "10030000",
            "name": "校友",
            "pwid": "10000000",
            "onoroffCampusType": 2
        }
    ]
}

错误码

错误码	描述
999	统一错误码，详细描述信息参见接口返回

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
CategorySearchRequest request = new CategorySearchRequest();

BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
	//.....
}