字典项搜索接口

GET /api/v1/dictionaries/:category/:code/search?q=关键词

在指定字典中搜索字典项。

接口说明

该接口用于在指定字典中搜索字典项。通过指定字典类别、字典代码和搜索关键词,可以快速找到相关的字典项。

路径参数

参数名 类型 说明
category string 字典类别,取值为 "cn"(中国标准)或 "intl"(国际标准)
code string 字典代码,用于唯一标识一个字典

查询参数

参数名 类型 说明
q string 搜索关键词,支持模糊匹配

响应参数

参数名 类型 说明
code string 字典项代码
name string 字典项名称
description string 字典项描述
parentCode string 父项代码
sort number 排序号
status number 状态(1-启用,0-禁用)

响应示例

[
    {
        "code": "1",
        "name": "男",
        "description": "男性",
        "sort": 1,
        "status": 1
    }
]

错误码

错误码 说明
400 请求参数错误
404 字典不存在
500 服务器内部错误