# 产业目录接口

# 全部产业目录

# 接口地址

/industry_catalog/get_industry_catalog_list

# 接口参数

参数名 必选 说明
无 无 无

# 返回实例

{
    "code": 1000,
    "info": "Success",
    "data": [
        {
            "catalog_id": "1",
            "catalog_name": "国民经济行业",
            "catalog_des": "",
            "create_time": "2024-08-05 16:34:12",
            "update_time": "2024-08-05 16:34:12"
        }
    ]
}

# 字段说明

字段 说明
catalog_id 产业目录ID
catalog_name 产业目录名称
catalog_des 产业目录描述
create_time 数据创建时间
update_time 数据更新时间

# 产业目录树

# 接口地址

/industry_catalog/get_industry_catalog_scope_tree

# 接口参数

参数名 必选 说明
catalog_id 是 产业目录ID

# 返回实例

{
    "code": 1000,
    "info": "Success",
    "data": {
        "catalog_id": 1,
        "scope_tree": [
            {
                "type": 1,
                "nodes": [
                    {
                        "id": "101",
                        "name": "农、林、牧、渔业",
                        "tag_id": "",
                        "tag_name": "",
                        "type": "1",
                        "p_id": "0",
                        "path": "101",
                        "children": [
                            {
                                "id": "102",
                                "name": "农业",
                                "tag_id": "",
                                "tag_name": "农业",
                                "type": "1",
                                "p_id": "101",
                                "path": "101,102",
                                "children": []
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

# 字段说明

字段 说明
catalog_id 产业目录ID
scope_tree 按目录类型分组的节点树
scope_tree/type 目录类型
scope_tree/nodes 当前类型下的节点树
id 节点ID
name 节点名称
tag_id 关联的IT桔子标签ID,未建立映射时返回空字符串;当前仅部分目录节点有值
tag_name 关联的IT桔子标签名称,未建立映射时返回空字符串;同一标签名称可能对应多个目录节点,不建议作为唯一关联键
type 目录类型
p_id 父节点ID,0表示一级节点
path 节点路径
children 子节点列表

# 产业目录层级列表

# 接口地址

/industry_catalog/get_industry_catalog_scope_level_list

# 接口参数

参数名 必选 说明
catalog_id 是 产业目录ID;1、7查询三级目录,5、8查询两级目录
industry 否 目录节点ID路径,多个层级用英文逗号分隔,例如:一级ID,二级ID,三级ID
page 否 页码
start 否 起始显示条数,默认为0;传入page时按page和limit计算
limit 否 每页显示个数,默认为20,最大100

# 返回实例

{
    "code": 1000,
    "info": "Success",
    "data": [
        {
            "catalog_id": 1,
            "levels": [
                {
                    "level": 1,
                    "id": "101",
                    "name": "农、林、牧、渔业",
                    "tag_id": "",
                    "tag_name": "",
                    "type": "1",
                    "p_id": "0"
                },
                {
                    "level": 2,
                    "id": "102",
                    "name": "农业",
                    "tag_id": "",
                    "tag_name": "农业",
                    "type": "1",
                    "p_id": "101"
                },
                {
                    "level": 3,
                    "id": "103",
                    "name": "谷物种植",
                    "tag_id": "",
                    "tag_name": "",
                    "type": "1",
                    "p_id": "102"
                }
            ]
        }
    ],
    "total": 1848
}

# 字段说明

字段 说明
catalog_id 产业目录ID
levels 层级节点列表
levels/level 节点层级
levels/id 节点ID
levels/name 节点名称
levels/tag_id 关联的IT桔子标签ID,未建立映射时返回空字符串;当前层级列表支持的目录中该字段可能为空
levels/tag_name 关联的IT桔子标签名称,未建立映射时返回空字符串;同一标签名称可能对应多个目录节点,不建议作为唯一关联键
levels/type 目录类型
levels/p_id 父节点ID,0表示一级节点
total 查询结果总数

# 产业目录直接子节点

# 接口地址

/industry_catalog/get_industry_catalog_child_scope_list

# 接口参数

参数名 必选 说明
node_id 是 目录节点ID

# 返回实例

{
    "code": 1000,
    "info": "Success",
    "data": [
        {
            "id": "102",
            "name": "农业",
            "tag_id": "",
            "tag_name": "农业",
            "type": "1",
            "p_id": "101",
            "path": "101,102"
        }
    ]
}

# 字段说明

字段 说明
id 节点ID
name 节点名称
tag_id 关联的IT桔子标签ID,未建立映射时返回空字符串;当前仅部分目录节点有值
tag_name 关联的IT桔子标签名称,未建立映射时返回空字符串;同一标签名称可能对应多个目录节点,不建议作为唯一关联键
type 目录类型
p_id 父节点ID
path 节点路径
b7uOINm5HTEp