系统配置信息

  • 接口地址: /api/fresns/info/configs
  • 请求方式: POST
  • 请求格式: JSON

header 可选参数:

参数名公开模式(是否必传)私有模式(是否必传)
uidNONO
midNONO
tokenNONO

body 参数:

参数名类型是否必传说明
itemTagStringNO键标签,多个以英文逗号隔开
itemKeyStringNO键名,多个以英文逗号隔开
pageSizeNumberNO每页显示条数(默认 100 条)
pageNumberNO页码(默认 1)

返回结果:

成功

{
    "code": 0,
    "message": "ok",
    "data": {
        "pagination": {
            "total": "一共有多少条数据",
            "current": "当前页码",
            "pageSize": "每页有多少条数据",
            "lastPage": "最后一页页码"
        },
        "list": [
            {
                "itemKey": "键名",
                "itemValue": "键值",
                "itemTag": "键标签",
                "itemType": "value",
                "itemStatus": true
            },
            {
                "itemKey": "键名",
                "itemValue": 1,
                "itemTag": "键标签",
                "itemType": "number",
                "itemStatus": false
            },
            {
                "itemKey": "键名",
                "itemValue": "键值",
                "itemTag": "键标签",
                "itemType": "string",
                "itemStatus": true
            },
            {
                "itemKey": "键名",
                "itemValue": true,
                "itemTag": "键标签",
                "itemType": "boolean",
                "itemStatus": false
            },
            {
                "itemKey": "键名",
                "itemValue": [
                    {"id":"1","name":"Other"},
                    {"id":"2","name":"PC Web"},
                    {"id":"3","name":"Mobile Web"},
                    {"id":"4","name":"Responsive Web"}
                ],
                "itemTag": "键标签",
                "itemType": "array",
                "itemStatus": true
            },
            {
                "itemKey": "键名",
                "itemValue": {
                    "langTag": "en",
                    "title": "标题",
                    "content": "内容"
                },
                "itemTag": "键标签",
                "itemType": "object",
                "itemStatus": true
            },
            {
                "itemKey": "键名",
                "itemValue": "https://cdn.fresns.cn/images/logo.png",
                "itemTag": "键标签",
                "itemType": "file",
                "itemStatus": true
            },
            {
                "itemKey": "键名",
                "itemValue": "https://fresns.cn/access?p={pid}&lang={langtag}&login={token}",
                "itemTag": "键标签",
                "itemType": "plugin",
                "itemStatus": true
            },
            {
                "itemKey": "键名",
                "itemValue": [
                    {
                        "code": "codeName",
                        "url": "根据插件表 access_path 生成 URL"
                    }
                ],
                "itemTag": "键标签",
                "itemType": "plugins",
                "itemStatus": true
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

失败

{
    "code": "code_messages > code",
    "message": "code_messages > message"
}
1
2
3
4

开发说明

  • 该接口查询 configs 表内容。
  • 输入 itemTag 参数,查询 item_tag 字段,指定输出该 Tag 的所有参数。
  • 输入 itemKey 参数,查询 item_key 字段,输出指定的键名键值。
  • itemTagitemKey 参数同时使用时,如果出现结果重复,需要去除 itemKey 中的结果,以包含在 itemTag 中的结果为主。
  • 两个参数留空代表输出全部配置。
  • 两个参数均填写,凡是符合其中一个条件,即输出,不需要同时满足两个条件。
  • is_restful 字段为 0 时,接口不输出参数。
  • is_enable 字段转换为布尔型输出,参数名 itemStatus
  • is_multilingual 字段为 1 时,代表该键值为多语言,需要输出匹配的语言内容。找不到匹配的语言标签则输出第一条,如果一条都没有,则输出为空值。
  • item_type 字段为 file 时,如果键值是以 http://https:// 开头,则不用特殊处理,原样输出。如果是数字,则代表是文件 ID,凭 ID 输出文件 URL(图片拼接需要三个键,键名 images_bucket_domain + 文件表 file_path 字段 + 键名 images_thumb_big),如果该文件类型开启了防盗链功能,则向插件索要 URL 输出。
  • item_type 字段为 pluginplugins 时,代表为插件键值,需要凭插件 unikey 生成访问地址(URL),URL 则根据 access_path 生成。