自定义字段对接

七鱼调用企业接口获取自定义字段动态枚举的请求、鉴权和响应约定。

API 配置接入

获取字段内容接口为 POST 请求。该接口由网易七鱼系统后端服务器调用。

请求参数

Query

参数	数据类型	是否必须	参数说明
appKey	String	是	企业appkey
time	Integer	是	当前 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数
checksum	String	是	SHA1(appSecret + md5 + time), 三个参数拼接的字符串，进行SHA1哈希计算，转化成16进制字符(String，小写)

Body

无

返回参数

字段	类型	必须	说明
code	Int / String	是	表明接口调用是否成功。值为200时表示接口调用成功。
result	Array	是	用一个数组表示字段的详情信息。

其中result字段用一个数组描述字段的详情信息，数组中元素包含如下

字段	类型	必须	说明
label	String	是	字段内容信息
id	String	否	只做记录，不会根据id做唯一性进行修改
children	Array	否	当字段类型为级联的时候存在，用一个数组表示子字段的信息，字段的元素包含了label、children信息。如此表示级联层级关系，目前层级最多是5层,每层上限500个，叶子节点最大5000个。

示例

请求示例

无

返回示例

{
    "code":200,
    "result":[
        {
            "label":"江苏",
            "children":[
                {
                    "label":"赣州",
                    "children":[
                        {
                            "label":"兴国",
                            "children":null
                        }
                    ]
                },
                {
                    "label":"九江",
                    "children":null
                }
            ]
        },
        {
            "label":"浙江",
            "children":null
        }     
    ]
}

自定义字段对接

目录