查询自定义字段级联分类

按 fieldId 查询自定义字段级联分类列表。fieldId 缺失或为 0、企业管理员不存在、字段不存在或分类列表为空时，返回工单不存在错误码。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
fieldId	int64	是	自定义字段 ID	81001

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
data	object	自定义字段级联分类结果	{"result":[{"id":100001,"name":"华东"}],"total":1}
└result	object[]	分类树列表	[{"id":100001,"name":"华东","children":[]}]
└id	int64	分类 ID	100001
└name	string	分类名称	华东
└cloud	boolean	是否云端节点	false
└children	object[]	子节点列表	[{"id":100002,"name":"浙江"}]
└id	int64	分类 ID	100001
└name	string	分类名称	华东
└cloud	boolean	是否云端节点	false
└children	object[]	子节点列表	[{"id":100002,"name":"浙江"}]
└disabled	boolean	是否禁用	false
└highlight	boolean	是否高亮	false
└ai	int32	AI 标识	0
└sort	int32	排序值	1
└disabled	boolean	是否禁用	false
└highlight	boolean	是否高亮	false
└ai	int32	AI 标识	0
└sort	int32	排序值	1
└total	int32	分类总数	12

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	time 缺失，或请求时间戳与服务器时间误差超过 10 分钟
14004	请求体不是合法 JSON
14106	fieldId 缺失或为 0；企业管理员不存在；字段不存在；或 fieldId 无法查询到分类列表
14500	服务内部异常；请求字段类型不符合要求或服务处理失败

postEndpoint

/openapi/category/get

curl -X POST "https://qiyukf.com/openapi/category/get?appKey=9f1d7c2b8a6e4d3c&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0" \  -H "Content-Type: application/json" \  -d '{    "fieldId": 81001  }'

{
  "code": 200,
  "data": {
    "result": [
      {
        "id": 100001,
        "name": "华东"
      }
    ],
    "total": 1
  }
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "time 缺失，或请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体不是合法 JSON"
}

{
  "code": 14106,
  "message": "fieldId 缺失或为 0；企业管理员不存在；字段不存在；或 fieldId 无法查询到分类列表"
}

{
  "code": 14500,
  "message": "服务内部异常；请求字段类型不符合要求或服务处理失败"
}