分类

获取分类列表

可以获取应用的分类属性,用于设置实体的 category_id 属性

接口调用说明:

GET https://lxapi.lexiangla.com/cgi-bin/v1/categories

请求document

{
    "data": {
        "type": "category",
        "attributes": {
            "name": "API新建的分类",
            "target_type": "doc"
        }
    }
}

参数说明:

参数 是否必须 默认值 说明
target_type 需要获取分类列表的应用类型,支持:doc、thread。
doc 表示文档,thread 表示论坛
parent_id 父分类ID,为空时默认拉取第一级分类,若要拉取次级分类需要添加此参数

SDK封装方法使用示例:

$Lxapi = new \Lexiangla\Openapi\Api(AppKey, AppSecret);
$response = $Lxapi->get('categories', [
    'target_type' => 'doc',
    // 'parent_id' => '3dc35dda52dc11e6ae140800278acc25',
]);

响应document

200 OK 状态码
{
    "data":[
        {
            "type":"category",
            "id":"3dc335a852dc11e6b49a0800278acc25",
            "attributes":{
                "name":"技术运维"
            },
            "meta":{
                "children_count":"0"
            }
        },
        {
            "type":"category",
            "id":"3dc35dda52dc11e6ae140800278acc25",
            "attributes":{
                "name":"产品市场"
            },
            "meta":{
                "children_count":"2"
            }
        },
        {
            "type":"category",
            "id":"3dc38ce252dc11e6a16f0800278acc25",
            "attributes":{
                "name":"设计用研"
            },
            "meta":{
                "children_count":"0"
            }
        },
        {
            "type":"category",
            "id":"3dc3e2dc52dc11e695060800278acc25",
            "attributes":{
                "name":"质量管理"
            },
            "meta":{
                "children_count":"0"
            }
        },
        {
            "type":"category",
            "id":"3dc3f7e052dc11e690ef0800278acc25",
            "attributes":{
                "name":"企管文化"
            },
            "meta":{
                "children_count":"0"
            }
        },
        {
            "type":"category",
            "id":"3dc4337252dc11e693940800278acc25",
            "attributes":{
                "name":"其他"
            },
            "meta":{
                "children_count":"0"
            }
        }
    ]
}

创建分类

接口调用说明:

POST https://lxapi.lexiangla.com/cgi-bin/v1/categories

请求document

{
    "data": {
        "type": "category", 
        "attributes": {
            "name": "API新建分类", 
            "target_type": "doc", 
            "weight": 10
        }, 
        "relationships": {
            "parent": {
                "data": {
                    "type": "category", 
                    "id": "3dc335a852dc11e6b49a0800278acc25"
                }
            }
        }
    }
}

参数说明:

参数 是否必须 默认值 说明
name 分类名称
target_type 分类所属模块,支持:doc、thread。
doc 表示文档,thread 表示论坛
weight 0 用于分类排序,越小越优先展示
parent 父分类

SDK封装方法使用示例:

$attributs = [
    'name' => 'API新建分类',
    'target_type' => 'doc'
];
$options = [
    'parent_id' => '3dc335a852dc11e6b49a0800278acc25',
    'weight' => 10
];

$Lxapi = new \Lexiangla\Openapi\Api(AppKey, AppSecret);
$response = $Lxapi->postCategory(StaffID, $attributs, $options);

响应document

201 Created 状态码
{
    "data": {
        "type": "directory", 
        "id": "9a76e154cd3811e8b2b8cfb4fc928df1", 
        "attributes": {
            "name": "开放接口目录"
        }
    }
}