From debef0a5f1a1d239940a5b47fb303f2fc05a74fa Mon Sep 17 00:00:00 2001 From: simonzhangsz Date: Sat, 12 Oct 2024 10:58:58 +0800 Subject: [PATCH] export open api v2409.4 --- docs/interfaces/08-OMC Open API v2409.4.md | 21463 +++++++++++++++++++ 1 file changed, 21463 insertions(+) create mode 100644 docs/interfaces/08-OMC Open API v2409.4.md diff --git a/docs/interfaces/08-OMC Open API v2409.4.md b/docs/interfaces/08-OMC Open API v2409.4.md new file mode 100644 index 0000000..b5ef3e3 --- /dev/null +++ b/docs/interfaces/08-OMC Open API v2409.4.md @@ -0,0 +1,21463 @@ +--- +title: OMC +language_tabs: + - shell: Shell + - http: HTTP + - javascript: JavaScript + - ruby: Ruby + - python: Python + - php: PHP + - java: Java + - go: Go +toc_footers: [] +includes: [] +search: true +code_clipboard: true +highlight_theme: darkula +headingLevel: 2 +generator: "@tarslib/widdershins v4.0.23" + +--- + +# OMC + +OMC HTTP Restful API Interfaces + +Base URLs: + +# 中文目录接口/通用模块 + +## GET 默认主页 + +GET / + +### Params + +|Name|Location|Type|Required|Description| +|---|---|---|---|---| +|Referer|header|string| yes |User Referer| +|User-Agent|header|string| yes |User Agent| +|Accept-Language|header|string| yes |en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "Welcome to the CN EMS Core Network Management Platform, current version: 2.2401.1, please access via the frontend address." +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 获取验证码 + +GET /captchaImage + +验证码有效期2分钟 + +### Params + +|Name|Location|Type|Required|Description| +|---|---|---|---|---| +|Authorization|header|string| yes |Authoirzation token| +|Referer|header|string| yes |User Referer| +|User-Agent|header|string| yes |User Agent| +|Accept-Language|header|string| yes |en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "captchaEnabled": true, + "uuid": "os0t2l1532dhuvqv", + "img": "data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='120' height='40' viewBox='0%2c0%2c120%2c40'%3e%3crect width='100%25' height='100%25' fill='%23fafafa'/%3e%3cpath fill='%2364e6e6' d='M62.19 26.62L62.24 26.67L62.16 26.59Q65.43 27.87 69.20 27.87L69.20 27.88L69.26 27.94Q70.89 27.97 72.45 27.75L72.42 27.71L72.32 27.61Q71.98 28.18 71.33 29.36L71.26 29.29L71.29 29.32Q71.92 29.46 72.60 29.23L72.65 29.27L72.49 29.11Q72.23 30.03 72.23 30.83L72.28 30.89L72.19 30.79Q72.19 31.52 72.46 32.24L72.54 32.32L72.51 32.29Q70.98 31.95 69.20 31.99L69.29 32.08L69.23 32.02Q67.58 32.12 66.17 32.39L66.17 32.39L66.03 32.25Q66.46 31.46 66.35 30.47L66.36 30.48L66.36 30.49Q66.19 30.62 65.97 30.58L65.86 30.48L65.87 30.49Q65.69 30.47 65.39 30.47L65.37 30.44L65.49 30.57Q65.20 28.71 62.15 26.58ZM65.45 29.99L65.54 30.08L65.51 30.05Q67.04 30.25 68.18 30.21L68.22 30.25L68.13 30.16Q70.97 30.30 70.97 30.30L70.96 30.28L70.83 30.16Q71.02 29.20 71.74 28.18L71.68 28.11L71.59 28.03Q70.56 28.29 69.38 28.29L69.45 28.36L69.38 28.29Q66.36 28.35 63.47 27.40L63.43 27.36L63.37 27.30Q65.24 28.64 65.62 30.17ZM65.12 30.77L65.19 30.84L65.23 30.87Q65.53 30.79 66.21 30.83L66.19 30.81L66.15 30.77Q66.09 31.89 65.56 32.65L65.56 32.66L65.59 32.69Q67.19 32.57 67.03 32.57L67.07 32.60L67.07 32.60Q66.49 33.54 65.73 34.31L65.65 34.22L65.68 34.26Q67.75 33.97 69.69 33.97L69.55 33.83L69.64 33.91Q74.20 33.87 78.31 35.58L78.40 35.67L75.97 34.31L75.83 34.16Q73.52 32.73 73.52 30.52L73.38 30.39L73.46 30.46Q73.14 30.45 72.88 30.45L72.98 30.55L72.52 30.63L72.40 30.51Q72.58 29.78 73.15 28.83L73.13 28.81L73.05 28.72Q72.58 28.75 71.63 28.94L71.80 29.11L71.65 28.96Q72.26 28.05 73.25 27.29L73.21 27.25L73.11 27.15Q71.26 27.58 69.24 27.58L69.32 27.66L69.18 27.52Q64.54 27.64 60.77 25.77L60.70 25.70L60.78 25.78Q65.14 28.39 65.25 30.90ZM66.06 29.73L66.15 29.82L65.84 29.78L65.93 29.86Q65.64 29.61 65.53 29.61L65.71 29.79L65.72 29.80Q65.53 29.23 65.15 28.82L64.97 28.64L64.22 27.77L64.27 27.82Q66.75 28.66 69.49 28.66L69.36 28.54L69.46 28.64Q70.16 28.50 71.03 28.42L71.14 28.52L70.96 28.84L70.75 29.05L70.74 29.04Q69.46 29.09 68.17 29.06L68.18 29.06L68.33 29.22Q66.91 29.10 65.62 28.83L65.53 28.74L65.68 28.88Q66.05 29.26 66.20 29.87Z'/%3e%3cpath fill='%2371ade8' d='M44.80 18.31L44.89 18.39L44.82 18.33Q41.80 18.50 39.97 17.43L39.85 17.31L39.91 17.37Q42.41 15.99 47.28 11.77L47.20 11.68L47.21 11.69Q47.93 11.50 49.23 10.89L49.37 11.03L49.19 10.85Q47.99 16.93 47.88 23.28L47.82 23.23L47.74 23.15Q47.66 29.54 48.72 35.63L48.88 35.78L48.77 35.68Q47.12 34.97 44.98 34.86L45.00 34.87L44.91 34.78Q44.95 30.79 44.95 26.71L44.85 26.62L44.84 26.60Q44.89 22.55 44.93 18.43ZM44.49 20.62L44.51 35.22L44.60 35.31Q45.66 35.15 46.61 35.34L46.63 35.36L46.75 35.48Q46.71 36.05 46.90 37.42L46.91 37.43L46.92 37.44Q49.78 37.98 52.21 40.22L52.28 40.29L52.29 40.30Q49.82 33.19 49.79 25.73L49.66 25.60L49.66 25.60Q49.66 18.22 51.49 10.98L51.52 11.02L51.56 11.05Q50.92 11.37 49.32 12.47L49.37 12.52L49.39 12.53Q49.53 11.73 49.84 10.21L49.89 10.26L49.86 10.23Q48.47 10.94 47.02 11.32L47.11 11.40L47.16 11.45Q43.30 14.94 39.00 17.22L39.01 17.23L38.93 17.16Q40.33 18.25 42.69 18.59L42.75 18.65L42.72 18.62Q42.05 19.13 40.76 20.20L40.80 20.24L40.77 20.21Q42.38 20.71 44.58 20.71L44.48 20.61Z'/%3e%3cpath fill='%23328ce5' d='M21.38 18.49L21.29 18.40L21.25 18.35Q18.06 18.36 16.23 17.29L16.30 17.36L16.32 17.39Q18.86 16.04 23.73 11.82L23.69 11.77L23.72 11.80Q24.32 11.48 25.61 10.87L25.68 10.95L25.67 10.93Q24.27 16.80 24.15 23.16L24.27 23.28L24.25 23.25Q24.08 29.55 25.14 35.65L25.24 35.75L25.26 35.76Q23.44 34.90 21.31 34.78L21.45 34.93L21.33 34.80Q21.30 30.73 21.30 26.66L21.32 26.68L21.30 26.66Q21.18 22.44 21.22 18.33ZM21.01 20.74L20.85 35.16L20.88 35.19Q22.20 35.29 23.15 35.48L23.18 35.51L23.02 35.35Q23.15 36.09 23.34 37.46L23.40 37.53L23.34 37.46Q26.25 38.05 28.68 40.29L28.73 40.34L28.57 40.18Q26.18 33.15 26.15 25.69L26.07 25.61L26.20 25.74Q26.00 18.15 27.82 10.92L27.83 10.92L27.98 11.08Q27.25 11.30 25.65 12.40L25.78 12.53L25.79 12.54Q25.94 11.73 26.24 10.21L26.19 10.16L26.21 10.19Q24.96 11.03 23.51 11.41L23.43 11.32L23.48 11.37Q19.71 14.95 15.41 17.23L15.40 17.22L15.37 17.19Q16.80 18.32 19.16 18.66L19.09 18.60L19.19 18.70Q18.48 19.16 17.18 20.22L17.13 20.18L17.27 20.32Q18.61 20.55 20.82 20.55L20.86 20.59Z'/%3e%3cpath fill='%23ea5b7f' d='M99.33 32.82L99.48 32.98L99.49 32.99Q99.70 33.88 100.23 35.90L100.26 35.93L100.19 35.86Q95.96 34.53 91.36 34.79L91.43 34.87L91.36 34.79Q86.86 35.13 82.86 37.11L82.93 37.18L82.77 37.02Q83.04 36.37 83.08 36.45L83.03 36.40L83.12 36.49Q86.76 32.44 90.68 28.03L90.81 28.15L90.75 28.10Q95.13 23.07 96.31 18.39L96.27 18.35L96.37 18.45Q96.79 16.66 95.52 15.48L95.57 15.53L95.51 15.48Q94.32 14.38 92.53 14.53L92.55 14.55L92.54 14.55Q92.19 14.49 91.85 14.49L91.78 14.43L91.82 14.47Q90.33 14.50 89.08 15.42L88.92 15.26L89.03 15.38Q87.75 16.75 87.97 19.42L87.92 19.37L88.00 19.44Q86.06 18.95 84.84 18.50L84.84 18.49L84.86 18.51Q84.76 17.19 84.68 15.75L84.69 15.75L84.77 15.83Q84.61 14.11 85.22 12.97L85.20 12.95L85.12 12.87Q87.02 11.61 90.37 11.61L90.36 11.60L92.10 11.59L92.14 11.63Q94.30 11.54 95.25 11.66L95.24 11.65L95.25 11.65Q99.69 12.18 99.96 14.61L99.85 14.51L99.95 14.61Q100.04 15.19 99.96 15.99L99.88 15.90L100.03 16.05Q99.98 16.69 99.83 17.37L99.82 17.37L99.67 17.22Q98.08 25.38 90.51 32.23L90.53 32.26L90.51 32.23Q91.96 32.12 93.33 32.12L93.30 32.09L93.29 32.08Q96.57 32.13 99.43 32.93ZM98.92 12.16L98.80 12.04L98.93 12.17Q97.17 11.37 95.46 11.29L95.53 11.37L92.18 11.25L92.06 11.13Q87.59 10.85 85.38 11.96L85.41 11.98L85.34 11.91Q84.31 13.32 84.31 15.38L84.34 15.40L84.44 15.51Q84.32 16.07 84.63 18.89L84.76 19.02L84.72 18.98Q85.24 19.19 86.42 19.50L86.39 19.47L86.47 20.58L86.37 20.48Q86.42 21.03 86.50 21.56L86.48 21.54L86.42 21.48Q87.75 21.67 90.23 21.90L90.24 21.92L90.11 21.79Q90.23 21.56 90.23 21.22L90.21 21.20L90.17 21.16Q90.16 19.32 91.37 17.96L91.45 18.04L91.47 18.06Q92.64 16.66 94.43 16.78L94.36 16.71L94.33 16.67Q95.20 16.82 95.96 16.97L95.93 16.94L95.93 16.94Q95.99 17.27 96.06 17.69L96.08 17.71L96.00 17.62Q96.11 18.11 96.03 18.46L95.97 18.39L96.15 18.57Q94.71 23.15 90.30 27.99L90.36 28.05L90.40 28.09Q88.21 30.27 82.76 36.33L82.77 36.33L82.78 36.35Q82.53 37.12 82.18 37.69L82.19 37.70L82.23 37.73Q83.92 36.95 85.45 36.42L85.31 36.28L85.46 36.43Q84.62 36.88 83.67 38.37L83.80 38.50L83.77 38.47Q83.69 38.85 83.57 39.19L83.52 39.14L83.49 39.10Q88.27 36.96 93.76 37.15L93.88 37.28L93.90 37.29Q99.62 37.50 104.19 39.86L104.12 39.79L103.17 37.70L103.03 37.56Q102.53 36.37 102.26 35.57L102.12 35.43L102.24 35.55Q101.46 35.08 100.24 34.66L100.30 34.71L100.21 34.63Q100.03 33.87 99.65 32.50L99.78 32.63L99.64 32.49Q97.40 31.89 95.12 31.70L95.17 31.75L95.13 31.71Q99.98 27.32 101.51 19.05L101.48 19.03L101.62 16.09L101.67 16.13Q101.59 14.34 100.37 13.66L100.31 13.59L100.27 13.59L100.27 13.59Q100.18 13.47 100.11 13.47L100.09 13.45L100.11 13.47Q100.01 12.76 98.91 12.15Z'/%3e%3cpath d='M14 30 C59 18%2c65 9%2c110 17' stroke='%2363dddd' fill='none'/%3e%3cpath d='M13 24 C48 26%2c39 6%2c107 9' stroke='%23de77c4' fill='none'/%3e%3cpath d='M12 11 C50 25%2c80 39%2c113 8' stroke='%23e593bc' fill='none'/%3e%3cpath d='M19 17 C43 30%2c51 8%2c109 8' stroke='%23ddc16d' fill='none'/%3e%3c/svg%3e" +} +``` + +```json +{ + "code": 200, + "msg": "成功", + "text": "9", + "captchaEnabled": true, + "uuid": "s7hf2j3erfpritqy", + "img": "data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='120' height='40' viewBox='0%2c0%2c120%2c40'%3e%3crect width='100%25' height='100%25' fill='%23fafafa'/%3e%3cpath fill='%23ec73ce' d='M85.44 24.04L85.53 24.13L85.51 24.11Q83.59 23.90 82.35 25.33L82.43 25.40L82.43 25.41Q81.15 26.79 80.96 28.70L81.02 28.76L81.00 28.73Q80.82 30.84 81.91 31.81L81.97 31.87L81.87 31.78Q83.04 32.83 85.13 32.72L84.98 32.56L85.02 32.61Q87.16 32.50 88.26 31.81L88.29 31.84L88.27 31.82Q89.38 30.68 89.38 29.12L89.37 29.11L89.44 29.19Q89.37 28.73 89.30 28.35L89.35 28.41L89.39 28.44Q89.39 26.69 88.28 25.34L88.23 25.29L88.35 25.40Q87.20 24.01 85.52 24.12ZM85.09 35.22L85.17 35.31L85.10 35.24Q80.72 35.24 79.32 34.48L79.34 34.50L79.28 34.44Q78.32 33.75 78.13 32.04L78.05 31.96L78.03 31.93Q78.01 31.27 78.05 30.55L78.11 30.61L78.16 30.65Q78.27 29.66 78.27 29.21L78.24 29.17L78.13 29.06Q78.70 26.32 78.85 25.64L78.79 25.57L78.85 25.64Q79.36 23.75 80.20 22.34L80.18 22.33L80.01 22.15Q82.70 17.80 88.64 11.44L88.62 11.42L88.67 11.48Q91.34 11.17 93.55 10.37L93.58 10.41L93.62 10.44Q86.67 17.81 83.47 22.04L83.47 22.03L83.48 22.04Q84.46 21.53 85.75 21.53L85.86 21.64L85.82 21.60Q89.14 21.61 90.67 23.56L90.71 23.60L90.75 23.64Q91.92 25.12 92.26 28.66L92.27 28.66L92.29 28.68Q92.39 29.43 92.39 30.04L92.36 30.01L92.47 30.12Q92.44 33.21 90.23 34.28L90.23 34.28L90.26 34.30Q88.98 34.86 85.10 35.24ZM87.47 37.72L87.43 37.68L87.35 37.60Q88.60 37.52 90.58 37.60L90.71 37.72L90.71 37.73Q92.28 37.73 93.84 37.01L93.93 37.09L93.82 36.99Q94.99 36.26 94.99 34.47L94.96 34.43L95.01 34.49Q95.03 34.01 94.86 33.02L94.88 33.04L94.82 32.98Q94.56 31.91 94.56 31.45L94.60 31.49L94.54 31.43Q93.75 26.79 92.15 24.88L92.04 24.78L92.07 24.81Q92.00 24.70 91.85 24.47L91.90 24.52L91.66 24.36L91.50 24.24L91.51 24.25Q91.11 23.69 90.50 22.74L90.55 22.79L90.49 22.74Q89.69 21.89 87.71 21.44L87.64 21.36L87.62 21.35Q88.95 19.86 91.92 16.17L91.82 16.07L96.16 10.89L96.12 10.85Q94.61 11.77 92.21 12.53L92.15 12.47L92.19 12.52Q93.08 11.51 94.87 9.53L94.82 9.48L94.81 9.46Q92.46 10.58 88.58 11.15L88.59 11.17L88.58 11.16Q82.94 17.12 79.97 22.07L79.85 21.95L79.89 21.99Q78.41 24.55 77.84 30.79L77.84 30.79L77.72 30.67Q77.67 31.27 77.74 32.22L77.69 32.17L77.72 32.20Q77.90 34.05 79.00 34.96L78.95 34.91L78.92 34.88Q79.37 35.10 79.33 35.14L79.29 35.10L79.36 35.17Q79.71 36.05 80.51 36.47L80.42 36.38L80.50 36.46Q81.90 37.10 83.84 37.29L83.84 37.29L83.85 37.30Q83.79 37.24 87.30 37.54ZM87.11 26.36L87.10 26.35L87.17 26.41Q87.77 26.33 88.72 26.83L88.63 26.74L88.77 26.87Q88.99 27.71 88.99 28.36L88.94 28.30L89.00 28.37Q89.12 30.16 88.17 31.15L88.28 31.26L88.28 31.26Q87.16 31.92 85.06 32.23L85.15 32.32L85.11 32.28Q83.59 32.20 83.05 31.93L83.20 32.08L83.03 31.91Q82.84 31.45 82.84 31.15L82.85 31.16L83.00 31.31Q82.76 28.03 85.69 26.73L85.62 26.66L85.62 26.65Q86.45 26.39 87.22 26.46Z'/%3e%3cpath d='M10 16 C70 25%2c49 8%2c114 10' stroke='%2378c4dd' fill='none'/%3e%3cpath fill='%23d24065' d='M23.39 35.44L23.31 35.35L23.31 35.35Q21.80 35.33 20.24 34.91L20.24 34.91L20.26 34.93Q19.14 34.12 18.99 32.48L18.89 32.38L18.88 32.38Q18.97 32.31 19.16 29.68L19.17 29.69L19.07 29.59Q20.06 29.37 22.08 28.99L22.06 28.97L21.89 29.75L22.00 29.86Q21.69 31.57 23.10 32.14L23.15 32.19L23.18 32.22Q23.98 32.57 26.08 32.57L26.01 32.50L25.93 32.42Q27.52 32.26 27.71 32.18L27.87 32.35L27.76 32.23Q28.67 32.08 29.39 31.58L29.52 31.71L29.51 31.70Q30.85 30.68 30.66 28.59L30.61 28.54L30.60 28.52Q30.46 26.14 28.73 24.58L28.78 24.63L28.81 24.66Q27.08 23.10 24.61 23.10L24.60 23.09L24.53 22.79L24.55 22.81Q24.82 22.67 25.69 22.59L25.87 22.76L25.67 22.57Q27.66 22.53 29.03 21.30L29.07 21.34L28.97 21.24Q30.46 20.12 30.61 18.26L30.65 18.29L30.63 18.27Q30.61 17.84 30.61 17.50L30.70 17.58L30.61 17.49Q30.67 16.03 29.29 15.11L29.30 15.12L29.23 15.05Q28.02 14.25 26.42 14.37L26.39 14.34L26.38 14.33Q25.06 14.15 23.84 14.57L23.94 14.67L23.85 14.58Q22.55 15.25 22.24 16.40L22.11 16.26L22.21 16.37Q21.98 17.09 22.06 17.85L22.16 17.96L22.17 17.96Q21.02 17.62 18.97 16.89L18.89 16.82L18.91 16.83Q18.81 15.28 18.85 14.45L18.82 14.42L18.84 14.44Q18.83 12.80 19.90 12.11L20.08 12.29L19.99 12.20Q21.48 11.67 23.08 11.67L22.93 11.53L22.93 11.53Q26.17 11.57 29.33 11.84L29.29 11.79L29.34 11.85Q34.43 12.29 34.12 16.06L34.06 16.00L34.04 15.97Q34.00 17.50 33.51 19.06L33.59 19.14L33.55 19.10Q32.65 22.20 30.29 23.12L30.22 23.04L30.14 22.97Q32.90 23.63 33.51 26.98L33.50 26.97L33.50 26.97Q33.63 28.02 33.71 30.03L33.80 30.12L33.74 30.06Q33.91 34.53 29.30 34.99L29.30 34.99L29.40 35.09Q28.57 35.06 23.28 35.33ZM28.53 37.60L28.57 37.65L28.41 37.49Q29.16 37.66 32.01 37.74L31.88 37.61L32.06 37.79Q33.81 37.86 35.45 37.22L35.45 37.22L35.35 37.11Q36.46 36.10 36.27 34.35L36.41 34.49L36.29 34.36Q36.31 33.16 36.00 31.41L35.88 31.29L35.94 31.36Q35.18 26.82 33.24 25.19L33.21 25.16L33.10 24.86L33.06 24.78L32.98 24.69Q34.87 23.39 35.63 19.01L35.50 18.88L35.45 18.84Q35.57 18.46 35.69 17.51L35.78 17.61L35.65 17.47Q35.78 16.76 35.70 16.08L35.80 16.17L35.71 16.08Q35.63 14.48 34.33 13.79L34.34 13.80L34.17 13.71L34.22 13.76Q33.85 12.70 32.71 12.17L32.80 12.26L32.68 12.14Q31.11 11.41 25.97 11.11L26.08 11.21L25.99 11.12Q24.41 11.14 22.81 11.14L22.83 11.16L22.87 11.20Q21.14 11.07 19.62 11.72L19.76 11.86L19.73 11.83Q18.52 12.60 18.52 14.35L18.51 14.34L18.41 14.24Q18.40 13.81 18.67 17.16L18.78 17.28L18.69 17.19Q18.99 17.26 20.63 17.87L20.60 17.84L20.62 17.86Q20.76 18.53 20.72 19.02L20.54 18.84L20.73 19.03Q20.54 19.34 20.58 19.87L20.63 19.93L20.66 19.95Q22.51 20.39 24.53 20.51L24.57 20.55L24.39 20.37Q24.38 18.42 25.48 17.58L25.50 17.59L25.44 17.54Q26.27 16.89 28.29 16.66L28.41 16.78L28.39 16.76Q29.52 16.75 30.09 16.94L30.06 16.90L30.08 16.92Q30.15 17.07 30.19 17.19L30.05 17.05L30.20 17.39L30.27 17.92L30.23 17.88Q30.30 18.13 30.26 18.28L30.18 18.21L30.31 18.34Q30.19 20.01 28.67 21.19L28.59 21.10L28.57 21.09Q27.71 22.06 25.69 22.25L25.72 22.28L25.69 22.24Q25.04 22.47 24.17 22.47L24.11 22.42L24.00 22.30Q24.03 22.64 24.19 23.33L24.35 23.49L24.35 23.50Q26.11 23.50 27.56 24.23L27.50 24.16L27.36 24.14L25.79 24.32L25.76 24.29Q25.76 24.59 25.87 25.20L26.02 25.36L25.90 25.23Q28.07 25.19 29.78 26.53L29.72 26.46L29.85 26.59Q30.02 26.92 30.33 28.55L30.36 28.59L30.35 28.58Q30.47 31.44 27.54 31.85L27.69 32.01L27.61 31.92Q25.48 32.16 24.91 32.12L24.88 32.09L24.98 32.19Q24.46 32.02 23.93 31.94L23.99 32.00L23.91 31.47L24.12 31.10L24.16 30.73L24.16 30.38L24.18 30.40Q23.17 30.42 22.37 30.61L22.44 30.68L22.41 30.65Q22.35 30.40 22.35 30.21L22.43 30.29L22.42 30.28Q22.46 30.09 22.46 29.86L22.33 29.73L22.34 29.74Q22.44 29.39 22.59 28.67L22.57 28.64L22.66 28.73Q20.80 28.96 18.93 29.30L18.88 29.26L18.80 29.18Q18.85 29.72 18.74 30.84L18.80 30.91L18.66 30.76Q18.64 31.99 18.64 32.59L18.55 32.50L18.55 32.50Q18.70 34.63 20.07 35.39L20.08 35.40L20.01 35.33Q21.56 37.68 26.28 37.49L26.31 37.52L26.24 37.45Q27.06 37.51 28.59 37.66Z'/%3e%3cpath d='M13 4 C51 9%2c65 6%2c110 4' stroke='%237590df' fill='none'/%3e%3cpath fill='%23d24b4b' d='M57.55 34.48L57.61 34.54L57.53 34.46Q56.76 34.34 56.08 34.38L56.14 34.44L56.20 34.50Q55.53 34.63 54.85 34.63L54.68 34.47L54.66 34.45Q55.13 31.03 55.13 27.61L55.18 27.66L55.14 27.61Q53.29 27.63 52.37 27.63L52.57 27.82L52.48 27.73Q51.54 27.64 49.72 27.56L49.69 27.54L49.80 27.64Q49.90 27.44 49.71 24.97L49.65 24.91L49.57 24.82Q52.15 25.39 55.12 25.39L55.18 25.45L55.19 25.46Q54.81 20.93 54.39 18.34L54.48 18.43L54.56 18.51Q55.36 18.62 56.16 18.62L56.03 18.49L57.67 18.50L57.78 18.61Q57.44 22.76 57.44 25.35L57.58 25.49L57.45 25.36Q59.72 25.46 62.92 25.12L62.84 25.04L62.84 25.03Q62.75 26.40 62.75 27.61L62.81 27.68L62.69 27.56Q62.58 27.71 61.78 27.75L61.75 27.72L61.70 27.66Q60.68 27.63 60.07 27.67L60.01 27.62L60.07 27.68Q60.10 27.71 57.44 27.71L57.51 27.78L57.34 31.04L57.51 31.21Q57.46 32.79 57.57 34.50ZM63.36 24.64L63.33 24.62L63.27 24.55Q61.46 24.95 59.59 25.03L59.54 24.98L59.53 24.97Q59.78 21.82 60.19 19.96L60.18 19.94L60.22 19.98Q59.51 20.03 58.10 20.18L58.10 20.18L58.31 18.15L58.19 18.03Q55.69 18.15 54.01 18.04L54.01 18.04L54.02 18.05Q54.54 21.12 54.73 25.00L54.70 24.97L54.67 24.94Q52.99 24.97 49.30 24.36L49.20 24.27L49.30 24.37Q49.53 25.51 49.53 28.14L49.55 28.16L51.02 28.11L50.96 28.05Q51.07 28.88 50.92 30.29L50.86 30.23L54.76 29.90L54.85 29.99Q54.64 33.17 54.34 35.00L54.38 35.04L54.33 34.99Q55.05 34.95 56.45 34.83L56.56 34.93L56.49 34.86Q56.55 35.62 56.52 36.95L56.41 36.85L56.39 36.83Q56.88 36.78 60.50 36.93L60.59 37.02L60.50 36.94Q59.71 33.98 59.48 30.02L59.38 29.92L59.45 29.99Q62.82 30.12 64.91 30.50L64.93 30.52L64.79 30.38Q64.61 29.43 64.61 28.48L64.58 28.46L64.74 26.71L64.69 26.66Q64.46 26.66 63.93 26.70L63.98 26.75L63.08 26.65L63.05 26.62Q63.09 25.86 63.20 24.49Z'/%3e%3cpath d='M6 19 C52 21%2c78 16%2c107 21' stroke='%2383ebb7' fill='none'/%3e%3cpath d='M8 38 C57 34%2c69 37%2c109 30' stroke='%237baddf' fill='none'/%3e%3c/svg%3e" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|number|true|none||none| +|» msg|string|true|none||none| +|» text|string|false|none|验证码值|仅开发模式返回显示| +|» captchaEnabled|boolean|true|none|是否启用|none| +|» uuid|string|true|none|uuid|none| +|» img|string|true|none|base64图片|none| + +## GET 系统暴露的配置信息 + +GET /sys-conf + +### Params + +|Name|Location|Type|Required|Description| +|---|---|---|---|---| +|Referer|header|string| yes |User Referer| +|User-Agent|header|string| yes |User Agent| +|Accept-Language|header|string| yes |en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "buildTime": "-", + "copyright": "Copyright ©2023 AGrandTech", + "filePathBrand": "/static/logo/{language}_brand.png", + "filePathIcon": "/static/logo/{language}_icon.png", + "goVer": "-", + "helpDoc": "/static/helpDoc/{language}_doc.pdf", + "i18nDefault": "en_US", + "i18nOpen": "true", + "loginBackground": "#", + "logoType": "icon", + "officialUrl": "#", + "registerUser": "false", + "serialNum": "-", + "sysGuide": "true", + "title": "AGrandEMS", + "version": "-" + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» bootloader|string|true|none||none| +|»» buildTime|string|true|none||none| +|»» copyright|string|true|none||none| +|»» filePathBrand|string|true|none||none| +|»» filePathIcon|string|true|none||none| +|»» goVer|string|true|none||none| +|»» helpDoc|string|true|none||none| +|»» i18nDefault|string|true|none||none| +|»» i18nOpen|string|true|none||none| +|»» loginBackground|string|true|none||none| +|»» logoType|string|true|none||none| +|»» officialUrl|string|true|none||none| +|»» registerUser|string|true|none||none| +|»» serialNum|string|true|none||none| +|»» title|string|true|none||none| +|»» version|string|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/通用模块/文件操作 + +## POST 上传文件 + +POST /file/upload + +> Body Parameters + +```yaml +file: string +subPath: "{% mock 'pick' , ['default', 'avatar', 'import', 'export', 'common', + 'download', 'chunk'] %}" + +``` + +### Params + +|Name|Location|Type|Required|Description| +|---|---|---|---|---| +|Authorization|header|string| yes |Authoirzation token| +|Referer|header|string| yes |User Referer| +|User-Agent|header|string| yes |User Agent| +|Accept-Language|header|string| yes |en_US;q=0.9| +|body|body|object| no |none| +|» file|body|string(binary)| yes |上传文件对象| +|» subPath|body|string| yes |子路径，可选范围 ['default', 'avatar', 'import', 'export', 'common', 'download', 'chunk']| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "url": "http://127.0.0.1:6275/upload/common/2023/05/o_1d2bofn8f19dh5s11okpje61mipg_画板1_iq526uqv.png", + "fileName": "/upload/common/2023/05/o_1d2bofn8f19dh5s11okpje61mipg_画板1_iq526uqv.png", + "newFileName": "o_1d2bofn8f19dh5s11okpje61mipg_画板1_iq526uqv.png", + "originalFileName": "o_1d2bofn8f19dh5s11okpje61mipg_画板1.png" + } +} +``` + +```json +{ + "code": 500, + "msg": "上传文件类型不支持，支持以下类型：bmp,gif,jpg,jpeg,png,doc,docx,xls,xlsx,ppt,pptx,html,htm,txt,rar,zip,gz,bz2,mp4,avi,rmvb,pdf" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» url|string|true|none||none| +|»» fileName|string|true|none||none| +|»» newFileName|string|true|none||none| +|»» originalFileName|string|true|none||none| + +## POST 切片文件检查 + +POST /file/chunkCheck + +> Body Parameters + +```json +{ + "identifier": "string", + "fileName": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» identifier|body|string| yes | 切片文件目录标识符|MD5(文件名+文件大小)| +|» fileName|body|string| yes | 原始文件名称|检查格式是否允许上传| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[string]|true|none|已上传切片数据块的编号|none| + +## POST 切片文件上传 + +POST /file/chunkUpload + +```js +// 上传数据块 +const formData = new FormData(); +formData.append('file', chunk, 'xxx.pdf'); +formData.append('index', chunksIndex); +formData.append('identifier', fileIdentifier); +``` + +chunk是切片块的数据需要给上传文件的名称带后缀 + +> Body Parameters + +```yaml +file: "" +index: "{% mock 'increment' %}" +identifier: "{% mock 'id' %}" + +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» file|body|string(binary)| yes ||数据块Blob对象，需要给文件名称带后缀| +|» index|body|string| yes ||数据块的编号| +|» identifier|body|string| yes ||切片文件目录标识符| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": "/upload/chunk/2023/06/identifier/index" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|206|[Partial Content](https://tools.ietf.org/html/rfc7233#section-4.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **206** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|string|true|none|上传资源地址|none| + +## POST 转存上传文件到静态资源 + +POST /file/transferStaticFile + +> Body Parameters + +```json +{ + "uploadPath": "string", + "staticPath": "string", + "language": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» uploadPath|body|string| yes ||none| +|» staticPath|body|string| yes ||none| +|» language|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "data": "/static/helpDoc/zh_doc.pdf", + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 切片文件合并 + +POST /file/chunkMerge + +> Body Parameters + +```json +{ + "identifier": "string", + "fileName": "string", + "subPath": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» identifier|body|string| yes | 切片文件目录标识符|MD5(文件名+文件大小)| +|» fileName|body|string| yes | 原始文件名称|检查格式是否允许上传| +|» subPath|body|string| yes | 子路径|可选范围 ['default', 'avatar', 'import', 'export', 'common', 'download', 'chunk']| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "url": "http://127.0.0.1:6275/upload/avatar/2023/06/gmircbr_48xqb8.png", + "fileName": "/upload/avatar/2023/06/gmircbr_48xqb8.png", + "newFileName": "gmircbr_48xqb8.png", + "originalFileName": "gmircbr.png" + } +} +``` + +```json +{ + "code": 500, + "msg": "上传文件类型不支持，支持以下类型：bmp,gif,jpg,jpeg,png,doc,docx,xls,xlsx,ppt,pptx,html,htm,txt,rar,zip,gz,bz2,mp4,avi,rmvb,pdf" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[string]|true|none|已上传切片数据块的编号|none| + +## GET 下载文件 + +GET /file/download/{filePath} + +filePath参数需要进行base64编码，base64("文件存放资源路径，URL相对地址") + +断点续传可以在请求头中加入下载数据块的区间，示例如单块5M大小 `Range: bytes=0-5242879` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|filePath|path|string| yes ||base64("文件存放资源路径，URL相对地址")| +|Range|header|string| no ||进行断点续传数据块下载| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 206 Response + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| +|206|[Partial Content](https://tools.ietf.org/html/rfc7233#section-4.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/通用模块/通用请求 + +## POST 哈希加密 + +POST /common/hash + +> Body Parameters + +```json +{ + "type": "string", + "str": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» type|body|string| yes | 加密类型|'sha1' | 'sha256' | 'sha512' | 'md5'| +|» str|body|string| yes | 加密字符串|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": "9e9a253840ebd80b2160be621d2efc7c" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|string|true|none||none| + +## GET 多语言处理 + +GET /common/i18n + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Accept-Language|header|string| no ||en_US/zh_CN| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": "9e9a253840ebd80b2160be621d2efc7c" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|string|true|none||none| + +## POST 哈希加盐加密 + +POST /common/hmac + +> Body Parameters + +```json +{ + "type": "string", + "str": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» type|body|string| yes | 加密类型|'sha1' | 'sha256' | 'sha512' | 'md5'| +|» str|body|string| yes | 加密字符串|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": "6c44dbdf8d759c97dfd8c43a2974ba22" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|string|true|none||none| + +# 中文src目录接口/通用模块/账号身份操作 + +## GET 登录用户信息 + +GET /getInfo + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "permissions": [ + "*:*:*" + ], + "roles": [ + "admin" + ], + "user": { + "roles": [ + { + "roleId": "1", + "roleName": "管理员", + "roleKey": "admin", + "roleSort": 1, + "dataScope": "1", + "status": "1" + } + ], + "userId": "1", + "deptId": "103", + "userName": "maskAdmin", + "nickName": "管理员", + "userType": "sys", + "email": "", + "avatar": "", + "phonenumber": "", + "sex": "1", + "status": "1", + "delFlag": "0", + "loginIp": "127.0.0.1", + "loginDate": "1683968355811", + "createBy": "maskAdmin", + "createTime": "1682264526306", + "remark": "管理员", + "dept": { + "deptId": "103", + "parentId": "101", + "ancestors": "0,100,101", + "deptName": "研发部门", + "orderNum": 1, + "leader": "MASK", + "status": "1" + } + } + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» permissions|[string]|false|none|权限|字符数组| +|»» roles|[string]|false|none|角色|字符数组| +|»» user|object|false|none|用户信息|none| +|»»» roles|[object]|false|none||none| +|»»»» roleId|string|false|none||none| +|»»»» roleName|string|false|none||none| +|»»»» roleKey|string|false|none||none| +|»»»» roleSort|integer|false|none||none| +|»»»» dataScope|string|false|none||none| +|»»»» status|string|false|none||none| +|»»» userId|string|true|none||none| +|»»» deptId|string|true|none||none| +|»»» userName|string|true|none||none| +|»»» nickName|string|true|none||none| +|»»» userType|string|true|none||none| +|»»» email|string|true|none||none| +|»»» avatar|string|true|none||none| +|»»» phonenumber|string|true|none||none| +|»»» sex|string|true|none||none| +|»»» status|string|true|none||none| +|»»» delFlag|string|true|none||none| +|»»» loginIp|string|true|none||none| +|»»» loginDate|integer|false|none||none| +|»»» createBy|string|false|none||none| +|»»» createTime|integer|false|none||none| +|»»» remark|string|true|none||none| +|»»» dept|object|false|none||none| +|»»»» deptId|string|true|none||none| +|»»»» parentId|string|false|none||none| +|»»»» ancestors|string|true|none||none| +|»»»» deptName|string|true|none||none| +|»»»» orderNum|integer|true|none||none| +|»»»» leader|string|true|none||none| +|»»»» status|string|true|none||none| + +## GET 登录路由信息 + +GET /getRouters + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [ + { + "name": "System", + "path": "/system", + "component": "BasicLayout", + "meta": { + "icon": "icon-pcduan", + "title": "系统管理", + "hide": false, + "cache": true, + "target": null + }, + "redirect": "/system/user", + "children": [ + { + "name": "User", + "path": "user", + "component": "system/user/index", + "meta": { + "icon": "icon-pcduan", + "title": "用户管理", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "Role", + "path": "role", + "component": "system/role/index", + "meta": { + "icon": "icon-pcduan", + "title": "角色管理", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "RoleinlineauthuserroleId", + "path": "role/inline/auth-user/:roleId", + "component": "system/role/auth-user", + "meta": { + "icon": "icon-pcduan", + "title": "角色分配用户", + "hide": true, + "cache": false, + "target": null + } + }, + { + "name": "Menu", + "path": "menu", + "component": "system/menu/index", + "meta": { + "icon": "icon-pcduan", + "title": "菜单管理", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "Dept", + "path": "dept", + "component": "system/dept/index", + "meta": { + "icon": "icon-pcduan", + "title": "部门管理", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "Post", + "path": "post", + "component": "system/post/index", + "meta": { + "icon": "icon-pcduan", + "title": "岗位管理", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "Dict", + "path": "dict", + "component": "system/dict/index", + "meta": { + "icon": "icon-pcduan", + "title": "字典管理", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "DictinlinedatadictId", + "path": "dict/inline/data/:dictId", + "component": "system/dict/data", + "meta": { + "icon": "icon-pcduan", + "title": "字典数据", + "hide": true, + "cache": false, + "target": null + } + }, + { + "name": "Config", + "path": "config", + "component": "system/config/index", + "meta": { + "icon": "icon-pcduan", + "title": "参数设置", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "Notice", + "path": "notice", + "component": "system/notice/index", + "meta": { + "icon": "icon-pcduan", + "title": "通知公告", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "Log", + "path": "log", + "component": "BlankLayout", + "meta": { + "icon": "icon-pcduan", + "title": "日志管理", + "hide": false, + "cache": true, + "target": null + }, + "redirect": "/system/log/operlog", + "children": [ + { + "name": "Operlog", + "path": "operlog", + "component": "monitor/operlog/index", + "meta": { + "icon": "icon-pcduan", + "title": "操作日志", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "Logininfor", + "path": "logininfor", + "component": "monitor/logininfor/index", + "meta": { + "icon": "icon-pcduan", + "title": "登录日志", + "hide": false, + "cache": true, + "target": null + } + } + ] + } + ] + }, + { + "name": "Monitor", + "path": "/monitor", + "component": "BasicLayout", + "meta": { + "icon": "icon-pcduan", + "title": "系统监控", + "hide": false, + "cache": true, + "target": null + }, + "redirect": "/monitor/server", + "children": [ + { + "name": "Server", + "path": "server", + "component": "monitor/server/index", + "meta": { + "icon": "icon-pcduan", + "title": "服务监控", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "Cache", + "path": "cache", + "component": "monitor/cache/index", + "meta": { + "icon": "icon-pcduan", + "title": "缓存监控", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "CacheList", + "path": "cacheList", + "component": "monitor/cache/list", + "meta": { + "icon": "icon-pcduan", + "title": "缓存列表", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "Online", + "path": "online", + "component": "monitor/online/index", + "meta": { + "icon": "icon-pcduan", + "title": "在线用户", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "Job", + "path": "job", + "component": "monitor/job/index", + "meta": { + "icon": "icon-pcduan", + "title": "调度任务", + "hide": false, + "cache": true, + "target": null + } + }, + { + "name": "JobinlinelogjobId", + "path": "job/inline/log/:jobId", + "component": "monitor/job/log", + "meta": { + "icon": "icon-pcduan", + "title": "调度日志", + "hide": true, + "cache": true, + "target": null + } + } + ] + }, + { + "name": "Tool", + "path": "/tool", + "component": "BasicLayout", + "meta": { + "icon": "icon-pcduan", + "title": "系统工具", + "hide": false, + "cache": true, + "target": null + }, + "redirect": "/tool/swagger", + "children": [ + { + "name": "Swagger", + "path": "swagger", + "component": "tool/swagger/index", + "meta": { + "icon": "icon-pcduan", + "title": "系统接口", + "hide": false, + "cache": true, + "target": null + } + } + ] + }, + { + "name": "HttpsLink4", + "path": "https://gitee.com/TsMask/mask_api_midwayjs", + "component": "BasicLayout", + "meta": { + "icon": "icon-pcduan", + "title": "Gitee仓库", + "hide": false, + "cache": false, + "target": "_blank" + } + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[object]|true|none|路由数组|none| +|»» name|string|true|none|路由名称|none| +|»» path|string|true|none|路由地址|none| +|»» component|string|true|none|组件|- BasicLayout-基础布局组件标识 菜单类型-菜单D
- BlankLayout-空白布局组件标识 菜单类型-菜单M
- LinkLayout-内链接布局组件标识 菜单类型-菜单M
- 按钮菜单类型-菜单B 不会读取到路由中| +|»» meta|object|false|none|元数据|none| +|»»» icon|string|false|none|菜单图标|none| +|»»» title|string|false|none|菜单标题|none| +|»»» hide|boolean|false|none|是否隐藏|默认 false| +|»»» cache|boolean|false|none|是否缓存|默认 false| +|»»» target|string|false|none|链接行为|- 非链接 null
- 内部跳转 _self
- 外部跳转 _blank| +|»» redirect|string|false|none|目录重定向|none| +|»» children|[object]|false|none|子菜单|none| +|»»» name|string|true|none||none| +|»»» path|string|true|none||none| +|»»» component|string|false|none||none| +|»»» meta|object|false|none|元数据|none| +|»»»» icon|string|false|none||none| +|»»»» title|string|false|none|标题|none| +|»»»» hide|boolean|false|none||none| +|»»»» cache|boolean|false|none||none| +|»»»» target|string|false|none||none| + +## POST 系统登录 + +POST /login + +> Body Parameters + +```json +{ + "username": "admin", + "password": "rootaa", + "code": "{{code-text}}", + "uuid": "{{code-uuid}}" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» username|body|string| yes | 登录名|none| +|» password|body|string| yes | 密码|none| +|» code|body|string| yes | 验证码值|none| +|» uuid|body|string| yes | 验证码唯一标识|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb2dpbl9rZXkiOiIwamJmM3J1anRyamdibHNtOW44Mnk4Z2gxcTZmN2s1OCIsInVzZXJfaWQiOiIxIiwiaWF0IjoxNjgzOTY1ODEwLCJleHAiOjE2ODQwMDQyMTB9.rOChRhSPUi7ps6F3QLGMBB8IIOgrfYv2S5ApgxHjtXo" + } +} +``` + +```json +{ + "code": 500, + "msg": "验证码已失效" +} +``` + +```json +{ + "code": 500, + "msg": "验证码错误" +} +``` + +```json +{ + "code": 2, + "data": "tUwUZC14lA8LuOdA3sjmeQuKWsepythNj8Kf4x88kM5ApuYH0NMG/a+Q2WMSCJbTRT00UpThkWHbKWGSWU63rsJAW4E9aoosRLlVyzhyGlbnsiHgE5Cp2LNevlbmsPCbSADcWC9a5P58BuVYLy6O13bhuBSogrk7l1ogPuT2L9sQC/G30lLLDLKIn4nfrx90p4opCsZ58uvP97gXaLxeKUsWwjsqY0UxqCjllgLEYAilm2lCmPjZp0axmap2qCaLUQbuzmAqHPa0j6z7sLemRLZdEYLjz3+06P08sepPy9ls4T1f70yMcwsJ/jiKi9sLJKcD2Gt61FSqK88MLhMViVbAAdr4CtcM766yBzhQ/XKeBVcHNbNp4rdWkCEzSe3wqyACPFV0qlCWl2W+mxvcqw==", + "msg": "encrypt" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|string|false|none||none| + +## POST 系统登出 + +POST /logout + +对IP进行限流 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| no ||授权令牌，可有可无| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "退出成功" +} +``` + +```json +{ + "code": 500, + "msg": "访问过于频繁，请稍候再试" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none|固定值|none| +|» msg|string|true|none|固定值|none| + +# 中文src目录接口/通用模块/账号注册操作 + +## POST 系统注册 + +POST /register + +> Body Parameters + +```json +{ + "username": "string", + "password": "string", + "confirmPassword": "string", + "code": "string", + "uuid": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» username|body|string| yes | 用户名|none| +|» password|body|string| yes | 密码|none| +|» confirmPassword|body|string| yes | 确认密码|none| +|» code|body|string| yes | 验证码值|none| +|» uuid|body|string| yes | 验证码唯一标识|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "当前系统没有开启注册功能！" +} +``` + +```json +{ + "code": 500, + "msg": "注册用户【xxxx】失败，注册账号已存在" +} +``` + +```json +{ + "code": 500, + "msg": "账号不能以数字开头，可包含大写小写字母，数字，且不少于5位" +} +``` + +```json +{ + "code": 500, + "msg": "密码至少包含大小写字母、数字、特殊符号，且不少于6位" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/通用模块/启动引导初始化 + +## POST 首次引导开始 + +POST /bootloader + +确认完成后，该接口将不可重复调用 +用户ID: 1 的用户数据，超级管理 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb2dpbl9rZXkiOiIwamJmM3J1anRyamdibHNtOW44Mnk4Z2gxcTZmN2s1OCIsInVzZXJfaWQiOiIxIiwiaWF0IjoxNjgzOTY1ODEwLCJleHAiOjE2ODQwMDQyMTB9.rOChRhSPUi7ps6F3QLGMBB8IIOgrfYv2S5ApgxHjtXo" + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|false|none||none| +|»» access_token|string|true|none|授权令牌|none| + +## PUT 首次引导完成 + +PUT /bootloader + +确认完成后，该接口将不可重复调用 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{ + "code": 0, + "msg": "string" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 引导系统数据重置 + +DELETE /bootloader + +确认完成后，该接口将不可重复调用 +系统数据将会重新加载 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{ + "code": 0, + "msg": "string" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 管理员账号变更 + +PUT /bootloader/account + +确认完成后，该接口将不可重复调用 +指定修改用户ID: 2 的用户数据 + +> Body Parameters + +```json +{ + "username": "admin", + "password": "Abcd1234.." +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» username|body|string| yes ||账号| +|» password|body|string| yes ||密码| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/监控模块/缓存信息 + +## GET 缓存监控信息 + +GET /monitor/cache + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "info": { + "server": { + "redis_version": "7.0.5", + "redis_git_sha1": "00000000", + "redis_git_dirty": "0", + "redis_build_id": "aab17434977410f1", + "redis_mode": "standalone", + "os": "Linux 5.4.0-137-generic x86_64", + "arch_bits": "64", + "monotonic_clock": "POSIX clock_gettime", + "multiplexing_api": "epoll", + "atomicvar_api": "c11-builtin", + "gcc_version": "10.2.1", + "process_id": "1", + "process_supervised": "no", + "run_id": "94ee88d0059383b5c1a29d292dbdcb228022c001", + "tcp_port": "6379", + "server_time_usec": "1683985833118338", + "uptime_in_seconds": "25513", + "uptime_in_days": "0", + "hz": "10", + "configured_hz": "10", + "lru_clock": "6264233", + "executable": "/data/redis-server", + "config_file": "/etc/redis/redis.conf", + "io_threads_active": "0" + }, + "clients": { + "connected_clients": "11", + "cluster_connections": "0", + "maxclients": "10000", + "client_recent_max_input_buffer": "20565", + "client_recent_max_output_buffer": "0", + "blocked_clients": "3", + "tracking_clients": "0", + "clients_in_timeout_table": "3" + }, + "memory": { + "used_memory": "1664304", + "used_memory_human": "1.59M", + "used_memory_rss": "9228288", + "used_memory_rss_human": "8.80M", + "used_memory_peak": "1917352", + "used_memory_peak_human": "1.83M", + "used_memory_peak_perc": "86.80%", + "used_memory_overhead": "978099", + "used_memory_startup": "863272", + "used_memory_dataset": "686205", + "used_memory_dataset_perc": "85.67%", + "allocator_allocated": "1851152", + "allocator_active": "2396160", + "allocator_resident": "4734976", + "total_system_memory": "2079748096", + "total_system_memory_human": "1.94G", + "used_memory_lua": "59392", + "used_memory_vm_eval": "59392", + "used_memory_lua_human": "58.00K", + "used_memory_scripts_eval": "5608", + "number_of_cached_scripts": "3", + "number_of_functions": "0", + "number_of_libraries": "0", + "used_memory_vm_functions": "32768", + "used_memory_vm_total": "92160", + "used_memory_vm_total_human": "90.00K", + "used_memory_functions": "184", + "used_memory_scripts": "5792", + "used_memory_scripts_human": "5.66K", + "maxmemory": "0", + "maxmemory_human": "0B", + "maxmemory_policy": "noeviction", + "allocator_frag_ratio": "1.29", + "allocator_frag_bytes": "545008", + "allocator_rss_ratio": "1.98", + "allocator_rss_bytes": "2338816", + "rss_overhead_ratio": "1.95", + "rss_overhead_bytes": "4493312", + "mem_fragmentation_ratio": "5.55", + "mem_fragmentation_bytes": "7565808", + "mem_not_counted_for_evict": "3584", + "mem_replication_backlog": "0", + "mem_total_replication_buffers": "0", + "mem_clients_slaves": "0", + "mem_clients_normal": "102107", + "mem_cluster_links": "0", + "mem_aof_buffer": "3584", + "mem_allocator": "jemalloc-5.2.1", + "active_defrag_running": "0", + "lazyfree_pending_objects": "0", + "lazyfreed_objects": "0" + }, + "persistence": { + "loading": "0", + "async_loading": "0", + "current_cow_peak": "0", + "current_cow_size": "0", + "current_cow_size_age": "0", + "current_fork_perc": "0.00", + "current_save_keys_processed": "0", + "current_save_keys_total": "0", + "rdb_changes_since_last_save": "28", + "rdb_bgsave_in_progress": "0", + "rdb_last_save_time": "1683985267", + "rdb_last_bgsave_status": "ok", + "rdb_last_bgsave_time_sec": "0", + "rdb_current_bgsave_time_sec": "-1", + "rdb_saves": "18", + "rdb_last_cow_size": "901120", + "rdb_last_load_keys_expired": "0", + "rdb_last_load_keys_loaded": "0", + "aof_enabled": "1", + "aof_rewrite_in_progress": "0", + "aof_rewrite_scheduled": "0", + "aof_last_rewrite_time_sec": "-1", + "aof_current_rewrite_time_sec": "-1", + "aof_last_bgrewrite_status": "ok", + "aof_rewrites": "0", + "aof_rewrites_consecutive_failures": "0", + "aof_last_write_status": "ok", + "aof_last_cow_size": "0", + "module_fork_in_progress": "0", + "module_fork_last_cow_size": "0", + "aof_current_size": "52707266", + "aof_base_size": "88", + "aof_pending_rewrite": "0", + "aof_buffer_length": "0", + "aof_pending_bio_fsync": "0", + "aof_delayed_fsync": "0" + }, + "stats": { + "total_connections_received": "139", + "total_commands_processed": "215944", + "instantaneous_ops_per_sec": "5", + "total_net_input_bytes": "6096966", + "total_net_output_bytes": "546971", + "total_net_repl_input_bytes": "0", + "total_net_repl_output_bytes": "0", + "instantaneous_input_kbps": "0.60", + "instantaneous_output_kbps": "0.01", + "instantaneous_input_repl_kbps": "0.00", + "instantaneous_output_repl_kbps": "0.00", + "rejected_connections": "0", + "sync_full": "0", + "sync_partial_ok": "0", + "sync_partial_err": "0", + "expired_keys": "1270", + "expired_stale_perc": "0.00", + "expired_time_cap_reached_count": "0", + "expire_cycle_cpu_milliseconds": "712", + "evicted_keys": "0", + "evicted_clients": "0", + "total_eviction_exceeded_time": "0", + "current_eviction_exceeded_time": "0", + "keyspace_hits": "1580", + "keyspace_misses": "27951", + "pubsub_channels": "3", + "pubsub_patterns": "0", + "pubsubshard_channels": "0", + "latest_fork_usec": "275", + "total_forks": "18", + "migrate_cached_sockets": "0", + "slave_expires_tracked_keys": "0", + "active_defrag_hits": "0", + "active_defrag_misses": "0", + "active_defrag_key_hits": "0", + "active_defrag_key_misses": "0", + "total_active_defrag_time": "0", + "current_active_defrag_time": "0", + "tracking_total_keys": "0", + "tracking_total_items": "0", + "tracking_total_prefixes": "0", + "unexpected_error_replies": "0", + "total_error_replies": "0", + "dump_payload_sanitizations": "0", + "total_reads_processed": "29542", + "total_writes_processed": "29425", + "io_threaded_reads_processed": "0", + "io_threaded_writes_processed": "0", + "reply_buffer_shrinks": "135", + "reply_buffer_expands": "9" + }, + "replication": { + "role": "master", + "connected_slaves": "0", + "master_failover_state": "no-failover", + "master_replid": "08e7cd72f9ecda6c4fd3e1e8504571203bb61290", + "master_replid2": "0000000000000000000000000000000000000000", + "master_repl_offset": "0", + "second_repl_offset": "-1", + "repl_backlog_active": "0", + "repl_backlog_size": "1048576", + "repl_backlog_first_byte_offset": "0", + "repl_backlog_histlen": "0" + }, + "cpu": { + "used_cpu_sys": "21.297760", + "used_cpu_user": "30.032301", + "used_cpu_sys_children": "0.033118", + "used_cpu_user_children": "0.030797", + "used_cpu_sys_main_thread": "20.252124", + "used_cpu_user_main_thread": "30.825211" + }, + "modules": {}, + "errorstats": {}, + "cluster": { + "cluster_enabled": "0" + }, + "keyspace": { + "db0": "keys=19,expires=0,avg_ttl=0", + "db1": "keys=22,expires=3,avg_ttl=21492323" + } + }, + "dbSize": 22, + "commandStats": [ + { + "name": "brpoplpush", + "value": "12044" + }, + { + "name": "get", + "value": "545" + }, + { + "name": "incr", + "value": "144" + }, + { + "name": "smembers", + "value": "1207" + }, + { + "name": "scan", + "value": "13" + }, + { + "name": "subscribe", + "value": "36" + }, + { + "name": "del", + "value": "147" + }, + { + "name": "auth", + "value": "139" + }, + { + "name": "exists", + "value": "2145" + }, + { + "name": "lrange", + "value": "1207" + }, + { + "name": "type", + "value": "28" + }, + { + "name": "ttl", + "value": "189" + }, + { + "name": "quit", + "value": "51" + }, + { + "name": "keys", + "value": "22" + }, + { + "name": "evalsha", + "value": "14200" + }, + { + "name": "select", + "value": "139" + }, + { + "name": "expire", + "value": "44" + }, + { + "name": "info", + "value": "61" + }, + { + "name": "zrevrange", + "value": "36" + }, + { + "name": "config|get", + "value": "9" + }, + { + "name": "zrangebyscore", + "value": "12087" + }, + { + "name": "client|setname", + "value": "37" + }, + { + "name": "ping", + "value": "1765" + }, + { + "name": "zrange", + "value": "12087" + }, + { + "name": "set", + "value": "1420" + }, + { + "name": "dbsize", + "value": "2" + }, + { + "name": "eval", + "value": "83" + } + ] + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» info|object|true|none||none| +|»»» server|object|true|none|服务|none| +|»»»» redis_version|string|true|none|Redis版本|none| +|»»»» redis_git_sha1|string|true|none||none| +|»»»» redis_git_dirty|string|true|none||none| +|»»»» redis_build_id|string|true|none||none| +|»»»» redis_mode|string|true|none|运行模式|none| +|»»»» os|string|true|none|服务系统|none| +|»»»» arch_bits|string|true|none||none| +|»»»» monotonic_clock|string|true|none||none| +|»»»» multiplexing_api|string|true|none||none| +|»»»» atomicvar_api|string|true|none||none| +|»»»» gcc_version|string|true|none||none| +|»»»» process_id|string|true|none||none| +|»»»» process_supervised|string|true|none||none| +|»»»» run_id|string|true|none||none| +|»»»» tcp_port|string|true|none|端口|none| +|»»»» server_time_usec|string|true|none||none| +|»»»» uptime_in_seconds|string|true|none|运行时间(秒)|none| +|»»»» uptime_in_days|string|true|none|运行时间(天)|none| +|»»»» hz|string|true|none||none| +|»»»» configured_hz|string|true|none||none| +|»»»» lru_clock|string|true|none||none| +|»»»» executable|string|true|none||none| +|»»»» config_file|string|true|none|配置文件|none| +|»»»» io_threads_active|string|true|none||none| +|»»» clients|object|true|none|客户端|none| +|»»»» connected_clients|string|true|none|客户端数|none| +|»»»» cluster_connections|string|true|none||none| +|»»»» maxclients|string|true|none||none| +|»»»» client_recent_max_input_buffer|string|true|none||none| +|»»»» client_recent_max_output_buffer|string|true|none||none| +|»»»» blocked_clients|string|true|none||none| +|»»»» tracking_clients|string|true|none||none| +|»»»» clients_in_timeout_table|string|true|none||none| +|»»» memory|object|true|none|内存|none| +|»»»» used_memory|string|true|none|总内存|none| +|»»»» used_memory_human|string|true|none|使用内存|none| +|»»»» used_memory_rss|string|true|none||none| +|»»»» used_memory_rss_human|string|true|none||none| +|»»»» used_memory_peak|string|true|none||none| +|»»»» used_memory_peak_human|string|true|none||none| +|»»»» used_memory_peak_perc|string|true|none||none| +|»»»» used_memory_overhead|string|true|none||none| +|»»»» used_memory_startup|string|true|none||none| +|»»»» used_memory_dataset|string|true|none||none| +|»»»» used_memory_dataset_perc|string|true|none||none| +|»»»» allocator_allocated|string|true|none||none| +|»»»» allocator_active|string|true|none||none| +|»»»» allocator_resident|string|true|none||none| +|»»»» total_system_memory|string|true|none||none| +|»»»» total_system_memory_human|string|true|none||none| +|»»»» used_memory_lua|string|true|none||none| +|»»»» used_memory_vm_eval|string|true|none||none| +|»»»» used_memory_lua_human|string|true|none||none| +|»»»» used_memory_scripts_eval|string|true|none||none| +|»»»» number_of_cached_scripts|string|true|none||none| +|»»»» number_of_functions|string|true|none||none| +|»»»» number_of_libraries|string|true|none||none| +|»»»» used_memory_vm_functions|string|true|none||none| +|»»»» used_memory_vm_total|string|true|none||none| +|»»»» used_memory_vm_total_human|string|true|none||none| +|»»»» used_memory_functions|string|true|none||none| +|»»»» used_memory_scripts|string|true|none||none| +|»»»» used_memory_scripts_human|string|true|none||none| +|»»»» maxmemory|string|true|none||none| +|»»»» maxmemory_human|string|true|none||none| +|»»»» maxmemory_policy|string|true|none||none| +|»»»» allocator_frag_ratio|string|true|none||none| +|»»»» allocator_frag_bytes|string|true|none||none| +|»»»» allocator_rss_ratio|string|true|none||none| +|»»»» allocator_rss_bytes|string|true|none||none| +|»»»» rss_overhead_ratio|string|true|none||none| +|»»»» rss_overhead_bytes|string|true|none||none| +|»»»» mem_fragmentation_ratio|string|true|none||none| +|»»»» mem_fragmentation_bytes|string|true|none||none| +|»»»» mem_not_counted_for_evict|string|true|none||none| +|»»»» mem_replication_backlog|string|true|none||none| +|»»»» mem_total_replication_buffers|string|true|none||none| +|»»»» mem_clients_slaves|string|true|none||none| +|»»»» mem_clients_normal|string|true|none||none| +|»»»» mem_cluster_links|string|true|none||none| +|»»»» mem_aof_buffer|string|true|none||none| +|»»»» mem_allocator|string|true|none||none| +|»»»» active_defrag_running|string|true|none||none| +|»»»» lazyfree_pending_objects|string|true|none||none| +|»»»» lazyfreed_objects|string|true|none||none| +|»»» persistence|object|true|none||none| +|»»»» loading|string|true|none||none| +|»»»» async_loading|string|true|none||none| +|»»»» current_cow_peak|string|true|none||none| +|»»»» current_cow_size|string|true|none||none| +|»»»» current_cow_size_age|string|true|none||none| +|»»»» current_fork_perc|string|true|none||none| +|»»»» current_save_keys_processed|string|true|none||none| +|»»»» current_save_keys_total|string|true|none||none| +|»»»» rdb_changes_since_last_save|string|true|none||none| +|»»»» rdb_bgsave_in_progress|string|true|none||none| +|»»»» rdb_last_save_time|string|true|none||none| +|»»»» rdb_last_bgsave_status|string|true|none|RDB是否成功|none| +|»»»» rdb_last_bgsave_time_sec|string|true|none||none| +|»»»» rdb_current_bgsave_time_sec|string|true|none||none| +|»»»» rdb_saves|string|true|none||none| +|»»»» rdb_last_cow_size|string|true|none||none| +|»»»» rdb_last_load_keys_expired|string|true|none||none| +|»»»» rdb_last_load_keys_loaded|string|true|none||none| +|»»»» aof_enabled|string|true|none|AOF是否开启|none| +|»»»» aof_rewrite_in_progress|string|true|none||none| +|»»»» aof_rewrite_scheduled|string|true|none||none| +|»»»» aof_last_rewrite_time_sec|string|true|none||none| +|»»»» aof_current_rewrite_time_sec|string|true|none||none| +|»»»» aof_last_bgrewrite_status|string|true|none||none| +|»»»» aof_rewrites|string|true|none||none| +|»»»» aof_rewrites_consecutive_failures|string|true|none||none| +|»»»» aof_last_write_status|string|true|none||none| +|»»»» aof_last_cow_size|string|true|none||none| +|»»»» module_fork_in_progress|string|true|none||none| +|»»»» module_fork_last_cow_size|string|true|none||none| +|»»»» aof_current_size|string|true|none||none| +|»»»» aof_base_size|string|true|none||none| +|»»»» aof_pending_rewrite|string|true|none||none| +|»»»» aof_buffer_length|string|true|none||none| +|»»»» aof_pending_bio_fsync|string|true|none||none| +|»»»» aof_delayed_fsync|string|true|none||none| +|»»» stats|object|true|none||none| +|»»»» total_connections_received|string|true|none||none| +|»»»» total_commands_processed|string|true|none||none| +|»»»» instantaneous_ops_per_sec|string|true|none||none| +|»»»» total_net_input_bytes|string|true|none||none| +|»»»» total_net_output_bytes|string|true|none||none| +|»»»» total_net_repl_input_bytes|string|true|none||none| +|»»»» total_net_repl_output_bytes|string|true|none||none| +|»»»» instantaneous_input_kbps|string|true|none|网络入口|none| +|»»»» instantaneous_output_kbps|string|true|none|网络出口|none| +|»»»» instantaneous_input_repl_kbps|string|true|none||none| +|»»»» instantaneous_output_repl_kbps|string|true|none||none| +|»»»» rejected_connections|string|true|none||none| +|»»»» sync_full|string|true|none||none| +|»»»» sync_partial_ok|string|true|none||none| +|»»»» sync_partial_err|string|true|none||none| +|»»»» expired_keys|string|true|none||none| +|»»»» expired_stale_perc|string|true|none||none| +|»»»» expired_time_cap_reached_count|string|true|none||none| +|»»»» expire_cycle_cpu_milliseconds|string|true|none||none| +|»»»» evicted_keys|string|true|none||none| +|»»»» evicted_clients|string|true|none||none| +|»»»» total_eviction_exceeded_time|string|true|none||none| +|»»»» current_eviction_exceeded_time|string|true|none||none| +|»»»» keyspace_hits|string|true|none||none| +|»»»» keyspace_misses|string|true|none||none| +|»»»» pubsub_channels|string|true|none||none| +|»»»» pubsub_patterns|string|true|none||none| +|»»»» pubsubshard_channels|string|true|none||none| +|»»»» latest_fork_usec|string|true|none||none| +|»»»» total_forks|string|true|none||none| +|»»»» migrate_cached_sockets|string|true|none||none| +|»»»» slave_expires_tracked_keys|string|true|none||none| +|»»»» active_defrag_hits|string|true|none||none| +|»»»» active_defrag_misses|string|true|none||none| +|»»»» active_defrag_key_hits|string|true|none||none| +|»»»» active_defrag_key_misses|string|true|none||none| +|»»»» total_active_defrag_time|string|true|none||none| +|»»»» current_active_defrag_time|string|true|none||none| +|»»»» tracking_total_keys|string|true|none||none| +|»»»» tracking_total_items|string|true|none||none| +|»»»» tracking_total_prefixes|string|true|none||none| +|»»»» unexpected_error_replies|string|true|none||none| +|»»»» total_error_replies|string|true|none||none| +|»»»» dump_payload_sanitizations|string|true|none||none| +|»»»» total_reads_processed|string|true|none||none| +|»»»» total_writes_processed|string|true|none||none| +|»»»» io_threaded_reads_processed|string|true|none||none| +|»»»» io_threaded_writes_processed|string|true|none||none| +|»»»» reply_buffer_shrinks|string|true|none||none| +|»»»» reply_buffer_expands|string|true|none||none| +|»»» replication|object|true|none||none| +|»»»» role|string|true|none||none| +|»»»» connected_slaves|string|true|none||none| +|»»»» master_failover_state|string|true|none||none| +|»»»» master_replid|string|true|none||none| +|»»»» master_replid2|string|true|none||none| +|»»»» master_repl_offset|string|true|none||none| +|»»»» second_repl_offset|string|true|none||none| +|»»»» repl_backlog_active|string|true|none||none| +|»»»» repl_backlog_size|string|true|none||none| +|»»»» repl_backlog_first_byte_offset|string|true|none||none| +|»»»» repl_backlog_histlen|string|true|none||none| +|»»» cpu|object|true|none|CPU|none| +|»»»» used_cpu_sys|string|true|none||none| +|»»»» used_cpu_user|string|true|none||none| +|»»»» used_cpu_sys_children|string|true|none||none| +|»»»» used_cpu_user_children|string|true|none||none| +|»»»» used_cpu_sys_main_thread|string|true|none||none| +|»»»» used_cpu_user_main_thread|string|true|none||none| +|»»» modules|object|true|none||none| +|»»» errorstats|object|true|none||none| +|»»» cluster|object|true|none|集群|none| +|»»»» cluster_enabled|string|true|none||none| +|»»» keyspace|object|true|none||none| +|»»»» db0|string|true|none||none| +|»»»» db1|string|true|none||none| +|»» dbSize|integer|true|none|Key数量|none| +|»» commandStats|[object]|true|none|命令统计|none| +|»»» name|string|true|none||none| +|»»» value|string|true|none||none| + +## GET 缓存名称列表 + +GET /monitor/cache/getNames + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [ + { + "cacheName": "login_tokens", + "cacheKey": "", + "cacheValue": "", + "remark": "用户信息" + }, + { + "cacheName": "sys_config", + "cacheKey": "", + "cacheValue": "", + "remark": "配置信息" + }, + { + "cacheName": "sys_dict", + "cacheKey": "", + "cacheValue": "", + "remark": "数据字典" + }, + { + "cacheName": "captcha_codes", + "cacheKey": "", + "cacheValue": "", + "remark": "验证码" + }, + { + "cacheName": "repeat_submit", + "cacheKey": "", + "cacheValue": "", + "remark": "防重提交" + }, + { + "cacheName": "rate_limit", + "cacheKey": "", + "cacheValue": "", + "remark": "限流处理" + }, + { + "cacheName": "pwd_err_cnt", + "cacheKey": "", + "cacheValue": "", + "remark": "密码错误次数" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[object]|true|none||none| +|»» cacheName|string|true|none|缓存名称|none| +|»» cacheKey|string|true|none|缓存键名|空字符串| +|»» cacheValue|string|true|none|缓存内容|空字符串| +|»» remark|string|true|none|备注|none| + +## GET 缓存名称下键名列表 + +GET /monitor/cache/getKeys/{cacheName} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|cacheName|path|string| yes ||缓存名称列表中得到的缓存名称| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [ + { + "cacheName": "sys_config", + "cacheKey": "sys.user.initPassword", + "cacheValue": "", + "remark": "" + }, + { + "cacheName": "sys_config", + "cacheKey": "sys.account.captchaEnabled", + "cacheValue": "", + "remark": "" + }, + { + "cacheName": "sys_config", + "cacheKey": "sys.account.registerUser", + "cacheValue": "", + "remark": "" + }, + { + "cacheName": "sys_config", + "cacheKey": "sys.account.captchaType", + "cacheValue": "", + "remark": "" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[object]|true|none||none| +|»» cacheName|string|true|none|缓存名称|缓存名称列表中得到的缓存名称| +|»» cacheKey|string|true|none|缓存键名|none| +|»» cacheValue|string|true|none|缓存内容|空字符串| +|»» remark|string|true|none|备注|空字符串| + +## GET 缓存内容 + +GET /monitor/cache/getValue/{cacheName}/{cacheKey} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|cacheName|path|string| yes ||键名列表中得到的缓存名称| +|cacheKey|path|string| yes ||键名列表中得到的缓存键名| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "cacheName": "sys_config", + "cacheKey": "sys.account.captchaType", + "cacheValue": "math", + "remark": "" + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» cacheName|string|true|none|缓存名称|键名列表中得到的缓存名称| +|»» cacheKey|string|true|none|缓存名称|键名列表中得到的缓存键名| +|»» cacheValue|string|true|none|缓存内容|none| +|»» remark|string|true|none|备注|空字符串| + +## DELETE 删除缓存键名 + +DELETE /monitor/cache/clearCacheKey/{cacheName}/{cacheKey} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|cacheName|path|string| yes ||键名列表中得到的缓存名称| +|cacheKey|path|string| yes ||键名列表中得到的缓存键名| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 删除缓存名称下键名列表 + +DELETE /monitor/cache/clearCacheName/{cacheName} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|cacheName|path|string| yes ||缓存名称列表中得到的缓存名称| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 安全清理缓存名称 + +DELETE /monitor/cache/clearCacheSafe + +指定可清理的缓存键名 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/监控模块/调度任务日志信息 + +## POST 调度任务日志列表导出 + +POST /monitor/jobLog/export + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=jobLog_export_1_1684058366284.xlsx +content-length: 17079 +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +> Body Parameters + +```json +{ + "jobName": "string", + "jobGroup": "string", + "status": "string", + "pageNum": 0, + "pageSize": 0, + "beginTime": "string", + "endTime": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» jobName|body|string| no | 任务名称|none| +|» jobGroup|body|string| no | 任务组名|none| +|» status|body|string| no | 执行状态|none| +|» pageNum|body|number| no | 页数，默认1|none| +|» pageSize|body|number| no | 单页记录数，默认10|none| +|» beginTime|body|string| no | 操作开始时间|none| +|» endTime|body|string| no | 操作结束时间|none| + +> Response Examples + +```json +{ + "code": 500, + "msg": "导出数据记录为空" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 调度任务日志列表 + +GET /monitor/jobLog/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|jobName|query|string| no ||任务名称| +|jobGroup|query|string| no ||任务组名| +|status|query|string| no ||执行状态| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 4, + "rows": [ + { + "jobLogId": "4", + "jobName": "2-20个字符", + "jobGroup": "DEFAULT", + "invokeTarget": "test", + "targetParams": "{\"a\":1,\"b\":1}", + "jobMsg": "{\"jobId\":\"103\",\"params\":\"{\\\"a\\\":1,\\\"b\\\":1}\"}", + "status": "1", + "createTime": "1684056232934" + }, + { + "jobLogId": "3", + "jobName": "2-20个字符", + "jobGroup": "DEFAULT", + "invokeTarget": "test", + "targetParams": "{\"a\":1,\"b\":1}", + "jobMsg": "{\"jobId\":\"103\",\"params\":\"{\\\"a\\\":1,\\\"b\\\":1}\"}", + "status": "1", + "createTime": "1684056199482" + }, + { + "jobLogId": "2", + "jobName": "2-20个字符", + "jobGroup": "DEFAULT", + "invokeTarget": "test", + "targetParams": "{\"a\":1,\"b\":1}", + "jobMsg": "{\"jobId\":\"103\",\"params\":\"{\\\"a\\\":1,\\\"b\\\":1}\"}", + "status": "1", + "createTime": "1684056090490" + }, + { + "jobLogId": "1", + "jobName": "异常执行", + "jobGroup": "SYSTEM", + "invokeTarget": "bar", + "targetParams": "字符串参数", + "jobMsg": "{\"name\":\"Error\",\"message\":\"程序中途执行错误\"}", + "status": "0", + "createTime": "1683901320750" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» jobLogId|string|true|none|日志ID|none| +|»» jobName|string|true|none|任务名|none| +|»» jobGroup|string|true|none|任务组|none| +|»» invokeTarget|string|true|none|任务目标|none| +|»» targetParams|string|true|none|任务参数|none| +|»» jobMsg|string|true|none|日志记录|none| +|»» status|string|true|none|状态|none| +|»» createTime|string|true|none|记录时间|none| + +## GET 调度任务日志信息 + +GET /monitor/jobLog/{jobLogId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|jobLogId|path|string| yes ||日志ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "jobLogId": "3", + "jobName": "2-20个字符", + "jobGroup": "DEFAULT", + "invokeTarget": "test", + "targetParams": "{\"a\":1,\"b\":1}", + "jobMsg": "{\"jobId\":\"103\",\"params\":\"{\\\"a\\\":1,\\\"b\\\":1}\"}", + "status": "1", + "createTime": "1684056199482" + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object¦null|true|none||none| +|»» jobLogId|string|true|none|日志ID|none| +|»» jobName|string|true|none|任务名|none| +|»» jobGroup|string|true|none|任务组|none| +|»» invokeTarget|string|true|none|任务目标|none| +|»» targetParams|string|true|none|任务参数|none| +|»» jobMsg|string|true|none|日志记录|none| +|»» status|string|true|none|状态|none| +|»» createTime|string|true|none|记录时间|none| + +## DELETE 调度任务日志删除 + +DELETE /monitor/jobLog/{jobLogIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|jobLogIds|path|string| yes ||日志ID，多个可用英文逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 调度任务日志清空 + +DELETE /monitor/jobLog/clean + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/监控模块/调度任务信息 + +## POST 调度任务列表导出 + +POST /monitor/job/export + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=job_export_6_1684058991890.xlsx +content-length: 19346 +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +> Body Parameters + +```json +{ + "jobName": "string", + "jobGroup": "string", + "status": "string", + "pageNum": 0, + "pageSize": 0 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» jobName|body|string| no | 任务名称|none| +|» jobGroup|body|string| no | 任务组名|none| +|» status|body|string| no | 执行状态|none| +|» pageNum|body|number| no | 页数，默认1|none| +|» pageSize|body|number| no | 单页记录数，默认10|none| + +> Response Examples + +```json +{ + "code": 500, + "msg": "导出数据记录为空" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 调度任务列表 + +GET /monitor/job/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|jobName|query|string| no ||任务名称| +|jobGroup|query|string| no ||任务组名| +|status|query|string| no ||任务状态| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 3, + "rows": [ + { + "jobId": "1", + "jobName": "触发执行", + "jobGroup": "SYSTEM", + "invokeTarget": "test", + "targetParams": "字符串参数", + "cronExpression": "0/10 * * * * ?", + "misfirePolicy": "3", + "concurrent": "0", + "status": "0", + "createBy": "maskAdmin", + "createTime": "1682264527348", + "remark": "" + }, + { + "jobId": "2", + "jobName": "缓慢执行", + "jobGroup": "SYSTEM", + "invokeTarget": "foo", + "targetParams": "字符串参数", + "cronExpression": "0/15 * * * * ?", + "misfirePolicy": "3", + "concurrent": "0", + "status": "0", + "createBy": "maskAdmin", + "createTime": "1682264527355", + "remark": "" + }, + { + "jobId": "3", + "jobName": "异常执行", + "jobGroup": "SYSTEM", + "invokeTarget": "bar", + "targetParams": "字符串参数", + "cronExpression": "0/20 * * * * ?", + "misfirePolicy": "3", + "concurrent": "0", + "status": "0", + "createBy": "maskAdmin", + "createTime": "1682264527364", + "remark": "" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» jobId|string|true|none|任务id|none| +|»» jobName|string|true|none|任务名|none| +|»» jobGroup|string|true|none|任务组|同组内不可同任务名| +|»» invokeTarget|string|true|none|调用目标|需要代码中通过 @Processor('xxx') 注册任务目标| +|»» targetParams|string|true|none|传入参数|标准json格式字符串| +|»» cronExpression|string|true|none|cron表达式|6位，最后?号不使用| +|»» misfirePolicy|string|true|none|执行策略|计划执行错误策略（1立即执行 2执行一次 3放弃执行）| +|»» concurrent|string|true|none|是否并发|是否并发执行（0禁止 1允许）| +|»» status|string|true|none|状态|none| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none|创建时间|none| +|»» remark|string|true|none|备注|none| + +## GET 调度任务信息 + +GET /monitor/job/{jobId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|jobId|path|string| yes ||任务ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "jobId": "1", + "jobName": "触发执行", + "jobGroup": "SYSTEM", + "invokeTarget": "test", + "targetParams": "字符串参数", + "cronExpression": "0/10 * * * * ?", + "misfirePolicy": "3", + "concurrent": "0", + "status": "0", + "createBy": "maskAdmin", + "createTime": "1682264527348", + "remark": "" + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object¦null|true|none||none| +|»» jobId|string|true|none|任务id|none| +|»» jobName|string|true|none|任务名|none| +|»» jobGroup|string|true|none|任务组|同组内不可同任务名| +|»» invokeTarget|string|true|none|调用目标|需要代码中通过 @Processor('xxx') 注册任务目标| +|»» targetParams|string|true|none|传入参数|标准json格式字符串| +|»» cronExpression|string|true|none|cron表达式|6位，最后?号不使用| +|»» misfirePolicy|string|true|none|执行策略|计划执行错误策略（1立即执行 2执行一次 3放弃执行）| +|»» concurrent|string|true|none|是否并发|是否并发执行（0禁止 1允许）| +|»» status|string|true|none|状态|none| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none|创建时间|none| +|»» remark|string|true|none|备注|none| + +## POST 调度任务新增 + +POST /monitor/job + +> Body Parameters + +```json +{ + "jobName": "2-20个字符", + "invokeTarget": "test1", + "cronExpression": "0/22 * * * * ?", + "misfirePolicy": "3", + "concurrent": "0", + "jobGroup": "DEFAULT", + "status": "ullamco minim Ut", + "targetParams": "{\"a\":1,\"b\":1}", + "remark": "asdf" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» jobName|body|string| yes | 任务名称|none| +|» jobGroup|body|string| yes | 任务组名|none| +|» invokeTarget|body|string| yes | 调用目标字符串|需要代码中通过 @Processor('xxx') 注册任务目标| +|» targetParams|body|string| yes | 调用目标传入参数|标准json格式字符串| +|» cronExpression|body|string| yes | cron执行表达式|6位，最后?号不使用| +|» misfirePolicy|body|string| yes | 计划执行错误策略|1立即执行 2执行一次 3放弃执行| +|» concurrent|body|string| yes | 是否并发执行|0禁止 1允许| +|» status|body|string| yes | 任务状态|0正常 1暂停| +|» remark|body|string| yes | 备注|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "调度任务新增【xxx】失败，同任务组内有相同任务名称" +} +``` + +```json +{ + "code": 500, + "msg": "调度任务新增【xxxx】失败，Cron表达式不正确" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 调度任务修改 + +PUT /monitor/job + +> Body Parameters + +```json +{ + "jobName": "大但任", + "invokeTarget": "test", + "cronExpression": "0/40 * * * * ?", + "misfirePolicy": "3", + "concurrent": "1", + "jobGroup": "SYSTEM", + "status": "0", + "targetParams": "{\"a\":1,\"b\":1}", + "remark": "据连思过维存斗维动南子听。", + "jobId": "2" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» jobId|body|string| yes | 任务ID|none| +|» jobName|body|string| yes | 任务名称|none| +|» jobGroup|body|string| yes | 任务组名|none| +|» invokeTarget|body|string| yes | 调用目标字符串|需要代码中通过 @Processor('xxx') 注册任务目标| +|» targetParams|body|string| yes | 调用目标传入参数|标准json格式字符串| +|» cronExpression|body|string| yes | cron执行表达式|6位，最后?号不使用| +|» misfirePolicy|body|string| yes | 计划执行错误策略|1立即执行 2执行一次 3放弃执行| +|» concurrent|body|string| yes | 是否并发执行|0禁止 1允许| +|» status|body|string| yes | 任务状态|0正常 1暂停| +|» remark|body|string| yes | 备注|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "调度任务修改【xxxx】失败，Cron表达式不正确" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 调度任务删除 + +DELETE /monitor/job/{jobIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|jobIds|path|string| yes ||任务ID，多个可用英文逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 调度任务修改状态 + +PUT /monitor/job/changeStatus + +> Body Parameters + +```json +{ + "jobId": "22", + "status": "0" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» jobId|body|string| yes | 任务ID|none| +|» status|body|string| yes | 变更的状态|0正常 1暂停| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 调度任务立即执行一次 + +PUT /monitor/job/run/{jobId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|jobId|path|string| yes ||任务ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 调度任务重置刷新队列 + +PUT /monitor/job/resetQueueJob + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/监控模块/在线用户信息 + +## GET 在线用户列表 + +GET /monitor/online/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|userName|query|string| no ||用户名称（登录账号）| +|ipaddr|query|string| no ||登录主机| +|Authorization|header|string| yes ||授权令牌| +|Referer|header|string| yes ||使用指定声明的Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "rows": [ + { + "tokenId": "vikufxmx625271bnddbe9t79p4pik5kv", + "userName": "maskAdmin", + "ipaddr": "127.0.0.1", + "loginLocation": "内网IP", + "browser": "未知 未知", + "os": "未知 未知", + "loginTime": 1684046645462, + "deptName": "研发部门" + }, + { + "tokenId": "lpatqefeohnxsnjpp28radugp0bovwt1", + "userName": "maskAdmin", + "ipaddr": "127.0.0.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "loginTime": 1684046560517, + "deptName": "研发部门" + } + ], + "total": 2 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» tokenId|string|true|none||none| +|»» userName|string|true|none||none| +|»» ipaddr|string|true|none|登录主机|none| +|»» loginLocation|string|true|none||none| +|»» browser|string|true|none||none| +|»» os|string|true|none||none| +|»» loginTime|integer|true|none||none| +|»» deptName|string|true|none||none| +|» total|integer|true|none||none| + +## DELETE 强退用户 + +DELETE /monitor/online/{tokenId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|tokenId|path|string| yes ||授权标识| +|Authorization|header|string| yes ||授权令牌| +|Referer|header|string| no ||使用指定声明的Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/监控模块/服务器监控信息 + +## GET 服务器服务信息 + +GET /monitor/system-info + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "project": { + "appDir": "E:\\Self\\Projects\\mask_api_midwayjs", + "env": "local", + "name": "mask_api_midwayjs", + "version": "0.0.5", + "dependencies": { + "@dropb/diskinfo": "^3.0.0", + "@midwayjs/bootstrap": "^3.0.0", + "@midwayjs/bull": "^3.0.0", + "@midwayjs/core": "^3.0.0", + "@midwayjs/decorator": "^3.0.0", + "@midwayjs/jwt": "^3.0.0", + "@midwayjs/koa": "^3.0.0", + "@midwayjs/cross-domain": "^3.0.0", + "@midwayjs/logger": "^2.0.0", + "@midwayjs/redis": "^3.0.0", + "@midwayjs/static-file": "^3.0.0", + "@midwayjs/typeorm": "^3.0.0", + "@midwayjs/upload": "^3.0.0", + "cron-parser": "^4.0.0", + "bcrypt": "^5.0.0", + "dayjs": "^1.0.0", + "mini-svg-data-uri": "^1.4.0", + "mysql2": "^2.0.0", + "nanoid": "^3.0.0", + "svg-captcha": "^1.4.0", + "typeorm": "^0.3.0", + "ua-parser-js": "^1.0.0", + "xlsx": "^0.18.0" + } + }, + "cpu": { + "model": "Intel(R) Core(TM) i5-9400 CPU @ 2.90GHz", + "speed": "2904MHz", + "core": 6, + "coreUsed": [ + "12.94", + "16.88", + "14.15", + "14.48", + "13.20", + "15.08" + ] + }, + "memory": { + "usage": "71.57", + "freemem": "4.51GB", + "totalmem": "15.88GB", + "rss": "309.80MB", + "heapTotal": "252.49MB", + "heapUsed": "246.27MB", + "external": "6.54MB" + }, + "network": { + "以太网 2": "IPv4 1.251.212.178", + "以太网": "IPv4 192.168.1.54 / IPv6 fe80::9906:92e5:b85e:3943", + "VirtualBox Host-Only Network": "IPv4 192.168.56.1 / IPv6 fe80::74da:97e8:b5e8:2c78", + "Loopback Pseudo-Interface 1": "IPv4 127.0.0.1 / IPv6 ::1" + }, + "time": { + "current": "2023-02-01 17:20:07", + "uptime": "8h", + "timezone": "GMT+0800", + "timezoneName": "中国标准时间" + }, + "system": { + "platform": "win32", + "node": "18.11.0", + "v8": "10.2.154.15-node.12", + "processId": 19988, + "arch": "x64", + "uname": "Windows_NT", + "release": "10.0.19045", + "hostname": "DESKTOP-QFRQUSF", + "homeDir": "C:\\Users\\LC1234", + "cmd": "E:\\Self\\Projects\\mask_api_midwayjs", + "execCommand": "D:\\Program Files\\nodejs\\node.exe E:\\Self\\Projects\\mask_api_midwayjs\\node_modules\\@midwayjs\\cli-plugin-dev\\dist\\child.js {\"baseDir\":\"E:\\\\Self\\\\Projects\\\\mask_api_midwayjs\\\\src\",\"_\":[\"dev\"],\"ts\":true,\"npm\":\"npm --registry=https://registry.npmmirror.com\",\"layers\":[],\"port\":\"6275\"} -r E:\\Self\\Projects\\mask_api_midwayjs\\node_modules\\ts-node\\register" + }, + "disk": [ + { + "size": "100.00GB", + "used": "91.22GB", + "avail": "8.78GB", + "pcent": "92%", + "target": "C:" + }, + { + "size": "174.00GB", + "used": "114.02GB", + "avail": "59.98GB", + "pcent": "66%", + "target": "D:" + }, + { + "size": "173.12GB", + "used": "138.62GB", + "avail": "34.50GB", + "pcent": "81%", + "target": "E:" + } + ] + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» project|object|true|none|项目|none| +|»»» appDir|string|true|none||none| +|»»» env|string|true|none||none| +|»»» name|string|true|none||none| +|»»» version|string|true|none||none| +|»»» dependencies|object|false|none||none| +|»»»» xlsx|string|true|none||none| +|»» cpu|object|true|none|CPU|none| +|»»» model|string|true|none||none| +|»»» speed|string|true|none||none| +|»»» core|integer|true|none||none| +|»»» coreUsed|[string]|true|none||none| +|»» memory|object|true|none|内存|none| +|»»» usage|string|true|none||none| +|»»» freemem|string|true|none||none| +|»»» totalmem|string|true|none||none| +|»»» rss|string|true|none||none| +|»»» heapTotal|string|true|none||none| +|»»» heapUsed|string|true|none||none| +|»»» external|string|true|none||none| +|»» network|object|false|none|网络|none| +|»»» 以太网 2|string|false|none||none| +|»»» 以太网|string|false|none||none| +|»»» VirtualBox Host-Only Network|string|false|none||none| +|»»» Loopback Pseudo-Interface 1|string|false|none||none| +|»» time|object|true|none|时间|none| +|»»» current|string|true|none||none| +|»»» uptime|string|true|none||none| +|»»» timezone|string|true|none||none| +|»»» timezoneName|string|true|none||none| +|»» system|object|true|none|系统|none| +|»»» platform|string|true|none||none| +|»»» node|string|true|none||none| +|»»» v8|string|true|none||none| +|»»» processId|integer|true|none||none| +|»»» arch|string|true|none||none| +|»»» uname|string|true|none||none| +|»»» release|string|true|none||none| +|»»» hostname|string|true|none||none| +|»»» homeDir|string|true|none||none| +|»»» cmd|string|true|none||none| +|»»» execCommand|string|true|none||none| +|»» disk|[object]|true|none|磁盘|none| +|»»» size|string|true|none||none| +|»»» used|string|true|none||none| +|»»» avail|string|true|none||none| +|»»» pcent|string|true|none||none| +|»»» target|string|true|none||none| + +## GET 资源监控信息加载 + +GET /monitor/load + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|type|query|string| yes ||数据类型all/cpu/memory/io/network| +|startTime|query|number| yes ||开始时间-时间戳毫秒| +|endTime|query|number| yes ||结束时间-时间戳毫秒| +|neType|query|string| no ||网元类型| +|neId|query|string| no ||网元ID| +|name|query|string| no ||名称，networ和iok时有效| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "project": { + "appDir": "E:\\Self\\Projects\\mask_api_midwayjs", + "env": "local", + "name": "mask_api_midwayjs", + "version": "0.0.5", + "dependencies": { + "@dropb/diskinfo": "^3.0.0", + "@midwayjs/bootstrap": "^3.0.0", + "@midwayjs/bull": "^3.0.0", + "@midwayjs/core": "^3.0.0", + "@midwayjs/decorator": "^3.0.0", + "@midwayjs/jwt": "^3.0.0", + "@midwayjs/koa": "^3.0.0", + "@midwayjs/cross-domain": "^3.0.0", + "@midwayjs/logger": "^2.0.0", + "@midwayjs/redis": "^3.0.0", + "@midwayjs/static-file": "^3.0.0", + "@midwayjs/typeorm": "^3.0.0", + "@midwayjs/upload": "^3.0.0", + "cron-parser": "^4.0.0", + "bcrypt": "^5.0.0", + "dayjs": "^1.0.0", + "mini-svg-data-uri": "^1.4.0", + "mysql2": "^2.0.0", + "nanoid": "^3.0.0", + "svg-captcha": "^1.4.0", + "typeorm": "^0.3.0", + "ua-parser-js": "^1.0.0", + "xlsx": "^0.18.0" + } + }, + "cpu": { + "model": "Intel(R) Core(TM) i5-9400 CPU @ 2.90GHz", + "speed": "2904MHz", + "core": 6, + "coreUsed": [ + "12.94", + "16.88", + "14.15", + "14.48", + "13.20", + "15.08" + ] + }, + "memory": { + "usage": "71.57", + "freemem": "4.51GB", + "totalmem": "15.88GB", + "rss": "309.80MB", + "heapTotal": "252.49MB", + "heapUsed": "246.27MB", + "external": "6.54MB" + }, + "network": { + "以太网 2": "IPv4 1.251.212.178", + "以太网": "IPv4 192.168.1.54 / IPv6 fe80::9906:92e5:b85e:3943", + "VirtualBox Host-Only Network": "IPv4 192.168.56.1 / IPv6 fe80::74da:97e8:b5e8:2c78", + "Loopback Pseudo-Interface 1": "IPv4 127.0.0.1 / IPv6 ::1" + }, + "time": { + "current": "2023-02-01 17:20:07", + "uptime": "8h", + "timezone": "GMT+0800", + "timezoneName": "中国标准时间" + }, + "system": { + "platform": "win32", + "node": "18.11.0", + "v8": "10.2.154.15-node.12", + "processId": 19988, + "arch": "x64", + "uname": "Windows_NT", + "release": "10.0.19045", + "hostname": "DESKTOP-QFRQUSF", + "homeDir": "C:\\Users\\LC1234", + "cmd": "E:\\Self\\Projects\\mask_api_midwayjs", + "execCommand": "D:\\Program Files\\nodejs\\node.exe E:\\Self\\Projects\\mask_api_midwayjs\\node_modules\\@midwayjs\\cli-plugin-dev\\dist\\child.js {\"baseDir\":\"E:\\\\Self\\\\Projects\\\\mask_api_midwayjs\\\\src\",\"_\":[\"dev\"],\"ts\":true,\"npm\":\"npm --registry=https://registry.npmmirror.com\",\"layers\":[],\"port\":\"6275\"} -r E:\\Self\\Projects\\mask_api_midwayjs\\node_modules\\ts-node\\register" + }, + "disk": [ + { + "size": "100.00GB", + "used": "91.22GB", + "avail": "8.78GB", + "pcent": "92%", + "target": "C:" + }, + { + "size": "174.00GB", + "used": "114.02GB", + "avail": "59.98GB", + "pcent": "66%", + "target": "D:" + }, + { + "size": "173.12GB", + "used": "138.62GB", + "avail": "34.50GB", + "pcent": "81%", + "target": "E:" + } + ] + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» project|object|true|none|项目|none| +|»»» appDir|string|true|none||none| +|»»» env|string|true|none||none| +|»»» name|string|true|none||none| +|»»» version|string|true|none||none| +|»»» dependencies|object|false|none||none| +|»»»» xlsx|string|true|none||none| +|»» cpu|object|true|none|CPU|none| +|»»» model|string|true|none||none| +|»»» speed|string|true|none||none| +|»»» core|integer|true|none||none| +|»»» coreUsed|[string]|true|none||none| +|»» memory|object|true|none|内存|none| +|»»» usage|string|true|none||none| +|»»» freemem|string|true|none||none| +|»»» totalmem|string|true|none||none| +|»»» rss|string|true|none||none| +|»»» heapTotal|string|true|none||none| +|»»» heapUsed|string|true|none||none| +|»»» external|string|true|none||none| +|»» network|object|false|none|网络|none| +|»»» 以太网 2|string|false|none||none| +|»»» 以太网|string|false|none||none| +|»»» VirtualBox Host-Only Network|string|false|none||none| +|»»» Loopback Pseudo-Interface 1|string|false|none||none| +|»» time|object|true|none|时间|none| +|»»» current|string|true|none||none| +|»»» uptime|string|true|none||none| +|»»» timezone|string|true|none||none| +|»»» timezoneName|string|true|none||none| +|»» system|object|true|none|系统|none| +|»»» platform|string|true|none||none| +|»»» node|string|true|none||none| +|»»» v8|string|true|none||none| +|»»» processId|integer|true|none||none| +|»»» arch|string|true|none||none| +|»»» uname|string|true|none||none| +|»»» release|string|true|none||none| +|»»» hostname|string|true|none||none| +|»»» homeDir|string|true|none||none| +|»»» cmd|string|true|none||none| +|»»» execCommand|string|true|none||none| +|»» disk|[object]|true|none|磁盘|none| +|»»» size|string|true|none||none| +|»»» used|string|true|none||none| +|»»» avail|string|true|none||none| +|»»» pcent|string|true|none||none| +|»»» target|string|true|none||none| + +# 中文src目录接口/网元功能模块/网元操作处理 + +## POST 发送文件从本地到网元 + +POST /ne/action/pushFile + +发送的文件存放 /tmp/omc/push 目录下 + + +> Body Parameters + +```json +{ + "uploadPath": "/upload/default/2024/07/5G核心网网管操作手册(2)_xeuo4s.pdf", + "neType": "UPF", + "neId": "001", + "delTemp": true +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» uploadPath|body|string| yes ||通过通用接口上传文件得到地址| +|» neType|body|string| yes ||网元类型| +|» neId|body|string| yes ||none| +|» delTemp|body|boolean| yes ||删除本地临时文件| + +> Response Examples + +```json +{ + "code": 1, + "data": "/tmp/omc/push/5G核心网网管操作手册(2)_xeuo4s.pdf", + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## PUT 网元服务操作 + +PUT /ne/action/service + +系统：reboot poweroff +网元：start restart stop + +> Body Parameters + +```json +{ + "neType": "string", + "neId": "string", + "action": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型| +|» neId|body|string| yes ||none| +|» action|body|string| yes ||start restart stop reboot poweroff| + +> Response Examples + +> 200 Response + +```json +{ + "code": 0, + "data": "string", + "msg": "string" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## GET 网元端文件列表 + +GET /ne/action/files + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型| +|neId|query|string| yes ||网元ID| +|path|query|string| yes ||文件目录路径| +|search|query|string| no ||过滤出前缀文件名| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "path": "/var/log", + "rows": [ + { + "fileType": "file", + "fileMode": "-rw-r--r--", + "linkCount": 1, + "owner": "root", + "group": "root", + "size": "363M", + "modifiedTime": 1702461459, + "fileName": "upfd1_1_2023_12_02_21_24_06.log" + }, + { + "fileType": "file", + "fileMode": "-rw-r--r--", + "linkCount": 1, + "owner": "root", + "group": "root", + "size": "153M", + "modifiedTime": 1702461457, + "fileName": "upf.log" + }, + { + "fileType": "file", + "fileMode": "-rw-r--r--", + "linkCount": 1, + "owner": "root", + "group": "root", + "size": "847K", + "modifiedTime": 1702440282, + "fileName": "upfd1_temp.log" + }, + { + "fileType": "file", + "fileMode": "-rw-r--r--", + "linkCount": 1, + "owner": "root", + "group": "root", + "size": "451M", + "modifiedTime": 1701552246, + "fileName": "upfd1_2_2023_12_01_05_47_45.log" + }, + { + "fileType": "file", + "fileMode": "-rw-r--r--", + "linkCount": 1, + "owner": "root", + "group": "root", + "size": "451M", + "modifiedTime": 1701409665, + "fileName": "upfd1_3_2023_11_17_10_13_16.log" + }, + { + "fileType": "file", + "fileMode": "-rw-r--r--", + "linkCount": 1, + "owner": "root", + "group": "root", + "size": "451M", + "modifiedTime": 1700215987, + "fileName": "upfd1_4_2023_10_22_11_08_10.log" + }, + { + "fileType": "file", + "fileMode": "-rw-r--r--", + "linkCount": 1, + "owner": "root", + "group": "root", + "size": "451M", + "modifiedTime": 1697972880, + "fileName": "upfd1_5_2023_10_20_06_28_24.log" + } + ], + "total": 7, + "totalSize": "" +} +``` + +```json +{ + "code": 1, + "msg": "success", + "path": "/var/log/ims", + "rows": [ + { + "fileType": "dir", + "fileMode": "drwxr-xr-x", + "linkCount": 2, + "owner": "syslog", + "group": "syslog", + "size": "4.0K", + "modifiedTime": 1702021652, + "fileName": "mmtel" + }, + { + "fileType": "dir", + "fileMode": "drwxr-xr-x", + "linkCount": 2, + "owner": "syslog", + "group": "syslog", + "size": "4.0K", + "modifiedTime": 1701749249, + "fileName": "scscf" + }, + { + "fileType": "dir", + "fileMode": "drwxr-xr-x", + "linkCount": 2, + "owner": "syslog", + "group": "syslog", + "size": "4.0K", + "modifiedTime": 1701749102, + "fileName": "icscf" + } + ], + "total": 3, + "totalSize": "12K" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» path|string|true|none||none| +|» rows|[object]|true|none||none| +|»» fileMode|string|true|none||none| +|»» linkCount|integer|true|none||none| +|»» owner|string|true|none||none| +|»» group|string|true|none||none| +|»» size|string|true|none||none| +|»» modifiedTime|integer|true|none||none| +|»» fileName|string|true|none||none| +|»» fileType|string|true|none||none| +|» total|integer|true|none||none| +|» totalSize|string|true|none||none| + +## GET 获取文件从网元到本地 + +GET /ne/action/pullFile + +获取的文件临时放在 /tmp/omc/pull 目录下 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型| +|neId|query|string| yes ||网元ID| +|path|query|string| yes ||文件目录路径| +|fileName|query|string| yes ||文件名| +|delTemp|query|boolean| no ||删除本地临时文件| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» rows|[object]|true|none||none| +|»»» fileMode|string|true|none||none| +|»»» linkCount|integer|true|none||none| +|»»» owner|string|true|none||none| +|»»» group|string|true|none||none| +|»»» size|string|true|none||none| +|»»» modifiedTime|integer|true|none||none| +|»»» fileName|string|true|none||none| +|»» total|string|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/网元功能模块/网元信息 + +## GET 网元neType和neID查询 + +GET /ne/info/byTypeAndID + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||none| +|neId|query|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## GET 网元端Para5G配置文件读取 + +GET /ne/info/para5GFile + +配置文件路径: /usr/local/etc/omc/para5G.yaml + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|fileType|query|string| no ||'' txt json yaml yml 根据指定文件类型进行解析序列出map->json| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "basic": { + "dnn_data": "internet", + "dnn_ims": "ims", + "oamEnable": true, + "plmnId": { + "mcc": 1, + "mnc": 1 + }, + "snmpEnable": false, + "snssai": { + "sd": 1, + "sst": 1 + }, + "tac": 4388 + }, + "external": { + "amfn2_ip": "192.168.8.120", + "ue_pool": "10.2.1.0/24", + "upfn3_gw": "192.168.1.1", + "upfn3_ip": "192.168.8.190/24", + "upfn6_gw": "192.168.1.1", + "upfn6_ip": "192.168.8.191/24" + } + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## PUT 网元端Para5G配置文件写入 + +PUT /ne/info/para5GFile + +网元固定路径：/usr/local/etc/conf/para5G.yaml + +> Body Parameters + +```json +{ + "fileType": "yaml", + "content": { + "SIPIP": "192.168.5.90", + "N2IP": "192.168.5.90", + "S1_MMEIP": "192.168.5.90", + "OMCIP": "172.60.5.100", + "AMFIP": "172.60.5.120", + "AUSFIP": "172.60.5.130", + "UDMIP": "172.60.5.140", + "SMFIP": "172.60.5.150", + "PCFIP": "172.60.5.160", + "UPFIP": "172.60.5.190", + "ADBIP": "172.60.5.140", + "IMSIP": "172.60.5.110", + "S11_MMEIP": "172.60.5.220", + "S10_MMEIP": "172.60.5.221", + "LTETAC": "88", + "MCC": "460", + "MNC": "00", + "SST": "1", + "SD": "010204", + "DNN": "cmnet", + "NRTAC": "88", + "UEIP": "10.10.40.0", + "UEIPMask": "255.255.255.0", + "N3IP": "192.168.5.191", + "N3Mask": "255.255.240.0", + "N3GW": "192.168.1.1", + "N3PCI": "0000:13:00.0", + "N3MAC": "00:0c:29:10:ac:d7", + "N6IP": "192.168.5.191", + "N6Mask": "255.255.240.0", + "N6GW": "192.168.1.1", + "N6MAC": "00:0c:29:10:ac:e1", + "N6PCI": "0000:1b:00.0" + }, + "syncNe": [] +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» fileType|body|string| yes ||'' txt json yaml yml 解析内容数据到对应文件类型| +|» content|body|string| yes ||none| +|» syncNe|body|[string]| no | 同步到网元|同步到网元端 NeType@NeId| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## GET 网元端OAM配置文件读取 + +GET /ne/info/oamFile + +配置文件路径: /usr/local/etc/omc/ne_config/{neType}/{neId}/oam_manager.yaml + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型| +|neId|query|string| yes ||网元ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## PUT 网元端OAM配置文件写入 + +PUT /ne/info/oamFile + +网元固定路径：/usr/local/etc/{neType}/oam_manager.yaml + +> Body Parameters + +```json +{ + "neType": "UDM", + "neId": "001", + "content": { + "oamEnable": true, + "oamPort": 33030, + "snmpEnable": true, + "snmpPort": 4957, + "kpiEnable": false, + "kpiTimer": 20 + }, + "sync": false +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型| +|» neId|body|string| yes | 内容|网元ID| +|» content|body|object| no | 内容|用json对象| +|» sync|body|boolean| no | 同步到网元|同步到网元端| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## GET 网元信息 + +GET /ne/info/{infoId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|infoId|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "id": "1", + "neType": "OMC", + "neId": "001", + "rmUid": "4400HX101", + "neName": "OMC_001", + "ip": "172.16.5.100", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "-", + "dn": "-", + "neAddress": "-", + "status": "1", + "updateTime": "2024-03-06 11:09:22 +0800 CST", + "hostIds": "1,2", + "hosts": [ + { + "hostId": "1", + "hostType": "ssh", + "groupId": "0", + "title": "OMC_001_22", + "addr": "172.16.5.100", + "port": 22, + "user": "agtuser", + "authMode": "0", + "password": "admin123", + "privateKey": "", + "passPhrase": "", + "remark": "", + "createBy": "admin", + "createTime": 1708333292882, + "updateBy": "", + "updateTime": 0 + }, + { + "hostId": "2", + "hostType": "telnet", + "groupId": "0", + "title": "OMC_001_4100", + "addr": "172.16.5.100", + "port": 4100, + "user": "admin", + "authMode": "0", + "password": "admin", + "privateKey": "", + "passPhrase": "", + "remark": "", + "createBy": "admin", + "createTime": 1708333292882, + "updateBy": "", + "updateTime": 0 + } + ] + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» neId|string|true|none||none| +|»» rmUid|string|true|none||none| +|»» neName|string|true|none||none| +|»» ip|string|true|none||none| +|»» port|integer|true|none||none| +|»» pvFlag|string|true|none||none| +|»» province|string|true|none||none| +|»» vendorName|string|true|none||none| +|»» dn|string|true|none||none| +|»» neAddress|string|true|none||none| +|»» status|string|true|none||none| +|»» updateTime|string|true|none||none| +|»» hostIds|string|true|none||none| +|»» hosts|[object]|true|none||none| +|»»» hostId|string|true|none||none| +|»»» hostType|string|true|none||none| +|»»» groupId|string|true|none||none| +|»»» title|string|true|none||none| +|»»» addr|string|true|none||none| +|»»» port|integer|true|none||none| +|»»» user|string|true|none||none| +|»»» authMode|string|true|none||none| +|»»» password|string|true|none||none| +|»»» privateKey|string|true|none||none| +|»»» passPhrase|string|true|none||none| +|»»» remark|string|true|none||none| +|»»» createBy|string|true|none||none| +|»»» createTime|integer|true|none||none| +|»»» updateBy|string|true|none||none| +|»»» updateTime|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 网元状态 + +GET /ne/info/state + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||none| +|neId|query|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 129, + "sysCpuUsage": 3669 + }, + "expire": "2024-03-31", + "mem": { + "nfUsedMem": 20736, + "sysMemUsage": 6988, + "totalMem": 4000916 + }, + "sn": "13770707", + "version": "2.2311.9" + }, + "msg": "success" +} +``` + +```json +{ + "code": 1, + "data": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 21, + "sysCpuUsage": 9610 + }, + "expire": "2024-05-31", + "mem": { + "nfUsedMem": 52364, + "sysMemUsage": 7037, + "totalMem": 4005920 + }, + "neId": "001", + "neName": "SMF_001", + "neType": "SMF", + "refreshTime": 1704424061043, + "sn": "13770712", + "version": "2.2312.10" + }, + "msg": "success" +} +``` + +```json +{ + "code": 1, + "data": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 156, + "sysCpuUsage": 9993 + }, + "expire": "2024-05-31", + "mem": { + "nfUsedMem": 52364, + "sysMemUsage": 7013, + "totalMem": 4005920 + }, + "neId": "001", + "neName": "SMF_001", + "neType": "SMF", + "online": true, + "refreshTime": 1704424268764, + "sn": "13770712", + "version": "2.2312.10" + }, + "msg": "success" +} +``` + +```json +{ + "code": 1, + "data": { + "neId": "001", + "neName": "OMC_001", + "neType": "OMC", + "online": false + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» capability|integer|true|none||none| +|»» cpu|object|true|none||none| +|»»» nfCpuUsage|integer|true|none||none| +|»»» sysCpuUsage|integer|true|none||none| +|»» expire|string|true|none||none| +|»» mem|object|true|none||none| +|»»» nfUsedMem|integer|true|none||none| +|»»» sysMemUsage|integer|true|none||none| +|»»» totalMem|integer|true|none||none| +|»» sn|string|true|none||none| +|»» version|string|true|none||none| +|» msg|string|true|none||none| + +## GET 网元列表 + +GET /ne/info/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| no ||none| +|neId|query|string| no ||none| +|bandStatus|query|boolean| no ||可转布尔类型的值，默认false| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "2", + "neType": "IMS", + "neId": "001", + "rmUid": "4400HXIMS001", + "neName": "IMS_001", + "ip": "192.168.8.58", + "port": 29501, + "pvFlag": "PNF", + "province": "-", + "vendorName": "-", + "dn": "-", + "neAddress": "-", + "hostIds": "3,4", + "status": "1", + "remark": "", + "createBy": "", + "createTime": 0, + "updateBy": "supervisor", + "updateTime": 1722829289961 + }, + { + "id": "3", + "neType": "AMF", + "neId": "001", + "rmUid": "4400HXAMF001", + "neName": "AMF_001", + "ip": "192.168.8.58", + "port": 29502, + "pvFlag": "PNF", + "province": "-", + "vendorName": "-", + "dn": "-", + "neAddress": "", + "hostIds": "5,6", + "status": "1", + "remark": "", + "createBy": "", + "createTime": 0, + "updateBy": "supervisor", + "updateTime": 1723631621152 + }, + { + "id": "4", + "neType": "AUSF", + "neId": "001", + "rmUid": "4400HXAUSF001", + "neName": "AUSF_001", + "ip": "192.168.8.58", + "port": 29503, + "pvFlag": "PNF", + "province": "-", + "vendorName": "-", + "dn": "-", + "neAddress": "", + "hostIds": "7,8", + "status": "1", + "remark": "", + "createBy": "", + "createTime": 0, + "updateBy": "supervisor", + "updateTime": 1722845304851 + } + ], + "total": 13 +} +``` + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "2", + "neType": "IMS", + "neId": "001", + "rmUid": "4400HXIMS001", + "neName": "IMS_001", + "ip": "192.168.8.58", + "port": 29501, + "pvFlag": "PNF", + "province": "-", + "vendorName": "-", + "dn": "-", + "neAddress": "-", + "hostIds": "3,4", + "status": "1", + "remark": "", + "createBy": "", + "createTime": 0, + "updateBy": "supervisor", + "updateTime": 1722829289961, + "serverState": { + "capability": 100000, + "cpu": { + "nfCpuUsage": 15, + "sysCpuUsage": 806 + }, + "disk": { + "partitionInfo": [ + { + "total": 7928, + "used": 0 + }, + { + "total": 1598, + "used": 1 + }, + { + "total": 40010, + "used": 11625 + }, + { + "total": 7992, + "used": 0 + }, + { + "total": 5, + "used": 0 + }, + { + "total": 1598, + "used": 0 + } + ], + "partitionNum": 6 + }, + "expire": "2026-06-30", + "mem": { + "nfUsedMem": 26880, + "sysMemUsage": 2828, + "totalMem": 16368300 + }, + "neIP": "192.168.8.58", + "neId": "001", + "neName": "IMS_001", + "neType": "IMS", + "online": true, + "refreshTime": 1723706285118, + "sn": "13750620", + "version": "2.2407.5" + } + }, + { + "id": "3", + "neType": "AMF", + "neId": "001", + "rmUid": "4400HXAMF001", + "neName": "AMF_001", + "ip": "192.168.8.58", + "port": 29502, + "pvFlag": "PNF", + "province": "-", + "vendorName": "-", + "dn": "-", + "neAddress": "", + "hostIds": "5,6", + "status": "1", + "remark": "", + "createBy": "", + "createTime": 0, + "updateBy": "supervisor", + "updateTime": 1723631621152, + "serverState": { + "capability": 100000, + "cpu": { + "nfCpuUsage": 4, + "sysCpuUsage": 163 + }, + "disk": { + "partitionInfo": [ + { + "total": 7928, + "used": 0 + }, + { + "total": 1598, + "used": 1 + }, + { + "total": 40010, + "used": 11625 + }, + { + "total": 7992, + "used": 0 + }, + { + "total": 5, + "used": 0 + }, + { + "total": 1598, + "used": 0 + } + ], + "partitionNum": 6 + }, + "expire": "2026-06-30", + "mem": { + "nfUsedMem": 24640, + "sysMemUsage": 2828, + "totalMem": 16368300 + }, + "neIP": "192.168.8.58", + "neId": "001", + "neName": "AMF_001", + "neType": "AMF", + "online": true, + "refreshTime": 1723706285119, + "sn": "13750620", + "version": "2.2407.19" + } + }, + { + "id": "4", + "neType": "AUSF", + "neId": "001", + "rmUid": "4400HXAUSF001", + "neName": "AUSF_001", + "ip": "192.168.8.58", + "port": 29503, + "pvFlag": "PNF", + "province": "-", + "vendorName": "-", + "dn": "-", + "neAddress": "", + "hostIds": "7,8", + "status": "1", + "remark": "", + "createBy": "", + "createTime": 0, + "updateBy": "supervisor", + "updateTime": 1722845304851, + "serverState": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 1, + "sysCpuUsage": 163 + }, + "disk": { + "partitionInfo": [ + { + "total": 7928, + "used": 0 + }, + { + "total": 1598, + "used": 1 + }, + { + "total": 40010, + "used": 11625 + }, + { + "total": 7992, + "used": 0 + }, + { + "total": 5, + "used": 0 + }, + { + "total": 1598, + "used": 0 + } + ], + "partitionNum": 6 + }, + "expire": "2026-06-30", + "mem": { + "nfUsedMem": 27624, + "sysMemUsage": 2828, + "totalMem": 16368300 + }, + "neIP": "192.168.8.58", + "neId": "001", + "neName": "AUSF_001", + "neType": "AUSF", + "online": true, + "refreshTime": 1723706285121, + "sn": "13750620", + "version": "2.2405.16" + } + } + ], + "total": 13 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|false|none||none| +|»» neType|string|false|none||none| +|»» neId|string|false|none||none| +|»» rmUid|string|false|none||none| +|»» neName|string|false|none||none| +|»» ip|string|false|none||none| +|»» port|integer|false|none||none| +|»» pvFlag|string|false|none||none| +|»» province|string|false|none||none| +|»» vendorName|string|false|none||none| +|»» dn|string|false|none||none| +|»» neAddress|string|false|none||none| +|»» hostIds|string|false|none||none| +|»» status|string|false|none||none| +|»» remark|string|false|none||none| +|»» createBy|string|false|none||none| +|»» createTime|integer|false|none||none| +|»» updateBy|string|false|none||none| +|»» updateTime|integer|false|none||none| +|» total|integer|true|none||none| + +## GET 网元列表全部无分页 + +GET /ne/info/listAll + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| no ||网元类型| +|neId|query|string| no ||网元ID| +|bandStatus|query|boolean| no ||带状态信息| +|bandHost|query|boolean| no ||带主机信息| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": [ + { + "id": 1, + "neType": "OMC", + "neId": "001", + "rmUid": "4400HX101", + "neName": "OMC_001", + "ip": "172.16.16.50", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:47:43 +0800 CST" + }, + { + "id": 13, + "neType": "MME", + "neId": "001", + "rmUid": "4400HX1MME001", + "neName": "MME_001", + "ip": "172.16.5.220", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST" + }, + { + "id": 3, + "neType": "AMF", + "neId": "001", + "rmUid": "4400HX1AMF001", + "neName": "AMF_001", + "ip": "172.16.16.52", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST", + "serverState": { + "capability": 100000, + "cpu": { + "nfCpuUsage": 6, + "sysCpuUsage": 624 + }, + "expire": "2024-03-31", + "mem": { + "nfUsedMem": 11508, + "sysMemUsage": 6675, + "totalMem": 4000912 + }, + "sn": "13770707", + "version": "2.2312.8" + } + }, + { + "id": 4, + "neType": "AUSF", + "neId": "001", + "rmUid": "4400HX1AUF001", + "neName": "AUSF_001", + "ip": "172.16.16.53", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST", + "serverState": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 5, + "sysCpuUsage": 624 + }, + "expire": "2024-03-31", + "mem": { + "nfUsedMem": 17116, + "sysMemUsage": 6675, + "totalMem": 4000912 + }, + "sn": "13770707", + "version": "2.2311.7" + } + }, + { + "id": 5, + "neType": "UDM", + "neId": "001", + "rmUid": "4400HX1UDM001", + "neName": "UDM_001", + "ip": "172.16.16.54", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST", + "serverState": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 80, + "sysCpuUsage": 671 + }, + "expire": "2024-03-31", + "mem": { + "nfUsedMem": 13456, + "sysMemUsage": 6675, + "totalMem": 4000912 + }, + "sn": "13770707", + "version": "2.2312.8" + } + }, + { + "id": 6, + "neType": "SMF", + "neId": "001", + "rmUid": "4400HX1SMF001", + "neName": "SMF_001", + "ip": "172.16.16.55", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "GD", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-15 10:53:41 +0800 CST", + "serverState": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 20, + "sysCpuUsage": 624 + }, + "expire": "2024-03-31", + "mem": { + "nfUsedMem": 30592, + "sysMemUsage": 6675, + "totalMem": 4000912 + }, + "sn": "13770707", + "version": "2.2311.9" + } + }, + { + "id": 201, + "neType": "SMF", + "neId": "002", + "rmUid": "SMF002", + "neName": "SMF002", + "ip": "172.16.16.55", + "port": 3030, + "pvFlag": "PNF", + "province": "", + "vendorName": "", + "dn": "", + "neAddress": "", + "status": "0", + "updateTime": "2023-12-15 10:53:30 +0800 CST", + "serverState": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 49587, + "sysCpuUsage": 0 + }, + "expire": "2024-03-31", + "mem": { + "nfUsedMem": 30848, + "sysMemUsage": 6675, + "totalMem": 4000912 + }, + "sn": "13770707", + "version": "2.2311.9" + } + }, + { + "id": 7, + "neType": "PCF", + "neId": "001", + "rmUid": "4400HX1PCF001", + "neName": "PCF_001", + "ip": "172.16.16.56", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-18 15:06:28 +0800 CST", + "serverState": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 220, + "sysCpuUsage": 624 + }, + "expire": "2024-03-31", + "mem": { + "nfUsedMem": 14684, + "sysMemUsage": 6675, + "totalMem": 4000912 + }, + "sn": "13770707", + "version": "2.2312.8" + } + }, + { + "id": 10, + "neType": "UPF", + "neId": "001", + "rmUid": "4400HX1UPF001", + "neName": "UPF_001", + "ip": "172.16.16.59", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST" + }, + { + "id": 9, + "neType": "NRF", + "neId": "001", + "rmUid": "4400HX1NRF001", + "neName": "NRF_001", + "ip": "172.16.16.58", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST" + }, + { + "id": 8, + "neType": "NSSF", + "neId": "001", + "rmUid": "4400HX1NSF001", + "neName": "NSSF_001", + "ip": "172.16.16.57", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST" + }, + { + "id": 2, + "neType": "IMS", + "neId": "001", + "rmUid": "4400HX1IMS001", + "neName": "IMS_001", + "ip": "172.16.16.51", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST", + "serverState": { + "capability": 100000, + "cpu": { + "nfCpuUsage": 2, + "sysCpuUsage": 626 + }, + "expire": "2024-03-31", + "mem": { + "nfUsedMem": 9600, + "sysMemUsage": 6659, + "totalMem": 4000912 + }, + "sn": "13770707", + "version": "2.2312.8" + } + }, + { + "id": 14, + "neType": "N3IWF", + "neId": "001", + "rmUid": "4400HX1IWF001", + "neName": "N3IWF_001", + "ip": "172.16.5.230", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST" + }, + { + "id": 12, + "neType": "NEF", + "neId": "001", + "rmUid": "4400HX1NEF001", + "neName": "NEF_001", + "ip": "172.16.5.210", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST" + }, + { + "id": 11, + "neType": "LMF", + "neId": "001", + "rmUid": "4400HX1LMF001", + "neName": "LMF_001", + "ip": "172.16.5.200", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-14 20:12:45 +0800 CST" + } + ], + "msg": "success" +} +``` + +```json +{ + "code": 1, + "data": [ + { + "id": 1, + "neType": "OMC", + "neId": "001", + "rmUid": "4400HX101", + "neName": "OMC_001", + "ip": "192.168.2.166", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2024-02-18 09:54:11 +0800 CST", + "serverState": { + "capability": 9999999, + "cpu": { + "nfCpuUsage": 12908, + "sysCpuUsage": 3330 + }, + "disk": { + "partitionInfo": [ + { + "total": 3911, + "used": 0 + }, + { + "total": 793, + "used": 3 + }, + { + "total": 23486, + "used": 17117 + }, + { + "total": 3968, + "used": 0 + }, + { + "total": 5, + "used": 0 + }, + { + "total": 30064, + "used": 16741 + }, + { + "total": 1945, + "used": 252 + }, + { + "total": 19985, + "used": 12031 + }, + { + "total": 1072, + "used": 6 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 70, + "used": 70 + }, + { + "total": 30064, + "used": 9793 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 74, + "used": 74 + }, + { + "total": 60, + "used": 60 + }, + { + "total": 74, + "used": 74 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 70, + "used": 70 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 793, + "used": 3 + }, + { + "total": 62, + "used": 62 + }, + { + "total": 19985, + "used": 12031 + }, + { + "total": 19985, + "used": 12031 + }, + { + "total": 19985, + "used": 12031 + }, + { + "total": 19985, + "used": 12031 + }, + { + "total": 793, + "used": 0 + } + ], + "partitionNum": 28 + }, + "expire": "-", + "mem": { + "nfUsedMem": 107860, + "sysMemUsage": 1420, + "totalMem": 8127428 + }, + "neIP": "192.168.2.166", + "neId": "001", + "neName": "OMC_001", + "neType": "OMC", + "online": true, + "refreshTime": 1709179386245, + "sn": "-", + "version": "2.2402.6" + } + }, + { + "id": 15, + "neType": "OMC", + "neId": "002", + "rmUid": "4400HX102", + "neName": "OMC_002", + "ip": "192.168.5.58", + "port": 3040, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "capability": 9999999, + "cpu": { + "nfCpuUsage": 0, + "sysCpuUsage": 307 + }, + "disk": { + "partitionInfo": [ + { + "total": 485436, + "used": 424807 + } + ], + "partitionNum": 1 + }, + "expire": "-", + "mem": { + "nfUsedMem": 111908, + "sysMemUsage": 6200, + "totalMem": 33231568 + }, + "neIP": "192.168.5.58", + "neId": "002", + "neName": "OMC_002", + "neType": "OMC", + "online": true, + "refreshTime": 1709179386419, + "sn": "-", + "version": "-" + } + }, + { + "id": 13, + "neType": "MME", + "neId": "001", + "rmUid": "4400HX1MME001", + "neName": "MME_001", + "ip": "192.168.13.220", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "online": false + } + }, + { + "id": 3, + "neType": "AMF", + "neId": "001", + "rmUid": "4400HX1AMF001", + "neName": "AMF_001", + "ip": "192.168.13.120", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2024-02-05 11:26:36 +0800 CST", + "serverState": { + "capability": 100000, + "cpu": { + "nfCpuUsage": 0, + "sysCpuUsage": 5450 + }, + "disk": { + "partitionInfo": [ + { + "total": 1898, + "used": 0 + }, + { + "total": 391, + "used": 1 + }, + { + "total": 29053, + "used": 16975 + }, + { + "total": 1956, + "used": 0 + }, + { + "total": 5, + "used": 0 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 1945, + "used": 254 + }, + { + "total": 391, + "used": 1 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 391, + "used": 0 + } + ], + "partitionNum": 14 + }, + "expire": "2024-05-31", + "mem": { + "nfUsedMem": 16908, + "sysMemUsage": 6976, + "totalMem": 4005920 + }, + "neIP": "192.168.13.120", + "neId": "001", + "neName": "AMF_001", + "neType": "AMF", + "online": true, + "refreshTime": 1709179386621, + "sn": "13770712", + "version": "2.2401.12" + } + }, + { + "id": 4, + "neType": "AUSF", + "neId": "001", + "rmUid": "4400HX1AUF001", + "neName": "AUSF_001", + "ip": "192.168.13.130", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 0, + "sysCpuUsage": 5450 + }, + "disk": { + "partitionInfo": [ + { + "total": 1898, + "used": 0 + }, + { + "total": 391, + "used": 1 + }, + { + "total": 29053, + "used": 16975 + }, + { + "total": 1956, + "used": 0 + }, + { + "total": 5, + "used": 0 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 1945, + "used": 254 + }, + { + "total": 391, + "used": 1 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 391, + "used": 0 + } + ], + "partitionNum": 14 + }, + "expire": "2024-05-31", + "mem": { + "nfUsedMem": 18376, + "sysMemUsage": 6976, + "totalMem": 4005920 + }, + "neIP": "192.168.13.130", + "neId": "001", + "neName": "AUSF_001", + "neType": "AUSF", + "online": true, + "refreshTime": 1709179386624, + "sn": "13770712", + "version": "2.2312.8" + } + }, + { + "id": 5, + "neType": "UDM", + "neId": "001", + "rmUid": "4400HX1UDM001", + "neName": "UDM_001", + "ip": "192.168.13.140", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 54, + "sysCpuUsage": 5445 + }, + "disk": { + "partitionInfo": [ + { + "total": 1898, + "used": 0 + }, + { + "total": 391, + "used": 1 + }, + { + "total": 29053, + "used": 16975 + }, + { + "total": 1956, + "used": 0 + }, + { + "total": 5, + "used": 0 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 1945, + "used": 254 + }, + { + "total": 391, + "used": 1 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 391, + "used": 0 + } + ], + "partitionNum": 14 + }, + "expire": "2024-05-31", + "mem": { + "nfUsedMem": 18440, + "sysMemUsage": 6976, + "totalMem": 4005920 + }, + "neIP": "192.168.13.140", + "neId": "001", + "neName": "UDM_001", + "neType": "UDM", + "online": true, + "refreshTime": 1709179386625, + "sn": "13770712", + "version": "2.2401.13" + } + }, + { + "id": 6, + "neType": "SMF", + "neId": "001", + "rmUid": "4400HX1SMF001", + "neName": "SMF_001", + "ip": "192.168.13.150", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "capability": 50000, + "cpu": { + "nfCpuUsage": 0, + "sysCpuUsage": 5452 + }, + "disk": { + "partitionInfo": [ + { + "total": 1898, + "used": 0 + }, + { + "total": 391, + "used": 1 + }, + { + "total": 29053, + "used": 16975 + }, + { + "total": 1956, + "used": 0 + }, + { + "total": 5, + "used": 0 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 1945, + "used": 254 + }, + { + "total": 391, + "used": 1 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 391, + "used": 0 + } + ], + "partitionNum": 14 + }, + "expire": "2024-05-31", + "mem": { + "nfUsedMem": 44972, + "sysMemUsage": 6976, + "totalMem": 4005920 + }, + "neIP": "192.168.13.150", + "neId": "001", + "neName": "SMF_001", + "neType": "SMF", + "online": true, + "refreshTime": 1709179386627, + "sn": "13770712", + "version": "2.2401.13" + } + }, + { + "id": 7, + "neType": "PCF", + "neId": "001", + "rmUid": "4400HX1PCF001", + "neName": "PCF_001", + "ip": "192.168.13.160", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "online": false + } + }, + { + "id": 10, + "neType": "UPF", + "neId": "001", + "rmUid": "4400HX1UPF001", + "neName": "UPF_001", + "ip": "192.168.13.190", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "online": false + } + }, + { + "id": 9, + "neType": "NRF", + "neId": "001", + "rmUid": "4400HX1NRF001", + "neName": "NRF_001", + "ip": "192.168.13.180", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "online": false + } + }, + { + "id": 8, + "neType": "NSSF", + "neId": "001", + "rmUid": "4400HX1NSF001", + "neName": "NSSF_001", + "ip": "192.168.13.170", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "online": false + } + }, + { + "id": 2, + "neType": "IMS", + "neId": "001", + "rmUid": "4400HX1IMS001", + "neName": "IMS_001", + "ip": "192.168.13.110", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "capability": 100000, + "cpu": { + "nfCpuUsage": 22, + "sysCpuUsage": 5484 + }, + "disk": { + "partitionInfo": [ + { + "total": 1898, + "used": 0 + }, + { + "total": 391, + "used": 1 + }, + { + "total": 29053, + "used": 16975 + }, + { + "total": 1956, + "used": 0 + }, + { + "total": 5, + "used": 0 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 40, + "used": 40 + }, + { + "total": 1945, + "used": 254 + }, + { + "total": 391, + "used": 1 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 87, + "used": 87 + }, + { + "total": 64, + "used": 64 + }, + { + "total": 391, + "used": 0 + } + ], + "partitionNum": 14 + }, + "expire": "2024-05-31", + "mem": { + "nfUsedMem": 16536, + "sysMemUsage": 6976, + "totalMem": 4005920 + }, + "neIP": "192.168.13.110", + "neId": "001", + "neName": "IMS_001", + "neType": "IMS", + "online": true, + "refreshTime": 1709179387431, + "sn": "13770712", + "version": "2.2402.4" + } + }, + { + "id": 14, + "neType": "N3IWF", + "neId": "001", + "rmUid": "4400HX1IWF001", + "neName": "N3IWF_001", + "ip": "192.168.13.230", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "online": false + } + }, + { + "id": 12, + "neType": "NEF", + "neId": "001", + "rmUid": "4400HX1NEF001", + "neName": "NEF_001", + "ip": "192.168.13.210", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "online": false + } + }, + { + "id": 11, + "neType": "LMF", + "neId": "001", + "rmUid": "4400HX1LMF001", + "neName": "LMF_001", + "ip": "192.168.13.200", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "AGrandTech", + "dn": "-", + "neAddress": "-", + "status": "0", + "updateTime": "2023-12-29 21:04:24 +0800 CST", + "serverState": { + "online": false + } + } + ], + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|[object]|true|none||none| +|»» id|integer|true|none||none| +|»» neType|string|true|none|网元类型|none| +|»» neId|string|true|none||none| +|»» rmUid|string|true|none||none| +|»» neName|string|true|none||none| +|»» ip|string|true|none|网元IP|none| +|»» port|integer|true|none||none| +|»» pvFlag|string|true|none||none| +|»» province|string|true|none||none| +|»» vendorName|string|true|none||none| +|»» dn|string|true|none||none| +|»» neAddress|string|true|none||none| +|»» status|string|true|none||none| +|»» updateTime|string|true|none||none| +|»» serverState|object|true|none|服务状态|none| +|»»» capability|integer|true|none||none| +|»»» cpu|object|true|none||none| +|»»»» nfCpuUsage|integer|true|none||none| +|»»»» sysCpuUsage|integer|true|none||none| +|»»» expire|string|true|none||none| +|»»» mem|object|true|none||none| +|»»»» nfUsedMem|integer|true|none||none| +|»»»» sysMemUsage|integer|true|none||none| +|»»»» totalMem|integer|true|none||none| +|»»» sn|string|true|none||none| +|»»» version|string|true|none||none| +|» msg|string|true|none||none| + +## POST 网元信息新增 + +POST /ne/info + +> Body Parameters + +```json +{ + "neType": "OMC", + "neId": "001", + "rmUid": "4400HX101", + "neName": "OMC_001", + "ip": "172.16.5.100", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "-", + "dn": "-", + "neAddress": "-", + "status": "1", + "hosts": [ + { + "hostType": "ssh", + "groupId": "1", + "title": "OMC_001_22", + "addr": "172.16.5.100", + "port": 22, + "user": "agtuser", + "authMode": "0", + "password": "admin123", + "privateKey": "", + "passPhrase": "", + "remark": "" + }, + { + "hostType": "telnet", + "groupId": "1", + "title": "OMC_001_4100", + "addr": "172.16.5.100", + "port": 4100, + "user": "admin", + "authMode": "0", + "password": "admin", + "privateKey": "", + "passPhrase": "", + "remark": "" + } + ] +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||none| +|» neId|body|string| yes ||none| +|» rmUid|body|string| yes ||none| +|» neName|body|string| yes ||none| +|» ip|body|string| yes ||none| +|» port|body|integer| yes ||none| +|» pvFlag|body|string| yes ||none| +|» province|body|string| yes ||none| +|» vendorName|body|string| yes ||none| +|» dn|body|string| yes ||none| +|» neAddress|body|string| yes ||none| +|» status|body|string| yes ||none| +|» hosts|body|[object]| yes ||none| +|»» hostType|body|string| yes ||none| +|»» groupId|body|string| yes ||none| +|»» title|body|string| yes ||none| +|»» addr|body|string| yes ||none| +|»» port|body|integer| yes ||none| +|»» user|body|string| yes ||none| +|»» authMode|body|string| yes ||none| +|»» password|body|string| yes ||none| +|»» privateKey|body|string| yes ||none| +|»» passPhrase|body|string| yes ||none| +|»» remark|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|[object]|true|none||none| +|»» id|integer|true|none||none| +|»» neType|string|true|none|网元类型|none| +|»» neId|string|true|none||none| +|»» rmUid|string|true|none||none| +|»» neName|string|true|none||none| +|»» ip|string|true|none|网元IP|none| +|»» port|integer|true|none||none| +|»» pvFlag|string|true|none||none| +|»» province|string|true|none||none| +|»» vendorName|string|true|none||none| +|»» dn|string|true|none||none| +|»» neAddress|string|true|none||none| +|»» status|string|true|none||none| +|»» updateTime|string|true|none||none| +|»» serverState|object|true|none|服务状态|none| +|»»» capability|integer|true|none||none| +|»»» cpu|object|true|none||none| +|»»»» nfCpuUsage|integer|true|none||none| +|»»»» sysCpuUsage|integer|true|none||none| +|»»» expire|string|true|none||none| +|»»» mem|object|true|none||none| +|»»»» nfUsedMem|integer|true|none||none| +|»»»» sysMemUsage|integer|true|none||none| +|»»»» totalMem|integer|true|none||none| +|»»» sn|string|true|none||none| +|»»» version|string|true|none||none| +|» msg|string|true|none||none| + +## PUT 网元信息修改 + +PUT /ne/info + +> Body Parameters + +```json +{ + "id": "1", + "neType": "OMC", + "neId": "001", + "rmUid": "4400HX101", + "neName": "OMC_001", + "ip": "172.16.5.100", + "port": 3030, + "pvFlag": "PNF", + "province": "-", + "vendorName": "-", + "dn": "-", + "neAddress": "-", + "status": "1", + "hosts": [ + { + "hostId": "1", + "hostType": "ssh", + "groupId": "1", + "title": "OMC_001_22", + "addr": "172.16.5.100", + "port": 22, + "user": "agtuser", + "authMode": "0", + "password": "admin123", + "privateKey": "", + "passPhrase": "", + "remark": "" + }, + { + "hostId": "2", + "hostType": "telnet", + "groupId": "1", + "title": "OMC_001_4100", + "addr": "172.16.5.100", + "port": 4100, + "user": "admin", + "authMode": "0", + "password": "admin", + "privateKey": "", + "passPhrase": "", + "remark": "" + } + ] +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» id|body|string| yes ||none| +|» neType|body|string| yes ||none| +|» neId|body|string| yes ||none| +|» rmUid|body|string| yes ||none| +|» neName|body|string| yes ||none| +|» ip|body|string| yes ||none| +|» port|body|integer| yes ||none| +|» pvFlag|body|string| yes ||none| +|» province|body|string| yes ||none| +|» vendorName|body|string| yes ||none| +|» dn|body|string| yes ||none| +|» neAddress|body|string| yes ||none| +|» status|body|string| yes ||none| +|» hosts|body|[object]| yes ||none| +|»» hostId|body|string| yes ||none| +|»» hostType|body|string| yes ||none| +|»» groupId|body|string| yes ||none| +|»» title|body|string| yes ||none| +|»» addr|body|string| yes ||none| +|»» port|body|integer| yes ||none| +|»» user|body|string| yes ||none| +|»» authMode|body|string| yes ||none| +|»» password|body|string| yes ||none| +|»» privateKey|body|string| yes ||none| +|»» passPhrase|body|string| yes ||none| +|»» remark|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|[object]|true|none||none| +|»» id|integer|true|none||none| +|»» neType|string|true|none|网元类型|none| +|»» neId|string|true|none||none| +|»» rmUid|string|true|none||none| +|»» neName|string|true|none||none| +|»» ip|string|true|none|网元IP|none| +|»» port|integer|true|none||none| +|»» pvFlag|string|true|none||none| +|»» province|string|true|none||none| +|»» vendorName|string|true|none||none| +|»» dn|string|true|none||none| +|»» neAddress|string|true|none||none| +|»» status|string|true|none||none| +|»» updateTime|string|true|none||none| +|»» serverState|object|true|none|服务状态|none| +|»»» capability|integer|true|none||none| +|»»» cpu|object|true|none||none| +|»»»» nfCpuUsage|integer|true|none||none| +|»»»» sysCpuUsage|integer|true|none||none| +|»»» expire|string|true|none||none| +|»»» mem|object|true|none||none| +|»»»» nfUsedMem|integer|true|none||none| +|»»»» sysMemUsage|integer|true|none||none| +|»»»» totalMem|integer|true|none||none| +|»»» sn|string|true|none||none| +|»»» version|string|true|none||none| +|» msg|string|true|none||none| + +## DELETE 网元信息删除 + +DELETE /ne/info/{infoIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|infoIds|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "Deleted successfully: 1" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/网元功能模块/网元主机 + +## POST 网元主机新增 + +POST /ne/host + +> Body Parameters + +```json +{ + "hostType": "ssh", + "groupId": "0", + "title": "测试机166", + "addr": "192.168.2.166", + "port": 22, + "user": "agtuser", + "authMode": "0", + "password": "admin123", + "privateKey": "", + "passPhrase": "", + "remark": "测试机166" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» hostType|body|string| yes | ssh telnet|none| +|» groupId|body|string| yes ||none| +|» title|body|string| yes ||none| +|» addr|body|string| yes | 主机地址|none| +|» port|body|integer| yes | SSH端口|none| +|» user|body|string| yes | 主机地址|none| +|» authMode|body|string| yes | 认证模式（0密码 1主机私钥）|none| +|» password|body|string| yes | 认证密码|none| +|» privateKey|body|string| yes | 认证私钥|none| +|» passPhrase|body|string| yes | 认证私钥密码|none| +|» remark|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||信息ID| +|» msg|string|true|none||none| + +## PUT 网元主机修改 + +PUT /ne/host + +> Body Parameters + +```json +{ + "hostId": "3", + "hostType": "telnet", + "groupId": "0", + "title": "测试机166", + "addr": "192.168.2.166", + "port": 22, + "user": "agtuser", + "authMode": "0", + "password": "admin123", + "privateKey": "", + "passPhrase": "", + "remark": "测试机166" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» hostId|body|string| yes ||none| +|» hostType|body|string| yes | ssh telnet|none| +|» groupId|body|string| yes ||none| +|» title|body|string| yes ||none| +|» addr|body|string| yes | 主机地址|none| +|» port|body|integer| yes | SSH端口|none| +|» user|body|string| yes | 主机地址|none| +|» authMode|body|string| yes | 认证模式（0密码 1主机私钥）|none| +|» password|body|string| yes | 认证密码|none| +|» privateKey|body|string| yes | 认证私钥|none| +|» passPhrase|body|string| yes | 认证私钥密码|none| +|» remark|body|string| yes ||none| + +> Response Examples + +> 200 Response + +```json +{ + "code": 0, + "msg": "string" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 网元主机测试连接 + +POST /ne/host/test + +> Body Parameters + +```json +{ + "addr": "string", + "port": 0, + "user": "string", + "authMode": "string", + "password": "string", + "privateKey": "string", + "passPhrase": "string", + "hostType": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» addr|body|string| yes | 主机地址|none| +|» port|body|integer| yes | SSH端口|none| +|» user|body|string| yes | 主机地址|none| +|» authMode|body|string| yes | 认证模式（0密码 1主机私钥）|none| +|» password|body|string| yes | 认证密码|none| +|» privateKey|body|string| yes | 认证私钥|none| +|» passPhrase|body|string| yes | 认证私钥密码|none| +|» hostType|body|string| yes | 主机类型 ssh telnet|none| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## POST 网元主机SSH方式检查服务器环境 + +POST /ne/host/checkBySSH + +> Body Parameters + +```json +{ + "addr": "string", + "port": 0, + "user": "string", + "authMode": "string", + "password": "string", + "privateKey": "string", + "passPhrase": "string", + "hostType": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» addr|body|string| yes | 主机地址|none| +|» port|body|integer| yes | SSH端口|none| +|» user|body|string| yes | 主机地址|none| +|» authMode|body|string| yes | 认证模式（0密码 1主机私钥）|none| +|» password|body|string| yes | 认证密码|none| +|» privateKey|body|string| yes | 认证私钥|none| +|» passPhrase|body|string| yes | 认证私钥密码|none| +|» hostType|body|string| yes | 主机类型 ssh telnet|none| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "addr": "192.168.2.211", + "kernelName": "Linux", + "kernelRelease": "4.15.0-213-generic", + "machine": "x86_64", + "nodename": "omc-u18.04-dev", + "prettyName": "Ubuntu 18.04.6 LTS", + "sshLink": false, + "sudo": true + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» addr|string|true|none||none| +|»» kernelName|string|true|none||none| +|»» kernelRelease|string|true|none||none| +|»» machine|string|true|none||none| +|»» nodename|string|true|none||none| +|»» prettyName|string|true|none||none| +|»» sshLink|boolean|true|none||none| +|»» sudo|boolean|true|none||none| +|» msg|string|true|none||none| + +## POST 网元主机SSH方式授权免密发送 + +POST /ne/host/authorizedBySSH + +认证模式使用0 1 +不能用2已授权的进行请求 + +> Body Parameters + +```json +{ + "addr": "string", + "port": 0, + "user": "string", + "authMode": "string", + "password": "string", + "privateKey": "string", + "passPhrase": "string", + "hostType": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» addr|body|string| yes | 主机地址|none| +|» port|body|integer| yes | SSH端口|none| +|» user|body|string| yes | 主机地址|none| +|» authMode|body|string| yes | 认证模式（0密码 1主机私钥）|none| +|» password|body|string| yes | 认证密码|none| +|» privateKey|body|string| yes | 认证私钥|none| +|» passPhrase|body|string| yes | 认证私钥密码|none| +|» hostType|body|string| yes | 主机类型 ssh telnet|none| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "addr": "192.168.2.211", + "kernelName": "Linux", + "kernelRelease": "4.15.0-213-generic", + "machine": "x86_64", + "nodename": "omc-u18.04-dev", + "prettyName": "Ubuntu 18.04.6 LTS", + "sshLink": false, + "sudo": true + }, + "msg": "success" +} +``` + +```json +{ + "code": 1, + "msg": "neHost.okBySSHLink" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 网元主机发送命令 + +POST /ne/host/cmd + +> Body Parameters + +```json +{ + "hostId": "string", + "cmd": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» hostId|body|string| yes | 主机ID|none| +|» cmd|body|string| yes | 执行命令|none| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## GET 网元主机列表 + +GET /ne/host/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|hostType|query|string| no ||主机类型| +|groupId|query|string| no ||组名| +|title|query|string| no ||主机标题名称| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "hostId": "2", + "groupType": "0", + "title": "", + "username": "agtuser", + "addr": "192.168.2.166", + "port": 22, + "authMode": "0", + "password": "-", + "privateKey": "-", + "privatePassword": "-", + "remark": "测试机166", + "createBy": "admin", + "createTime": 1708314549756, + "updateBy": "", + "updateTime": 0 + } + ], + "total": 1 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» hostId|string|true|none||none| +|»» groupType|string|true|none||none| +|»» title|string|true|none||none| +|»» username|string|true|none||none| +|»» addr|string|true|none||none| +|»» port|integer|true|none||none| +|»» authMode|string|true|none||none| +|»» password|string|true|none||none| +|»» privateKey|string|true|none||none| +|»» privatePassword|string|true|none||none| +|»» remark|string|true|none||none| +|»» createBy|string|true|none||none| +|»» createTime|integer|true|none||none| +|»» updateBy|string|true|none||none| +|»» updateTime|integer|true|none||none| +|» total|integer|true|none||none| + +## DELETE 网元主机删除 + +DELETE /ne/host/{hostIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|hostIds|path|string| yes ||主机ID,多个用逗号分割| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/网元功能模块/网元主机命令 + +## GET 信息 + +GET /ne/host/{hostId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|hostId|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "hostId": "7", + "hostType": "ssh", + "groupId": "0", + "title": "测试机166", + "addr": "192.168.2.166", + "port": 22, + "user": "agtuser", + "authMode": "0", + "password": "admin123", + "privateKey": "", + "passPhrase": "", + "remark": "测试机166", + "createBy": "admin", + "createTime": 1708333292882, + "updateBy": "", + "updateTime": 0 + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» hostId|string|true|none||none| +|»» hostType|string|true|none||none| +|»» groupId|string|true|none||none| +|»» title|string|true|none||none| +|»» addr|string|true|none||none| +|»» port|integer|true|none||none| +|»» user|string|true|none||none| +|»» authMode|string|true|none||none| +|»» password|string|true|none||none| +|»» privateKey|string|true|none||none| +|»» passPhrase|string|true|none||none| +|»» remark|string|true|none||none| +|»» createBy|string|true|none||none| +|»» createTime|integer|true|none||none| +|»» updateBy|string|true|none||none| +|»» updateTime|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 新增 + +POST /ne/hostCmd + +> Body Parameters + +```json +{ + "cmdType": "udm_cmd", + "groupId": "0", + "title": "UDM通用", + "command": "ls -lsh", + "remark": "备注是通用" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» cmdType|body|string| yes | 命令类型|none| +|» groupId|body|string| yes ||none| +|» title|body|string| yes ||none| +|» command|body|string| yes | 命令|none| +|» remark|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## PUT 修改 + +PUT /ne/hostCmd + +> Body Parameters + +```json +{ + "cmdId": "1", + "cmdType": "udm_cmd", + "groupId": "0", + "title": "UDM通用", + "command": "ls -lsh", + "remark": "备注是通用" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» cmdId|body|string| yes | 命令ID|none| +|» cmdType|body|string| yes | 命令类型|none| +|» groupId|body|string| yes ||none| +|» title|body|string| yes ||none| +|» command|body|string| yes | 命令|none| +|» remark|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 列表 + +GET /ne/hostCmd/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|groupType|query|string| no ||组名| +|title|query|string| no ||主机标题名称| +|cmdType|query|string| no ||命令类型| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "cmdId": "1", + "cmdType": "udm_cmd", + "groupId": "0", + "title": "UDM通用", + "command": "ls -lsh", + "remark": "备注是通用", + "createBy": "admin", + "createTime": 1708933210277, + "updateBy": "", + "updateTime": 0 + } + ], + "total": 1 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» hostId|string|true|none||none| +|»» groupType|string|true|none||none| +|»» title|string|true|none||none| +|»» username|string|true|none||none| +|»» addr|string|true|none||none| +|»» port|integer|true|none||none| +|»» authMode|string|true|none||none| +|»» password|string|true|none||none| +|»» privateKey|string|true|none||none| +|»» privatePassword|string|true|none||none| +|»» remark|string|true|none||none| +|»» createBy|string|true|none||none| +|»» createTime|integer|true|none||none| +|»» updateBy|string|true|none||none| +|»» updateTime|integer|true|none||none| +|» total|integer|true|none||none| + +## DELETE 删除 + +DELETE /ne/hostCmd/{cmdIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|cmdIds|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/网元功能模块/网元版本信息 + +## GET 网元版本列表 + +GET /ne/version/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| no ||网元类型| +|neId|query|string| no ||网元ID| +|version|query|string| no ||当前版本| +|path|query|string| no ||当前路径| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "37", + "neType": "NSSF", + "neId": "001", + "version": "2.2403.10", + "path": "/usr/local/omc/software/nssf/nssf-r2.2403.10-ub22.deb", + "preVersion": "2.2403.10", + "prePath": "/usr/local/omc/software/nssf/nssf-r2.2403.10-ub22.deb", + "newVersion": "", + "newPath": "", + "status": "Inactive", + "createBy": "admin", + "createTime": 0, + "updateBy": "", + "updateTime": 0 + } + ], + "total": 1 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|false|none||none| +|»» neType|string|false|none||none| +|»» neId|string|false|none||none| +|»» version|string|false|none||none| +|»» path|string|false|none||none| +|»» preVersion|string|false|none||none| +|»» prePath|string|false|none||none| +|»» newVersion|string|false|none||none| +|»» newPath|string|false|none||none| +|»» status|string|false|none||none| +|»» createBy|string|false|none||none| +|»» createTime|integer|false|none||none| +|»» updateBy|string|false|none||none| +|»» updateTime|integer|false|none||none| +|» total|integer|true|none||none| + +## POST 网元版本操作 + +POST /ne/version/operate + +进行版本的安装/升级/回退操作功能 + +> Body Parameters + +```json +{ + "software": { + "neType": "SMF", + "name": "smf-r2.2403.16-ub22.deb", + "path": "/upload/software/2024/04/smf-r2.2403.17-ub22_4n6d98.deb", + "version": "2.2403.16", + "description": "=====", + "neId": "0012" + }, + "preinput": { + "pisCSCF": "y", + "pubIP": "192.168.5.57", + "mcc": "001", + "mnc": "01", + "priIP": "172.16.16.51" + } +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型| +|» neId|body|string| yes ||网元ID| +|» action|body|string| yes ||操作行为 install upgrade rollback| +|» preinput|body|object| no | 预先输入参数|预先输入| +|»» pisCSCF|body|string| no | modipplmn|IMS P/I/S-CSCF Config 配置覆盖| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## GET 网元版本信息 + +GET /ne/version/{versionId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|versionId|path|string| yes ||版本ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "id": "32", + "neType": "PCF", + "neId": "001", + "version": "2.2402.14", + "filePath": "/usr/local/omc/software/pcf/pcf-r2.2402.14-ub22.deb", + "preVersion": "", + "preFile": "", + "newVersion": "", + "newFile": "", + "status": "Active", + "updateTime": "2024-03-04T06:11:47+08:00" + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» neId|string|true|none||none| +|»» version|string|true|none||none| +|»» filePath|string|true|none||none| +|»» preVersion|string|true|none||none| +|»» preFile|string|true|none||none| +|»» newVersion|string|true|none||none| +|»» newFile|string|true|none||none| +|»» status|string|true|none||none| +|»» updateTime|string|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/网元功能模块/网元授权激活信息 + +## POST 网元授权激活授权文件替换 + +POST /ne/license/change + +状态会被置为无效，通过手动刷新检查更新状态 + +> Body Parameters + +```json +{ + "neType": "SMF", + "neId": "0012", + "licensePath": "/upload/license/2024/03/SMF_13.150_system_7jn9lh.ini", + "remark": "", + "reload": true +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型| +|» neId|body|string| yes ||网元ID| +|» licensePath|body|string| yes ||授权文件| +|» reload|body|boolean| no ||刷新刷新服务| +|» remark|body|string| no ||备注| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## GET 网元授权激活状态 + +GET /ne/license/state + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型| +|neId|query|string| yes ||网元ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "expire": "2024-05-31", + "sn": "13770712" + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» expire|string|true|none||none| +|»» sn|string|true|none||none| +|» msg|string|true|none||none| + +## GET 网元授权激活列表 + +GET /ne/license/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| no ||网元类型| +|neId|query|string| no ||网元ID| +|expiryDate|query|string| no ||过期时间| +|createBy|query|string| no ||创建人| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "1", + "neType": "AUSF", + "neId": "001", + "activationRequestCode": "73A80974096B54B0096E28D15CB2B63AC188137BE14AC778C188137BE14AC778C8AB80E9DBA1D55598815DA798397C96", + "licensePath": "/usr/local/etc/smf/license/system.imi", + "serialNum": "13750541", + "expiryDate": "2024-05-31", + "status": "1", + "remark": "通用激活", + "createBy": "", + "createTime": 0, + "updateBy": "admin", + "updateTime": 1711705049275 + } + ], + "total": 1 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|false|none||none| +|»» neType|string|false|none||none| +|»» neId|string|false|none||none| +|»» activationRequestCode|string|false|none||none| +|»» licensePath|string|false|none||none| +|»» serialNum|string|false|none||none| +|»» expiryDate|string|false|none||none| +|»» status|string|false|none||none| +|»» remark|string|false|none||none| +|»» createBy|string|false|none||none| +|»» createTime|integer|false|none||none| +|»» updateBy|string|false|none||none| +|»» updateTime|integer|false|none||none| +|» total|integer|true|none||none| + +## GET 网元授权激活信息 + +GET /ne/license/{licenseId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|licenseId|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "id": "3", + "neType": "SMF", + "neId": "001", + "activationRequestCode": "73A80974096B54B0096E28D15CB2B63AC188137BE14AC778C188137BE14AC778C8AB80E9DBA1D55598815DA798397C96", + "licensePath": "/usr/local/etc/smf/license/system.imi", + "serialNum": "13750541", + "expiryDate": "2024-05-31", + "status": "1", + "remark": "通用激活", + "createBy": "admin", + "createTime": 1711704945463, + "updateBy": "", + "updateTime": 0 + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» neId|string|true|none||none| +|»» activationRequestCode|string|true|none||none| +|»» licensePath|string|true|none||none| +|»» serialNum|string|true|none||none| +|»» expiryDate|string|true|none||none| +|»» status|string|true|none||none| +|»» remark|string|true|none||none| +|»» createBy|string|true|none||none| +|»» createTime|integer|true|none||none| +|»» updateBy|string|true|none||none| +|»» updateTime|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 网元授权激活授权申请码 + +GET /ne/license/code + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型| +|neId|query|string| yes ||网元id| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": "2B12515AECDC46779ED26BB237AB2547C6A59D31FE3B60C34570DA4B53B0BF54C4988FCC17ED9D54803563DA3DC0C055", + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## GET 网元neType和neID查询 + +GET /ne/license/byTypeAndID + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型| +|neId|query|string| yes ||网元id| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "id": "6", + "neType": "SMF", + "neId": "001", + "activationRequestCode": "BF9668CD434898D68FCCA373AC4922E0C864B485D17EEC407F53CDC6F966D95C090C89D79F2DC9BC531D600637CE3F37", + "licensePath": "/upload/license/2024/04/5GC_00000005_2024-04-19_system_rjldl7.ini", + "serialNum": "00000005", + "expiryDate": "2025-04-19", + "status": "0", + "remark": "", + "createBy": "supervisor", + "createTime": 1713928436971, + "updateBy": "supervisor", + "updateTime": 1714372400293 + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/网元功能模块/网元软件包 + +## POST 网元软件包新增 + +POST /ne/software + +校验唯一：类型-名称-版本 +当前接口会找到已存在的删除后重新添加 + +> Body Parameters + +```json +{ + "neType": null, + "name": null, + "version": null, + "path": "string", + "description": null +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no | ne_software|none| +|» neType|body|string| yes ||网元类型| +|» name|body|string| yes ||包名称| +|» version|body|string| yes ||包版本| +|» path|body|string| no ||包路径| +|» description|body|string| no ||包说明| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## PUT 网元软件包修改 + +PUT /ne/software + +> Body Parameters + +```json +{ + "id": "string", + "neType": null, + "name": null, + "version": null, + "path": "string", + "description": null +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no | ne_software|none| +|» id|body|string| yes ||none| +|» neType|body|string| yes ||网元类型| +|» name|body|string| yes ||包名称| +|» version|body|string| yes ||包版本| +|» path|body|string| yes ||包路径| +|» description|body|string| no ||包说明| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 网元软件包设为网元新版本 + +POST /ne/software/newNeVersion + +将已有的软件包信息作为网元新版本 +选择软件包作为安装升级时使用 + +> Body Parameters + +```json +{ + "version": "2.2404.18", + "neType": "SMF", + "name": "smf-r2.2404.18-ub22.deb" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型| +|» version|body|string| yes ||包版本| +|» name|body|string| yes ||包名称| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## GET 网元软件包列表 + +GET /ne/software/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| no ||网元类型| +|name|query|string| no ||文件名| +|version|query|string| no ||版本| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "127", + "neType": "AUSF", + "name": "ausf-r2.2403.13-ub22.deb", + "path": "/upload/software/2024/03/ausf-r2.2403.13-ub22_4858az.deb", + "version": "2.2403.13", + "description": "", + "createBy": "", + "createTime": 0, + "updateBy": "", + "updateTime": 0 + } + ], + "total": 2 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» name|string|true|none||none| +|»» path|string|true|none||none| +|»» version|string|true|none||none| +|»» description|string|true|none||none| +|»» createBy|string|true|none||none| +|»» createTime|integer|true|none||none| +|»» updateBy|string|true|none||none| +|»» updateTime|integer|true|none||none| +|» total|integer|true|none||none| + +## GET 网元软件包信息 + +GET /ne/software/{softwareId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|softwareId|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "id": "127", + "neType": "AUSF", + "name": "ausf-r2.2403.13-ub22.deb", + "path": "/upload/software/2024/03/ausf-r2.2403.13-ub22_4858az.deb", + "version": "2.2403.13", + "description": "", + "createBy": "", + "createTime": 0, + "updateBy": "", + "updateTime": 0 + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» name|string|true|none||none| +|»» path|string|true|none||none| +|»» version|string|true|none||none| +|»» description|string|true|none||none| +|»» createBy|string|true|none||none| +|»» createTime|integer|true|none||none| +|»» updateBy|string|true|none||none| +|»» updateTime|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 网元软件包删除 + +DELETE /ne/software/{softwareIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|softwareIds|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/网元功能模块/网元参数配置/网元参数配置可用属性值 + +## POST 网元参数配置可用属性值新增 + +POST /ne/config + +> Body Parameters + +```json +{ + "neType": "AMF", + "paramName": "system", + "paramDisplay": "System Config", + "paramType": "list", + "paramSort": 23, + "paramPerms": "post,put,delete", + "paramData": [ + { + "access": "read-write", + "comment": "", + "display": "AMF Name", + "filter": "0~64", + "name": "amfName", + "type": "string", + "value": "AMF" + }, + { + "access": "read-write", + "comment": "0~255", + "display": "Relative Capacity", + "filter": "0~255", + "name": "relativeCapacity", + "type": "int", + "value": "255" + }, + { + "access": "read-write", + "comment": "", + "display": "SBI Scheme", + "filter": "{\"0\":\"http\",\"1\":\"https\"}", + "name": "sbiScheme", + "type": "enum", + "value": "0" + }, + { + "access": "read-write", + "comment": "", + "display": "SBI Server IP", + "filter": "0~64", + "name": "sbiServerIp", + "type": "string", + "value": "192.168.1.183" + }, + { + "access": "read-write", + "comment": "0~65535", + "display": "SBI Server Port", + "filter": "0~65535", + "name": "sbiServerPort", + "type": "int", + "value": "8080" + }, + { + "access": "read-write", + "comment": "", + "display": "NRF Enabled", + "filter": "{\"0\":\"false\",\"1\":\"true\"}", + "name": "nrfEnabled", + "type": "bool", + "value": "0" + }, + { + "access": "read-write", + "comment": "", + "display": "NRF URI", + "filter": "0~64", + "name": "nrfUri", + "type": "string", + "value": "http://172.16.5.180:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "AUSF URI", + "filter": "0~64", + "name": "ausfUri", + "type": "string", + "value": "http://172.16.5.130:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "UDM URI", + "filter": "0~64", + "name": "udmUri", + "type": "string", + "value": "http://172.16.5.140:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "SMF URI", + "filter": "0~64", + "name": "smfUri", + "type": "string", + "value": "http://172.16.5.150:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "PCF URI", + "filter": "0~64", + "name": "pcfUri", + "type": "string", + "value": "http://172.16.5.160:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "LMF URI", + "filter": "0~64", + "name": "lmfUri", + "type": "string", + "value": "http://172.16.5.200:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "NEF URI", + "filter": "0~64", + "name": "nefUri", + "type": "string", + "value": "http://172.16.5.210:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "DNN Correction Enabled", + "filter": "{\"0\":\"false\",\"1\":\"true\"}", + "name": "dnnCorrectionEnabled", + "type": "bool", + "value": "0" + }, + { + "access": "read-write", + "comment": "", + "display": "Default DNN", + "filter": "0~64", + "name": "defaultDnn", + "type": "string", + "value": "internet" + }, + { + "access": "read-write", + "comment": "", + "display": "Integrity Algorithm", + "filter": "{\"0\":\"NIA0\",\"1\":\"NIA1\",\"2\":\"NIA2\",\"3\":\"NIA3\"}", + "name": "integrityAlgorithm", + "type": "enum", + "value": "2" + }, + { + "access": "read-write", + "comment": "", + "display": "Ciphering Algorithm", + "filter": "{\"0\":\"NEA0\",\"1\":\"NEA1\",\"2\":\"NEA2\",\"3\":\"NEA3\"}", + "name": "cipheringAlgorithm", + "type": "enum", + "value": "0" + }, + { + "access": "read-write", + "comment": "", + "display": "T3502", + "filter": "1~65535", + "name": "t3502", + "type": "int", + "value": "720" + }, + { + "access": "read-write", + "comment": "", + "display": "T3512", + "filter": "1~65535", + "name": "t3512", + "type": "int", + "value": "3600" + }, + { + "access": "read-write", + "comment": "", + "display": "T3513", + "filter": "1~65535", + "name": "t3513", + "type": "int", + "value": "2" + }, + { + "access": "read-write", + "comment": "", + "display": "T3522", + "filter": "1~65535", + "name": "t3522", + "type": "int", + "value": "6" + }, + { + "access": "read-write", + "comment": "", + "display": "T3550", + "filter": "1~65535", + "name": "t3550", + "type": "int", + "value": "6" + }, + { + "access": "read-write", + "comment": "", + "display": "T3555", + "filter": "1~65535", + "name": "t3555", + "type": "int", + "value": "6" + }, + { + "access": "read-write", + "comment": "", + "display": "T3560", + "filter": "1~65535", + "name": "t3560", + "type": "int", + "value": "6" + }, + { + "access": "read-write", + "comment": "", + "display": "T3565", + "filter": "1~65535", + "name": "t3565", + "type": "int", + "value": "6" + }, + { + "access": "read-write", + "comment": "", + "display": "T3570", + "filter": "1~65535", + "name": "t3570", + "type": "int", + "value": "6" + } + ] +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||none| +|» paramData|body|[object]| yes ||none| +|»» access|body|string| yes ||none| +|»» comment|body|string| yes ||none| +|»» display|body|string| yes ||none| +|»» filter|body|string| yes ||none| +|»» name|body|string| yes ||none| +|»» type|body|string| yes ||none| +|»» value|body|string| yes ||none| +|» paramName|body|string| yes ||none| +|» paramDisplay|body|string| yes ||none| +|» paramType|body|string| yes ||none| +|» paramSort|body|integer| yes ||none| +|» paramPerms|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## PUT 网元参数配置可用属性值修改 + +PUT /ne/config + +> Body Parameters + +```json +{ + "id": "1874", + "neType": "AMF", + "paramName": "system", + "paramDisplay": "System Config", + "paramType": "list", + "paramSort": 23, + "paramPerms": "post,put,delete", + "paramData": [ + { + "access": "read-write", + "comment": "", + "display": "AMF Name", + "filter": "0~64", + "name": "amfName", + "type": "string", + "value": "AMF" + }, + { + "access": "read-write", + "comment": "0~255", + "display": "Relative Capacity", + "filter": "0~255", + "name": "relativeCapacity", + "type": "int", + "value": "255" + }, + { + "access": "read-write", + "comment": "", + "display": "SBI Scheme", + "filter": "{\"0\":\"http\",\"1\":\"https\"}", + "name": "sbiScheme", + "type": "enum", + "value": "0" + }, + { + "access": "read-write", + "comment": "", + "display": "SBI Server IP", + "filter": "0~64", + "name": "sbiServerIp", + "type": "string", + "value": "192.168.1.183" + }, + { + "access": "read-write", + "comment": "0~65535", + "display": "SBI Server Port", + "filter": "0~65535", + "name": "sbiServerPort", + "type": "int", + "value": "8080" + }, + { + "access": "read-write", + "comment": "", + "display": "NRF Enabled", + "filter": "{\"0\":\"false\",\"1\":\"true\"}", + "name": "nrfEnabled", + "type": "bool", + "value": "0" + }, + { + "access": "read-write", + "comment": "", + "display": "NRF URI", + "filter": "0~64", + "name": "nrfUri", + "type": "string", + "value": "http://172.16.5.180:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "AUSF URI", + "filter": "0~64", + "name": "ausfUri", + "type": "string", + "value": "http://172.16.5.130:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "UDM URI", + "filter": "0~64", + "name": "udmUri", + "type": "string", + "value": "http://172.16.5.140:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "SMF URI", + "filter": "0~64", + "name": "smfUri", + "type": "string", + "value": "http://172.16.5.150:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "PCF URI", + "filter": "0~64", + "name": "pcfUri", + "type": "string", + "value": "http://172.16.5.160:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "LMF URI", + "filter": "0~64", + "name": "lmfUri", + "type": "string", + "value": "http://172.16.5.200:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "NEF URI", + "filter": "0~64", + "name": "nefUri", + "type": "string", + "value": "http://172.16.5.210:8080" + }, + { + "access": "read-write", + "comment": "", + "display": "DNN Correction Enabled", + "filter": "{\"0\":\"false\",\"1\":\"true\"}", + "name": "dnnCorrectionEnabled", + "type": "bool", + "value": "0" + }, + { + "access": "read-write", + "comment": "", + "display": "Default DNN", + "filter": "0~64", + "name": "defaultDnn", + "type": "string", + "value": "internet" + }, + { + "access": "read-write", + "comment": "", + "display": "Integrity Algorithm", + "filter": "{\"0\":\"NIA0\",\"1\":\"NIA1\",\"2\":\"NIA2\",\"3\":\"NIA3\"}", + "name": "integrityAlgorithm", + "type": "enum", + "value": "2" + }, + { + "access": "read-write", + "comment": "", + "display": "Ciphering Algorithm", + "filter": "{\"0\":\"NEA0\",\"1\":\"NEA1\",\"2\":\"NEA2\",\"3\":\"NEA3\"}", + "name": "cipheringAlgorithm", + "type": "enum", + "value": "0" + }, + { + "access": "read-write", + "comment": "", + "display": "T3502", + "filter": "1~65535", + "name": "t3502", + "type": "int", + "value": "720" + }, + { + "access": "read-write", + "comment": "", + "display": "T3512", + "filter": "1~65535", + "name": "t3512", + "type": "int", + "value": "3600" + }, + { + "access": "read-write", + "comment": "", + "display": "T3513", + "filter": "1~65535", + "name": "t3513", + "type": "int", + "value": "2" + }, + { + "access": "read-write", + "comment": "", + "display": "T3522", + "filter": "1~65535", + "name": "t3522", + "type": "int", + "value": "6" + }, + { + "access": "read-write", + "comment": "", + "display": "T3550", + "filter": "1~65535", + "name": "t3550", + "type": "int", + "value": "6" + }, + { + "access": "read-write", + "comment": "", + "display": "T3555", + "filter": "1~65535", + "name": "t3555", + "type": "int", + "value": "6" + }, + { + "access": "read-write", + "comment": "", + "display": "T3560", + "filter": "1~65535", + "name": "t3560", + "type": "int", + "value": "6" + }, + { + "access": "read-write", + "comment": "", + "display": "T3565", + "filter": "1~65535", + "name": "t3565", + "type": "int", + "value": "6" + }, + { + "access": "read-write", + "comment": "", + "display": "T3570", + "filter": "1~65535", + "name": "t3570", + "type": "int", + "value": "6" + } + ] +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» id|body|string| yes ||none| +|» neType|body|string| yes ||none| +|» paramData|body|[object]| yes ||none| +|»» access|body|string| yes ||none| +|»» comment|body|string| yes ||none| +|»» display|body|string| yes ||none| +|»» filter|body|string| yes ||none| +|»» name|body|string| yes ||none| +|»» type|body|string| yes ||none| +|»» value|body|string| yes ||none| +|» paramName|body|string| yes ||none| +|» paramDisplay|body|string| yes ||none| +|» paramType|body|string| yes ||none| +|» paramSort|body|integer| yes ||none| +|» paramPerms|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 网元参数配置可用属性值删除 + +DELETE /ne/config + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|id|query|string| no ||参数ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "Deleted successfully: 1" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 网元参数配置可用属性值列表 + +GET /ne/config/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| no ||网元类型| +|paramName|query|string| no ||网元类型可用属性| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "1824", + "neType": "MME", + "paramName": "system", + "paramDisplay": "System Config", + "paramType": "list", + "paramSort": "0", + "paramPerms": "", + "updateTime": 1719817365679 + } + ], + "total": 1 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|false|none||none| +|»» neType|string|false|none||none| +|»» topTag|string|false|none||none| +|»» topDisplay|string|false|none||none| +|»» method|string|false|none||none| +|» total|integer|true|none||none| + +## GET 网元参数配置可用属性值列表指定网元类型全部无分页 + +GET /ne/config/list/{neType} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|path|string| yes ||网元类型| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "1637", + "neType": "UDM", + "topTag": "applicationServer", + "topDisplay": "Application Server", + "method": "" + } + ], + "total": 1 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|false|none||none| +|»» neType|string|false|none||none| +|»» topTag|string|false|none||none| +|»» topDisplay|string|false|none||none| +|»» method|string|false|none||none| +|» total|integer|true|none||none| + +## GET 网元参数配置可用属性值信息 + +GET /ne/config/info/{id} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|id|path|string| yes ||列表数据ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "id": "1824", + "neType": "MME", + "paramName": "system", + "paramDisplay": "System Config", + "paramType": "list", + "paramSort": "0", + "paramPerms": "", + "updateTime": 1719817365679, + "paramData": [ + { + "access": "read-write", + "comment": "true|false", + "display": "CSFB Enabled", + "filter": "{\"0\":\"false\",\"1\":\"true\"}", + "name": "csfbEnabled", + "type": "bool", + "value": "false" + }, + { + "access": "read-write", + "comment": "true|false", + "display": "VoLTE Enabled", + "filter": "{\"0\":\"false\",\"1\":\"true\"}", + "name": "volteEnabled", + "type": "bool", + "value": "false" + }, + { + "access": "read-write", + "comment": "0~64", + "display": "S1 MME IP", + "filter": "0~64", + "name": "s1MmeIp", + "type": "string", + "value": "192.168.1.179" + }, + { + "access": "read-only", + "comment": "0~65535", + "display": "S1 MME Port", + "filter": "0~65535", + "name": "s1MmePort", + "type": "int", + "value": "36412" + }, + { + "access": "read-write", + "comment": "0~64", + "display": "S11 MME IP", + "filter": "0~64", + "name": "s11MmeIp", + "type": "string", + "value": "192.168.1.179" + }, + { + "access": "read-write", + "comment": "0~65535", + "display": "S11 MME Port", + "filter": "0~65535", + "name": "s11MmePort", + "type": "int", + "value": "2123" + }, + { + "access": "read-write", + "comment": "0~64", + "display": "S10 MME IP", + "filter": "0~64", + "name": "s10MmeIp", + "type": "string", + "value": "192.168.1.178" + }, + { + "access": "read-write", + "comment": "0~65535", + "display": "S10 MME Port", + "filter": "0~65535", + "name": "s10MmePort", + "type": "int", + "value": "2123" + }, + { + "access": "read-write", + "comment": "0~64", + "display": "SGs MME IP", + "filter": "0~64", + "name": "sgsMmeIp", + "type": "string", + "value": "192.168.1.179" + }, + { + "access": "read-only", + "comment": "0~65535", + "display": "SGs MME Port", + "filter": "0~65535", + "name": "sgsMmePort", + "type": "int", + "value": "29118" + }, + { + "access": "read-write", + "comment": "0~100", + "display": "S6A MME Identity", + "filter": "0~100", + "name": "s6aIdentity", + "type": "string", + "value": "mme.epc.mnc001.mcc001.3gppnetwork.org" + }, + { + "access": "read-write", + "comment": "0~20", + "display": "S6A MME IP", + "filter": "0~20", + "name": "localIp", + "type": "string", + "value": "172.16.5.220" + } + ] + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» paramName|string|true|none||none| +|»» paramDisplay|string|true|none||none| +|»» paramType|string|true|none||none| +|»» paramSort|string|true|none||none| +|»» paramPerms|string|true|none||none| +|»» updateTime|integer|true|none||none| +|»» paramData|[object]|true|none||none| +|»»» access|string|true|none||none| +|»»» comment|string|true|none||none| +|»»» display|string|true|none||none| +|»»» filter|string|true|none||none| +|»»» name|string|true|none||none| +|»»» type|string|true|none||none| +|»»» value|string|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/网元功能模块/网元参数配置/网元参数配置数据 + +## GET 网元参数配置数据信息 + +GET /ne/config/data + +直连到网元端获取 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型| +|neId|query|string| yes ||网元ID| +|paramName|query|string| yes ||可用属性值| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": [ + { + "amfName": "AMF", + "ausfUri": "http://192.168.13.130:8080", + "cipheringAlgorithm": 0, + "defaultDnn": "cmnet", + "dnnCorrectionEnabled": false, + "integrityAlgorithm": 2, + "lmfUri": "http://192.168.13.200:8080", + "nefUri": "http://192.168.13.210:23", + "nrfEnabled": false, + "nrfUri": "http://192.168.13.180:8080", + "pcfUri": "http://192.168.13.160:8080", + "relativeCapacity": 255, + "sbiScheme": 0, + "sbiServerIp": "192.168.13.120", + "sbiServerPort": 8080, + "smfUri": "http://192.168.13.150:8080", + "t3502": 720, + "t3512": 3600, + "t3513": 2, + "t3522": 2, + "t3550": 2, + "t3555": 2, + "t3560": 2, + "t3565": 2, + "t3570": 2, + "udmUri": "http://192.168.13.140:8080" + } + ], + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|[string]|true|none||数组内容根据网元返回| +|» msg|string|true|none||none| + +## PUT 网元参数配置数据更新 + +PUT /ne/config/data + +成功204 无内容 +仅array使用与数据对象内index一致,有多层时划分嵌套层(index/subParamName/index) + +> Body Parameters + +```json +{ + "neType": "MME", + "neId": "001", + "paramName": "pgw", + "paramData": { + "index": 1, + "apn": "internet", + "pgwIp": "234.248.140.49", + "plmnId": "31233" + }, + "loc": "1" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型| +|» neId|body|string| yes ||网元ID| +|» paramName|body|string| yes ||根据配置可选值| +|» paramData|body|object| yes ||数据对象| +|»» index|body|integer| no ||array更新项| +|»» apn|body|string| no ||none| +|»» pgwIp|body|string| no ||none| +|»» plmnId|body|string| no ||none| +|» loc|body|string| no ||仅array使用与数据对象内index一致,有多层时划分嵌套层(index/subParamName/index)| + +> Response Examples + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|400|[Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1)|none|Inline| + +### Responses Data Schema + +## POST 网元参数配置数据新增（array） + +POST /ne/config/data + +响应200成功，请求体发送什么返回什么 +loc与数据对象内index一致,有多层时划分嵌套层(index/subParamName/index) + +> Body Parameters + +```json +{ + "neType": "SMF", + "neId": "002", + "paramName": "upfConfig", + "paramData": { + "index": 1, + "dnn": "3333", + "ipPoolType": "IPv4v6", + "ipv4Pools": "192.168.1.0/24", + "ipv6Pools": "fe80::20c:29ff:fee4:dab7/50", + "staticIpv4Enable": false, + "staticIpv4Start": "", + "staticIpv4End": "", + "staticIpv6Enable": false, + "staticIpv6Start": "", + "staticIpv6End": "" + }, + "loc": "2/ueDnnIpPool/1" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型| +|» neId|body|string| yes ||网元ID| +|» paramName|body|string| yes ||根据配置可选值| +|» loc|body|string| yes ||与数据对象内index一致,有多层时划分嵌套层(index/subParamName/index)| +|» paramData|body|object| yes ||数据对象| +|»» index|body|integer| no ||跟随loc层，不小于已存在的index| +|»» apn|body|string| no ||none| +|»» pgwIp|body|string| no ||none| +|»» plmnId|body|string| no ||none| + +> Response Examples + +```json +null +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## DELETE 网元参数配置数据删除（array） + +DELETE /ne/config/data + +成功返回204 无内容 +loc与数据对象内index一致,有多层时划分嵌套层(index/subParamName/index) + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型| +|neId|query|string| yes ||网元ID| +|paramName|query|string| yes ||根据配置可选值| +|loc|query|string| yes ||与数据对象内index一致,有多层时划分嵌套层(index/subParamName/index)| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 204 Response + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|204|[No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **204** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» dnn|string|true|none||none| +|» tai|string|true|none||none| +|» upfId|string|true|none||none| + +# 中文src目录接口/网元功能模块/网元配置文件备份记录 + +## GET 网元配置文件备份记录列表 + +GET /ne/config/backup/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| no ||网元类型| +|neId|query|string| no ||网元ID| +|name|query|string| no ||文件名| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## GET 网元配置文件备份记录下载 + +GET /ne/config/backup/download + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|id|query|string| no ||信息ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## PUT 网元配置文件备份记录修改 + +PUT /ne/config/backup + +> Body Parameters + +```json +{ + "id": "string", + "name": "string", + "remark": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» id|body|string| yes ||记录ID| +|» name|body|string| yes ||名称| +|» remark|body|string| no ||备注| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## DELETE 网元配置文件备份记录删除 + +DELETE /ne/config/backup + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|id|query|string| no ||信息Id，可多个删除,号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## POST 网元配置文件备份导入 + +POST /ne/config/backup/import + +> Body Parameters + +```json +{ + "neType": "string", + "neId": "string", + "type": "string", + "path": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型| +|» neId|body|string| yes ||网元ID| +|» type|body|string| yes ||导入方式 backup upload| +|» path|body|string| yes ||文件路径| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## POST 网元配置文件备份导出 + +POST /ne/config/backup/export + +> Body Parameters + +```json +{ + "neType": "string", + "neId": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型| +|» neId|body|string| yes ||网元ID| + +> Response Examples + +> 200 Response + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/网元数据模块/性能统计 + +## GET 统计标题 + +GET /neData/kpi/title + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": [ + { + "id": "28", + "neType": "UDM", + "kpiId": "UDM.01", + "titleJson": "{\"cn\": \"5G注册用户数\", \"en\": \"UDR.5gActSub\"}", + "cnTitle": "5G注册用户数", + "enTitle": "UDR.5gActSub" + }, + { + "id": "29", + "neType": "UDM", + "kpiId": "UDM.02", + "titleJson": "{\"cn\": \"AMF发起的UECM注册请求次数\", \"en\": \"UDM.AmfUecmRegReq\"}", + "cnTitle": "AMF发起的UECM注册请求次数", + "enTitle": "UDM.AmfUecmRegReq" + }, + { + "id": "30", + "neType": "UDM", + "kpiId": "UDM.03", + "titleJson": "{\"cn\": \"AMF发起的UECM注册成功次数\", \"en\": \"UDM.AmfUecmRegSucc\"}", + "cnTitle": "AMF发起的UECM注册成功次数", + "enTitle": "UDM.AmfUecmRegSucc" + }, + { + "id": "31", + "neType": "UDM", + "kpiId": "UDM.04", + "titleJson": "{\"cn\": \"SMF发起的UECM注册成功次数\", \"en\": \"UDM.SmfUecmRegSucc\"}", + "cnTitle": "SMF发起的UECM注册成功次数", + "enTitle": "UDM.SmfUecmRegSucc" + }, + { + "id": "32", + "neType": "UDM", + "kpiId": "UDM.05", + "titleJson": "{\"cn\": \"SMF发起的UECM注册请求次数\", \"en\": \"UDM.SmfUecmRegReq\"}", + "cnTitle": "SMF发起的UECM注册请求次数", + "enTitle": "UDM.SmfUecmRegReq" + }, + { + "id": "33", + "neType": "UDM", + "kpiId": "UDM.06", + "titleJson": "{\"cn\": \"4G注册用户数\", \"en\": \"SUB.EpsActSubsInHss\"}", + "cnTitle": "4G注册用户数", + "enTitle": "SUB.EpsActSubsInHss" + }, + { + "id": "34", + "neType": "UDM", + "kpiId": "UDM.07", + "titleJson": "{\"cn\": \"4G鉴权信息查询成功次数\", \"en\": \"DIAM.AucInfoAnsSucc\"}", + "cnTitle": "4G鉴权信息查询成功次数", + "enTitle": "DIAM.AucInfoAnsSucc" + }, + { + "id": "35", + "neType": "UDM", + "kpiId": "UDM.08", + "titleJson": "{\"cn\": \"4G鉴权信息查询请求次数\", \"en\": \"DIAM.AucInfoReq\"}", + "cnTitle": "4G鉴权信息查询请求次数", + "enTitle": "DIAM.AucInfoReq" + }, + { + "id": "36", + "neType": "UDM", + "kpiId": "UDM.09", + "titleJson": "{\"cn\": \"4G更新位置成功次数\", \"en\": \"DIAM.UpdateLocationAnsSucc\"}", + "cnTitle": "4G更新位置成功次数", + "enTitle": "DIAM.UpdateLocationAnsSucc" + }, + { + "id": "37", + "neType": "UDM", + "kpiId": "UDM.10", + "titleJson": "{\"cn\": \"4G更新位置请求次数\", \"en\": \"DIAM.UpdateLocationReq\"}", + "cnTitle": "4G更新位置请求次数", + "enTitle": "DIAM.UpdateLocationReq" + }, + { + "id": "38", + "neType": "UDM", + "kpiId": "UDM.11", + "titleJson": "{\"cn\": \"SAR成功响应总次数\", \"en\": \"UR.SuccSAA\"}", + "cnTitle": "SAR成功响应总次数", + "enTitle": "UR.SuccSAA" + }, + { + "id": "39", + "neType": "UDM", + "kpiId": "UDM.12", + "titleJson": "{\"cn\": \"SAR请求总次数\", \"en\": \"UR.AttSAR\"}", + "cnTitle": "SAR请求总次数", + "enTitle": "UR.AttSAR" + }, + { + "id": "40", + "neType": "UDM", + "kpiId": "UDM.13", + "titleJson": "{\"cn\": \"LIR成功响应总次数\", \"en\": \"LIQ.SuccLIA\"}", + "cnTitle": "LIR成功响应总次数", + "enTitle": "LIQ.SuccLIA" + }, + { + "id": "41", + "neType": "UDM", + "kpiId": "UDM.14", + "titleJson": "{\"cn\": \"LIR请求总次数\", \"en\": \"LIQ.AttLIR\"}", + "cnTitle": "LIR请求总次数", + "enTitle": "LIQ.AttLIR" + } + ], + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|[object]|true|none||none| +|»» cn_title|string|true|none||none| +|»» en_title|string|true|none||none| +|»» id|integer|true|none||none| +|»» kpi_id|string|true|none||none| +|»» ne_type|string|true|none||none| +|»» title_json|string|true|none||none| +|» msg|string|true|none||none| + +## GET 统计数据 + +GET /neData/kpi/data + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型| +|neId|query|string| yes ||网元ID| +|startTime|query|string| yes ||开始时间| +|endTime|query|string| yes ||结束时间| +|interval|query|number| yes ||颗粒度/平均采样值，单位秒 5 60 300 900 1800 3600| +|sortField|query|string| no ||排序字段，填写结果字段| +|sortOrder|query|string| no ||排序升降序，asc desc| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": [ + { + "SMF.01": "1594", + "SMF.02": "1594", + "SMF.03": "1594", + "SMF.04": "1594", + "SMF.05": "1594", + "SMF.06": "1594", + "SMF.07": "1594", + "SMF.08": "1594", + "SMF.09": "1594", + "SMF.10": "1594", + "SMF.11": "1594", + "SMF.12": "1594", + "SMF.13": "1594", + "SMF.14": "797", + "neName": "0", + "startIndex": 0, + "timeGroup": "2023-09-25 00:00" + }, + { + "SMF.01": "0", + "SMF.02": "0", + "SMF.03": "0", + "SMF.04": "0", + "SMF.05": "0", + "SMF.06": "0", + "SMF.07": "0", + "SMF.08": "0", + "SMF.09": "0", + "SMF.10": "0", + "SMF.11": "0", + "SMF.12": "0", + "SMF.13": "0", + "SMF.14": "0", + "neName": "0", + "startIndex": 15, + "timeGroup": "2023-09-25 00:15" + }, + { + "SMF.01": "0", + "SMF.02": "0", + "SMF.03": "0", + "SMF.04": "0", + "SMF.05": "0", + "SMF.06": "0", + "SMF.07": "0", + "SMF.08": "0", + "SMF.09": "0", + "SMF.10": "0", + "SMF.11": "0", + "SMF.12": "0", + "SMF.13": "0", + "SMF.14": "0", + "neName": "0", + "startIndex": 30, + "timeGroup": "2023-09-25 00:30" + }, + { + "SMF.01": "0", + "SMF.02": "0", + "SMF.03": "0", + "SMF.04": "0", + "SMF.05": "0", + "SMF.06": "0", + "SMF.07": "0", + "SMF.08": "0", + "SMF.09": "0", + "SMF.10": "0", + "SMF.11": "0", + "SMF.12": "0", + "SMF.13": "0", + "SMF.14": "0", + "neName": "0", + "startIndex": 45, + "timeGroup": "2023-09-25 00:45" + }, + { + "SMF.01": "0", + "SMF.02": "0", + "SMF.03": "0", + "SMF.04": "0", + "SMF.05": "0", + "SMF.06": "0", + "SMF.07": "0", + "SMF.08": "0", + "SMF.09": "0", + "SMF.10": "0", + "SMF.11": "0", + "SMF.12": "0", + "SMF.13": "0", + "SMF.14": "0", + "neName": "0", + "startIndex": 93, + "timeGroup": "2023-09-25 01:30" + }, + { + "SMF.01": "0", + "SMF.02": "0", + "SMF.03": "0", + "SMF.04": "0", + "SMF.05": "0", + "SMF.06": "0", + "SMF.07": "0", + "SMF.08": "0", + "SMF.09": "0", + "SMF.10": "0", + "SMF.11": "0", + "SMF.12": "0", + "SMF.13": "0", + "SMF.14": "0", + "neName": "0", + "startIndex": 105, + "timeGroup": "2023-09-25 01:45" + } + ], + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|[object]|true|none||none| +|»» SMF.01|string|true|none||none| +|»» SMF.02|string|true|none||none| +|»» SMF.03|string|true|none||none| +|»» SMF.04|string|true|none||none| +|»» SMF.05|string|true|none||none| +|»» SMF.06|string|true|none||none| +|»» SMF.07|string|true|none||none| +|»» SMF.08|string|true|none||none| +|»» SMF.09|string|true|none||none| +|»» SMF.10|string|true|none||none| +|»» SMF.11|string|true|none||none| +|»» SMF.12|string|true|none||none| +|»» SMF.13|string|true|none||none| +|»» SMF.14|string|true|none||none| +|»» neName|string|true|none||none| +|»» startIndex|integer|true|none||none| +|»» timeGroup|string|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/网元数据模块/告警数据 + +## GET 告警列表 + +GET /neData/alarm/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型, 暂时支持AMF| +|neId|query|string| yes ||网元ID| +|startTime|query|string| no ||开始时间| +|endTime|query|string| no ||结束时间| +|sortField|query|string| no ||排序字段，填写结果字段| +|sortOrder|query|string| no ||排序升降序，asc desc| +|objectType|query|string| no ||告警类型 1: Critical, 2: Major, 3: Minor, 4: Warning, 5: Event(Only VNF)| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "5", + "alarmSeq": "1", + "alarmId": "HXEMSSM10000", + "alarmTitle": "The system state is abnormal", + "neType": "AMF", + "neId": "4400HX1AMF001", + "alarmCode": 10000, + "eventTime": "2024-02-05T11:05:20Z", + "alarmType": "EquipmentAlarm", + "origSeverity": "Major", + "perceivedSeverity": "Major", + "pvFlag": "PNF", + "neName": "AMF_001", + "objectUid": "4400HX1AMF001", + "objectName": "EMS;SystemManagement;Heartbeat", + "objectType": "VNFM", + "locationInfo": "SystemManagement.State: NE heartbeat timestamp=2024-02-05 11:04:40，threshold=30", + "province": "-", + "alarmStatus": 0, + "specificProblem": "Alarm cause: the system state of target NE has not been received for 30 seconds", + "specificProblemId": "AC10000", + "addInfo": "subNeInfo:AMF", + "counter": 0, + "latestEventTime": "0001-01-01T00:00:00Z", + "ackState": 1, + "ackTime": "2024-02-05T11:05:25Z", + "ackUser": "admin", + "clearType": 1, + "clearTime": "2024-02-05T11:05:25Z", + "clearUser": "", + "timestamp": "2024-02-05T11:05:25Z" + } + ], + "total": 1 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|false|none||none| +|»» alarmSeq|string|false|none||none| +|»» alarmId|string|false|none||none| +|»» alarmTitle|string|false|none||none| +|»» neType|string|false|none||none| +|»» neId|string|false|none||none| +|»» alarmCode|integer|false|none||none| +|»» eventTime|string|false|none||none| +|»» alarmType|string|false|none||none| +|»» origSeverity|string|false|none||none| +|»» perceivedSeverity|string|false|none||none| +|»» pvFlag|string|false|none||none| +|»» neName|string|false|none||none| +|»» objectUid|string|false|none||none| +|»» objectName|string|false|none||none| +|»» objectType|string|false|none||none| +|»» locationInfo|string|false|none||none| +|»» province|string|false|none||none| +|»» alarmStatus|integer|false|none||none| +|»» specificProblem|string|false|none||none| +|»» specificProblemId|string|false|none||none| +|»» addInfo|string|false|none||none| +|»» counter|integer|false|none||none| +|»» latestEventTime|string|false|none||none| +|»» ackState|integer|false|none||none| +|»» ackTime|string|false|none||none| +|»» ackUser|string|false|none||none| +|»» clearType|integer|false|none||none| +|»» clearTime|string|false|none||none| +|»» clearUser|string|false|none||none| +|»» timestamp|string|false|none||none| +|» total|integer|true|none||none| + +## DELETE 告警删除 + +DELETE /neData/alarm/{alarmIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|alarmIds|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "Deleted successfully: 1" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/网元数据模块/IMS + +## GET IMS-CDR会话事件列表 + +GET /neData/ims/cdr/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型, 暂时支持IMS| +|neId|query|string| yes ||网元ID| +|recordType|query|string| no ||记录行为 MOC MTC MOSM MTSM| +|startTime|query|string| no ||开始时间 毫秒| +|endTime|query|string| no ||结束时间 毫秒| +|sortField|query|string| no ||排序字段，填写结果字段| +|sortOrder|query|string| no ||排序升降序，asc desc| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "763", + "neType": "IMS", + "neName": "IMS_001", + "rmUID": "4400HX1IMS001", + "timestamp": 1706863363, + "cdrJSON": "{\"answerTime\":1706863363,\"callDuration\":391,\"callReference\":\"18656735160@10.25.0.210\",\"callType\":\"video\",\"calledParty\":\"18178166630\",\"callerParty\":\"13162346412\",\"cause\":200,\"fwdParty\":\"7999\",\"fwdType\":\"CFB\",\"recordType\":\"MTC\",\"releaseTime\":1706863363,\"seizureTime\":1706863363,\"seqNumber\":81,\"serviceResult\":\"ok\"}", + "createdAt": "2024-02-02T16:42:43+08:00" + }, + { + "id": "764", + "neType": "IMS", + "neName": "IMS_001", + "rmUID": "4400HX1IMS001", + "timestamp": 1706863363, + "cdrJSON": "{\"answerTime\":1706863363,\"callDuration\":707,\"callReference\":\"18112767515@10.25.0.210\",\"callType\":\"audio\",\"calledParty\":\"18175529792\",\"callerParty\":\"13953612934\",\"cause\":200,\"fwdParty\":\"7999\",\"fwdType\":\"CFB\",\"recordType\":\"MTC\",\"releaseTime\":1706863363,\"seizureTime\":1706863363,\"seqNumber\":81,\"serviceResult\":\"ok\"}", + "createdAt": "2024-02-02T16:42:43+08:00" + } + ], + "total": 8428 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» neName|string|true|none||none| +|»» rmUID|string|true|none||none| +|»» timestamp|integer|true|none||none| +|»» cdrJSON|string|true|none||none| +|»» createdAt|string|true|none||none| +|» total|integer|true|none||none| + +## DELETE IMS-CDR会话删除 + +DELETE /neData/ims/cdr/{cdrIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|cdrIds|path|string| yes ||多个逗号分割| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "Deleted successfully: 1" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## POST IMS-CDR会话列表导出 + +POST /neData/ims/cdr/export + +> Body Parameters + +```json +{ + "neType": "IMS", + "neId": "001", + "recordType": "MTC,MTSM", + "callerParty": "", + "calledParty": "", + "startTime": "", + "endTime": "", + "sortField": "timestamp", + "sortOrder": "desc", + "pageNum": 1, + "pageSize": 100 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型, 暂时支持IMS| +|» neId|body|string| yes ||none| +|» recordType|body|string| no ||记录行为 MOC MTC MOSM MTSM| +|» callerParty|body|string| no ||主叫号码| +|» calledParty|body|string| yes ||被叫号码| +|» startTime|body|string| no ||none| +|» endTime|body|string| no ||none| +|» sortField|body|string| yes ||排序字段 timestamp| +|» sortOrder|body|string| yes ||排序升降序，asc desc| +|» pageNum|body|integer| yes ||none| +|» pageSize|body|integer| yes ||最大10000| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/网元数据模块/SMSC + +## GET SMSC-CDR会话事件列表 + +GET /neData/smsc/cdr/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型, 暂时支持SMSC| +|neId|query|string| yes ||网元ID| +|recordType|query|string| no ||记录行为 MOSM MTSM| +|startTime|query|string| no ||开始时间 毫秒| +|endTime|query|string| no ||结束时间 毫秒| +|sortField|query|string| no ||排序字段，填写结果字段| +|sortOrder|query|string| no ||排序升降序，asc desc| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{ + "code": 0, + "msg": "string", + "rows": [ + { + "id": "string", + "neType": "string", + "neName": "string", + "rmUID": "string", + "timestamp": 0, + "cdrJSON": "string", + "createdAt": "string" + } + ], + "total": 0 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» neName|string|true|none||none| +|»» rmUID|string|true|none||none| +|»» timestamp|integer|true|none||none| +|»» cdrJSON|string|true|none||none| +|»» createdAt|string|true|none||none| +|» total|integer|true|none||none| + +## DELETE SMSC-CDR会话删除 + +DELETE /neData/smsc/cdr/{cdrIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|cdrIds|path|string| yes ||多个逗号分割| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "Deleted successfully: 1" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## POST SMSC-CDR会话列表导出 + +POST /neData/smsc/cdr/export + +> Body Parameters + +```json +{ + "neType": "SMSC", + "neId": "001", + "recordType": "MOSM,MTSM", + "callerParty": "", + "calledParty": "", + "startTime": "", + "endTime": "", + "sortField": "timestamp", + "sortOrder": "desc", + "pageNum": 1, + "pageSize": 100 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型, 暂时支持SMSC| +|» neId|body|string| yes ||none| +|» recordType|body|string| no ||记录行为 MOSM MTSM| +|» callerParty|body|string| no ||主叫号码| +|» calledParty|body|string| yes ||被叫号码| +|» startTime|body|string| no ||none| +|» endTime|body|string| no ||none| +|» sortField|body|string| yes ||排序字段 timestamp| +|» sortOrder|body|string| yes ||排序升降序，asc desc| +|» pageNum|body|integer| yes ||none| +|» pageSize|body|integer| yes ||最大10000| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/网元数据模块/SMF + +## GET SMF-CDR会话事件列表 + +GET /neData/smf/cdr/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型, 暂时支持SMF| +|neId|query|string| yes ||网元ID| +|subscriberID|query|string| no ||用户 IMSI| +|startTime|query|string| no ||开始时间| +|endTime|query|string| no ||结束时间| +|sortField|query|string| no ||排序字段，填写结果字段| +|sortOrder|query|string| no ||排序升降序，asc desc| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "763", + "neType": "IMS", + "neName": "IMS_001", + "rmUID": "4400HX1IMS001", + "timestamp": 1706863363, + "cdrJSON": "{\"answerTime\":1706863363,\"callDuration\":391,\"callReference\":\"18656735160@10.25.0.210\",\"callType\":\"video\",\"calledParty\":\"18178166630\",\"callerParty\":\"13162346412\",\"cause\":200,\"fwdParty\":\"7999\",\"fwdType\":\"CFB\",\"recordType\":\"MTC\",\"releaseTime\":1706863363,\"seizureTime\":1706863363,\"seqNumber\":81,\"serviceResult\":\"ok\"}", + "createdAt": "2024-02-02T16:42:43+08:00" + }, + { + "id": "764", + "neType": "IMS", + "neName": "IMS_001", + "rmUID": "4400HX1IMS001", + "timestamp": 1706863363, + "cdrJSON": "{\"answerTime\":1706863363,\"callDuration\":707,\"callReference\":\"18112767515@10.25.0.210\",\"callType\":\"audio\",\"calledParty\":\"18175529792\",\"callerParty\":\"13953612934\",\"cause\":200,\"fwdParty\":\"7999\",\"fwdType\":\"CFB\",\"recordType\":\"MTC\",\"releaseTime\":1706863363,\"seizureTime\":1706863363,\"seqNumber\":81,\"serviceResult\":\"ok\"}", + "createdAt": "2024-02-02T16:42:43+08:00" + } + ], + "total": 8428 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» neName|string|true|none||none| +|»» rmUID|string|true|none||none| +|»» timestamp|integer|true|none||none| +|»» cdrJSON|string|true|none||none| +|»» createdAt|string|true|none||none| +|» total|integer|true|none||none| + +## GET SMF-在线订阅用户列表信息 + +GET /neData/smf/subscribers + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|query|string| yes ||网元ID| +|imsi|query|string| no ||用户 IMSI| +|msisdn|query|string| no ||MSISDN| +|upstate|query|string| no ||状态 Inactive Active| +|pageNum|query|integer| no ||页数| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{ + "code": 0, + "msg": "string", + "rows": [ + { + "imsi": "string", + "msisdn": "string", + "pduSessionInfo": [ + { + "activeTime": "string", + "dnn": "string", + "ipv4": "string", + "ipv6": "string", + "pduSessionID": 0, + "ranN3IP": "string", + "sstSD": "string", + "tai": "string", + "upState": "string", + "upfN3IP": "string" + } + ], + "ratType": "string" + } + ], + "total": 0 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» imsi|string|true|none||none| +|»» msisdn|string|true|none||none| +|»» pduSessionInfo|[object]|true|none||none| +|»»» activeTime|string|true|none||none| +|»»» dnn|string|true|none||none| +|»»» ipv4|string|true|none||none| +|»»» ipv6|string|true|none||none| +|»»» pduSessionID|integer|true|none||none| +|»»» ranN3IP|string|true|none||none| +|»»» sstSD|string|true|none||none| +|»»» tai|string|true|none||none| +|»»» upState|string|true|none||none| +|»»» upfN3IP|string|true|none||none| +|»» ratType|string|true|none||none| +|» total|integer|true|none||none| + +## DELETE SMF-CDR会话删除 + +DELETE /neData/smf/cdr/{cdrIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|cdrIds|path|string| yes ||多个逗号分割| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "Deleted successfully: 1" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## POST SMF-CDR会话列表导出 + +POST /neData/smf/cdr/export + +> Body Parameters + +```json +{ + "neType": "SMF", + "neId": "001", + "subscriberID": "", + "startTime": "", + "endTime": "", + "sortField": "timestamp", + "sortOrder": "desc", + "pageNum": 1, + "pageSize": 100 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型, 暂时支持SMF| +|» neId|body|string| yes ||网元ID| +|» subscriberID|body|string| no ||用户 IMSI| +|» startTime|body|string| no ||开始时间 ms| +|» endTime|body|string| no ||结束时间 ms| +|» sortField|body|string| yes ||排序字段 timestamp| +|» sortOrder|body|string| yes ||排序升降序，asc desc| +|» pageNum|body|integer| yes ||none| +|» pageSize|body|integer| yes ||最大10000| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/网元数据模块/AMF + +## GET AMF-UE会话事件列表 + +GET /neData/amf/ue/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型, 暂时支持AMF| +|neId|query|string| yes ||网元ID| +|startTime|query|string| no ||开始时间 毫秒| +|endTime|query|string| no ||结束时间 毫秒| +|sortField|query|string| no ||排序字段，填写结果字段| +|sortOrder|query|string| no ||排序升降序，asc desc| +|eventType|query|string| no ||事件类型 auth-result detach cm-state| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{ + "code": 0, + "msg": "string", + "rows": [ + { + "id": "string", + "neType": "string", + "neName": "string", + "rmUID": "string", + "timestamp": 0, + "eventType": "string", + "eventJSON": "string", + "createdAt": "string" + } + ], + "total": 0 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» neName|string|true|none||none| +|»» rmUID|string|true|none||none| +|»» timestamp|integer|true|none||none| +|»» eventType|string|true|none||none| +|»» eventJSON|string|true|none||none| +|»» createdAt|string|true|none||none| +|» total|integer|true|none||none| + +## DELETE AMF-UE会话删除 + +DELETE /neData/amf/ue/{ueIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|ueIds|path|string| yes ||多个逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "Deleted successfully: 1" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## POST AMF-UE会话列表导出 + +POST /neData/amf/ue/export + +> Body Parameters + +```json +{ + "neType": "AMF", + "neId": "001", + "eventType": "auth-result", + "imsi": "", + "startTime": "", + "endTime": "", + "sortField": "timestamp", + "sortOrder": "desc", + "pageNum": 1, + "pageSize": 100 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型, 暂时支持AMF| +|» neId|body|string| yes ||none| +|» eventType|body|string| no ||事件类型 auth-result detach cm-state| +|» imsi|body|string| no ||none| +|» startTime|body|string| no ||none| +|» endTime|body|string| no ||none| +|» sortField|body|string| yes ||排序字段 timestamp| +|» sortOrder|body|string| yes ||排序升降序，asc desc| +|» pageNum|body|integer| yes ||none| +|» pageSize|body|integer| yes ||最大10000| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/网元数据模块/UPF + +## GET UPF-总流量数 N3上行 N6下行 + +GET /neData/upf/totalFlow + +单位 比特(bit) + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|query|string| yes ||网元ID| +|day|query|integer| yes ||当前时间往前的天数| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "down": null, + "up": null + }, + "msg": "success" +} +``` + +```json +{ + "code": 1, + "data": { + "down": "163341243876", + "up": "223155839712" + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» down|string|true|none||none| +|»» up|string|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/网元数据模块/UDM鉴权用户 + +## GET UDM鉴权用户列表 + +GET /neData/udm/auth/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|query|string| no ||none| +|imsi|query|string| no ||none| +|sortField|query|string| no ||排序字段| +|sortOrder|query|string| no ||排序方式 desc asc| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "1", + "imsi": "", + "amf": "8000", + "status": "1", + "ki": "339c8cfe19cae8dfe094dd159fe56192b95374ba8ddff8c2", + "algoIndex": "0", + "opc": "-", + "neId": "" + }, + { + "id": "2", + "imsi": "", + "amf": "8000", + "status": "1", + "ki": "339c8cfe19cae8dfe094dd159fe56192b95374ba8ddff8c2", + "algoIndex": "0", + "opc": "-", + "neId": "" + }, + { + "id": "3", + "imsi": "", + "amf": "8000", + "status": "1", + "ki": "339c8cfe19cae8dfe094dd159fe56192b95374ba8ddff8c2", + "algoIndex": "0", + "opc": "-", + "neId": "" + }, + { + "id": "4", + "imsi": "", + "amf": "8000", + "status": "1", + "ki": "339c8cfe19cae8dfe094dd159fe56192b95374ba8ddff8c2", + "algoIndex": "0", + "opc": "-", + "neId": "" + }, + { + "id": "5", + "imsi": "", + "amf": "8000", + "status": "1", + "ki": "339c8cfe19cae8dfe094dd159fe56192b95374ba8ddff8c2", + "algoIndex": "0", + "opc": "-", + "neId": "" + }, + { + "id": "6", + "imsi": "", + "amf": "8000", + "status": "1", + "ki": "339c8cfe19cae8dfe094dd159fe56192b95374ba8ddff8c2", + "algoIndex": "0", + "opc": "-", + "neId": "" + }, + { + "id": "7", + "imsi": "", + "amf": "8000", + "status": "1", + "ki": "339c8cfe19cae8dfe094dd159fe56192b95374ba8ddff8c2", + "algoIndex": "0", + "opc": "-", + "neId": "" + }, + { + "id": "8", + "imsi": "", + "amf": "8000", + "status": "1", + "ki": "339c8cfe19cae8dfe094dd159fe56192b95374ba8ddff8c2", + "algoIndex": "0", + "opc": "-", + "neId": "" + }, + { + "id": "9", + "imsi": "", + "amf": "8000", + "status": "1", + "ki": "339c8cfe19cae8dfe094dd159fe56192b95374ba8ddff8c2", + "algoIndex": "0", + "opc": "-", + "neId": "" + }, + { + "id": "10", + "imsi": "", + "amf": "8000", + "status": "1", + "ki": "339c8cfe19cae8dfe094dd159fe56192b95374ba8ddff8c2", + "algoIndex": "0", + "opc": "-", + "neId": "" + } + ], + "total": 16046 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|true|none||none| +|»» imsi|string|true|none||none| +|»» amf|string|true|none||none| +|»» status|string|true|none||none| +|»» ki|string|true|none||none| +|»» algoIndex|string|true|none||none| +|»» opc|string|true|none||none| +|»» neId|string|true|none||none| +|» total|integer|true|none||none| + +## GET UDM鉴权用户信息 + +GET /neData/udm/auth/{neId}/{imsi} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||网元ID| +|imsi|path|string| yes ||IMSI| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|AccessToken|header|string| no ||Access token| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "id": "3", + "imsi": "460000100014002", + "amf": "8000", + "status": "1", + "ki": "805dadc6e8a54a0d59d622c7a04d08e0", + "algoIndex": "0", + "opc": "-", + "neId": "" + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» id|string|true|none||none| +|»» imsi|string|true|none||none| +|»» amf|string|true|none||none| +|»» status|string|true|none||none| +|»» ki|string|true|none||none| +|»» algoIndex|string|true|none||none| +|»» opc|string|true|none||none| +|»» neId|string|true|none||none| +|» msg|string|true|none||none| + +## DELETE UDM鉴权用户删除 + +DELETE /neData/udm/auth/{neId}/{imsi} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||网元ID| +|imsi|path|string| yes ||多个用英文逗号分割 1,2| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "460000100000030": "command ok", + "460000100000031": "command ok" + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|integer|true|none||none| + +## PUT UDM鉴权用户重载数据 + +PUT /neData/udm/auth/resetData/{neId} + +清空数据库后重新从Redis加载到数据库，批量3000条同时操作。 +请检查配置的udmuser链接是否正确同步 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": 16046, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|integer|true|none||none| +|» msg|string|true|none||none| + +## POST UDM鉴权用户新增 + +POST /neData/udm/auth/{neId} + +> Body Parameters + +```json +{ + "algoIndex": "0", + "amf": "8000", + "imsi": "160000100000032", + "ki": "805DADC6E8A54A0D59D622C7A04D08E0", + "opc": "CF7FD414E05754CFE08B4FE7F2EF2A36" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» algoIndex|body|string| yes ||none| +|» amf|body|string| yes ||none| +|» imsi|body|string| yes ||none| +|» ki|body|string| yes ||none| +|» opc|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "data": "command ok", + "msg": "success" +} +``` + +```json +{ + "code": 0, + "msg": "add fail: already exist" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## PUT UDM鉴权用户修改 + +PUT /neData/udm/auth/{neId} + +> Body Parameters + +```json +{ + "algoIndex": "0", + "amf": "9090", + "imsi": "460000100000030", + "ki": "805DADC6E8A54A0D59D622C7A04D08E0", + "opc": "CF7FD414E05754CFE08B4FE7F2EF2A36" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||网元ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» algoIndex|body|string| yes ||none| +|» amf|body|string| yes ||none| +|» imsi|body|string| yes ||none| +|» ki|body|string| yes ||none| +|» opc|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "data": "command ok", + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|integer|true|none||none| + +## POST UDM鉴权用户批量新增 + +POST /neData/udm/auth/{neId}/{num} + +> Body Parameters + +```json +{ + "algoIndex": "0", + "amf": "8000", + "imsi": "460000100000030", + "ki": "805DADC6E8A54A0D59D622C7A04D08E0", + "opc": "CF7FD414E05754CFE08B4FE7F2EF2A36" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||网元ID| +|num|path|string| yes ||放号数，数量减去当前imsi| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» algoIndex|body|string| yes ||none| +|» amf|body|string| yes ||none| +|» imsi|body|string| yes ||none| +|» ki|body|string| yes ||none| +|» opc|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 1, + "data": "command ok", + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## DELETE UDM鉴权用户批量删除 + +DELETE /neData/udm/auth/{neId}/{imsi}/{num} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||网元ID| +|imsi|path|string| yes ||none| +|num|path|string| yes ||放号数，数量包含当前imsi| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": 2021, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|integer|true|none||none| + +## POST UDM鉴权用户导出 + +POST /neData/udm/auth/export + +> Body Parameters + +```json +{ + "neId": "001", + "type": "csv" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neId|body|string| yes ||none| +|» type|body|string| yes | csv txt|支持txt和csv文件| + +> Response Examples + +> 200 Response + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|integer|true|none||none| + +## POST UDM鉴权用户导入 + +POST /neData/udm/auth/import + +> Body Parameters + +```json +{ + "neId": "001", + "uploadPath": "/upload/import/2024/06/omc_auth_user_export__1718260762715_634hcv.txt" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neId|body|string| yes ||网元ID| +|» uploadPath|body|string| yes ||通过上传接口得到文件路径| + +> Response Examples + +```json +{ + "code": 1, + "msg": "import ok, succ num: 36891, fail num: 1092." +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/网元数据模块/UDM签约用户 + +## GET UDM签约用户信息 + +GET /neData/udm/sub/{neId}/{imsi} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||网元ID| +|imsi|path|string| yes ||IMSI| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "id": "3", + "msisdn": "8612307550990", + "imsi": "460000100000030", + "ambr": "def_ambr", + "nssai": "def_nssai", + "rat": "0", + "arfb": "def_arfb", + "sar": "def_sar", + "cn": "3", + "smData": "1-000001&cmnet&ims", + "smfSel": "def_snssai", + "epsDat": "1,64,24,65,def_eps,1,2,010200000000,-", + "neId": "", + "epsFlag": "1", + "epsOdb": "64", + "hplmnOdb": "24", + "ard": "65", + "epstpl": "def_eps", + "contextId": "1", + "apnContext": "010200000000", + "staticIp": "-" + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|object|true|none||none| +|»» id|string|true|none||none| +|»» msisdn|string|true|none||none| +|»» imsi|string|true|none||none| +|»» ambr|string|true|none||none| +|»» nssai|string|true|none||none| +|»» rat|string|true|none||none| +|»» arfb|string|true|none||none| +|»» sar|string|true|none||none| +|»» cn|string|true|none||none| +|»» smData|string|true|none||none| +|»» smfSel|string|true|none||none| +|»» epsDat|string|true|none||none| +|»» neId|string|true|none||none| +|»» epsFlag|string|true|none||none| +|»» epsOdb|string|true|none||none| +|»» hplmnOdb|string|true|none||none| +|»» ard|string|true|none||none| +|»» epstpl|string|true|none||none| +|»» contextId|string|true|none||none| +|»» apnContext|string|true|none||none| +|»» staticIp|string|true|none||none| +|» msg|string|true|none||none| + +## DELETE UDM签约用户删除 + +DELETE /neData/udm/sub/{neId}/{imsi} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||网元ID| +|imsi|path|string| yes ||多个用英文逗号分割 1,2| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": { + "460000100000030": "command ok", + "460000100000031": "command ok" + }, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|integer|true|none||none| + +## POST UDM签约用户新增 + +POST /neData/udm/sub/{neId} + +此命令可同时添加45G签约用户 + +> Body Parameters + +```json +{ + "msisdn": "8612307550990", + "imsi": "460000100000030", + "ambr": "def_ambr", + "nssai": "def_nssai", + "rat": "0", + "arfb": "def_arfb", + "sar": "def_sar", + "cn": "3", + "smData": "1-000001&cmnet&ims", + "smfSel": "def_snssai", + "epsDat": "64", + "epsFlag": "1", + "epsOdb": "64", + "hplmnOdb": "24", + "ard": "65", + "epstpl": "def_eps", + "contextId": "1", + "apnContext": "010200000000", + "staticIp": "201.32.49.134" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||网元ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|AccessToken|header|string| no ||Access token| +|body|body|object| no ||none| +|» msisdn|body|string| yes ||none| +|» imsi|body|string| yes ||none| +|» ambr|body|string| yes ||none| +|» nssai|body|string| yes ||none| +|» rat|body|string| yes ||none| +|» arfb|body|string| yes ||none| +|» sar|body|string| yes ||none| +|» cn|body|string| yes ||none| +|» smData|body|string| yes ||none| +|» smfSel|body|string| yes ||none| +|» epsDat|body|string| yes ||none| +|» epsFlag|body|string| yes ||none| +|» epsOdb|body|string| yes ||none| +|» hplmnOdb|body|string| yes ||none| +|» ard|body|string| yes ||none| +|» epstpl|body|string| yes ||none| +|» contextId|body|string| yes ||none| +|» apnContext|body|string| yes ||none| +|» staticIp|body|string| yes ||static_ip指给4G UE分配的静态IP，没有可不带此字段名| + +> Response Examples + +```json +{ + "code": 1, + "data": "command ok", + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## PUT UDM签约用户修改 + +PUT /neData/udm/sub/{neId} + +> Body Parameters + +```json +{ + "msisdn": "8612307550990", + "imsi": "460000100000030", + "ambr": "def_ambr", + "nssai": "def_nssai", + "rat": "0", + "arfb": "def_arfb", + "sar": "def_sar", + "cn": "3", + "smData": "1-000001&cmnet&ims", + "smfSel": "def_snssai", + "epsDat": "64", + "epsFlag": "1", + "epsOdb": "64", + "hplmnOdb": "24", + "ard": "65", + "epstpl": "def_eps", + "contextId": "1", + "apnContext": "010200000000", + "staticIp": "185.62.45.170" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||none| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» msisdn|body|string| yes ||none| +|» imsi|body|string| yes ||none| +|» ambr|body|string| yes ||none| +|» nssai|body|string| yes ||none| +|» rat|body|string| yes ||none| +|» arfb|body|string| yes ||none| +|» sar|body|string| yes ||none| +|» cn|body|string| yes ||none| +|» smData|body|string| yes ||none| +|» smfSel|body|string| yes ||none| +|» epsDat|body|string| yes ||none| +|» epsFlag|body|string| yes ||none| +|» epsOdb|body|string| yes ||none| +|» hplmnOdb|body|string| yes ||none| +|» ard|body|string| yes ||none| +|» epstpl|body|string| yes ||none| +|» contextId|body|string| yes ||none| +|» apnContext|body|string| yes ||none| +|» staticIp|body|string| yes ||static_ip指给4G UE分配的静态IP，没有可不带此字段名| + +> Response Examples + +```json +{ + "code": 1, + "data": "command ok", + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|integer|true|none||none| + +## POST UDM签约用户批量新增 + +POST /neData/udm/sub/{neId}/{num} + +> Body Parameters + +```json +{ + "msisdn": "8612307550990", + "imsi": "460000100000030", + "ambr": "def_ambr", + "nssai": "def_nssai", + "rat": "0", + "arfb": "def_arfb", + "sar": "def_sar", + "cn": "3", + "smData": "1-000001&cmnet&ims", + "smfSel": "def_snssai", + "epsDat": "64", + "epsFlag": "1", + "epsOdb": "64", + "hplmnOdb": "24", + "ard": "65", + "epstpl": "def_eps", + "contextId": "1", + "apnContext": "010200000000", + "staticIp": "" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||none| +|num|path|string| yes ||放号数，包含当前imsi| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» msisdn|body|string| yes ||none| +|» imsi|body|string| yes ||none| +|» ambr|body|string| yes ||none| +|» nssai|body|string| yes ||none| +|» rat|body|string| yes ||none| +|» arfb|body|string| yes ||none| +|» sar|body|string| yes ||none| +|» cn|body|string| yes ||none| +|» smData|body|string| yes ||none| +|» smfSel|body|string| yes ||none| +|» epsDat|body|string| yes ||none| +|» epsFlag|body|string| yes ||none| +|» epsOdb|body|string| yes ||none| +|» hplmnOdb|body|string| yes ||none| +|» ard|body|string| yes ||none| +|» epstpl|body|string| yes ||none| +|» contextId|body|string| yes ||none| +|» apnContext|body|string| yes ||none| +|» staticIp|body|string| no ||static_ip指给4G UE分配的静态IP，没有可不带此字段名| + +> Response Examples + +```json +{ + "code": 1, + "data": "command ok", + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|integer|true|none||none| + +## DELETE UDM签约用户批量删除 + +DELETE /neData/udm/sub/{neId}/{imsi}/{num} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||none| +|imsi|path|string| yes ||imsi| +|num|path|string| yes ||数量包含当前imsi| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": "command ok", + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» data|string|true|none||none| +|» msg|string|true|none||none| + +## POST UDM签约用户导出 + +POST /neData/udm/sub/export + +> Body Parameters + +```json +{ + "neId": "001", + "type": "txt" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neId|body|string| yes ||none| +|» type|body|string| yes | csv txt|支持txt和csv文件| + +> Response Examples + +> 200 Response + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|integer|true|none||none| + +## PUT UDM签约用户重载数据 + +PUT /neData/udm/sub/resetData/{neId} + +清空数据库后重新从Redis加载到数据库，批量2000条同时操作。 +请检查配置的udmuser链接是否正确同步 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neId|path|string| yes ||网元ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "data": 6, + "msg": "success" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[object]|true|none|路由数组|none| +|»» name|string|true|none|路由名称|none| +|»» path|string|true|none|路由地址|none| +|»» component|string|true|none|组件|- BasicLayout-基础布局组件标识 菜单类型-菜单D
- BlankLayout-空白布局组件标识 菜单类型-菜单M
- LinkLayout-内链接布局组件标识 菜单类型-菜单M
- 按钮菜单类型-菜单B 不会读取到路由中| +|»» meta|object|true|none|元数据|none| +|»»» icon|string|true|none|菜单图标|none| +|»»» title|string|true|none|菜单标题|none| +|»»» hide|boolean|true|none|是否隐藏|默认 false| +|»»» cache|boolean|true|none|是否缓存|默认 false| +|»»» target|string¦null|true|none|链接行为|- 非链接 null
- 内部跳转 _self
- 外部跳转 _blank| +|»» redirect|string|false|none|目录重定向|none| +|»» children|[object]|false|none|子菜单|none| +|»»» name|string|true|none||none| +|»»» path|string|true|none||none| +|»»» component|string|true|none||none| +|»»» meta|object|true|none|元数据|none| +|»»»» icon|string|true|none||none| +|»»»» title|string|true|none|标题|none| +|»»»» hide|boolean|true|none||none| +|»»»» cache|boolean|true|none||none| +|»»»» target|string¦null|true|none||none| + +## POST UDM签约用户导入 + +POST /neData/udm/sub/import + +> Body Parameters + +```json +{ + "neId": "001", + "uploadPath": "/upload/import/2024/06/udm_sub_user_export__1718268308315_g4owx5.txt" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neId|body|string| yes ||网元ID| +|» uploadPath|body|string| yes ||通过上传接口得到文件路径| + +> Response Examples + +```json +{ + "code": 1, + "msg": "import ok, succ num: 3, fail num: 0." +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|integer|true|none||none| + +## GET UDM签约用户列表 + +GET /neData/udm/sub/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|msisdn|query|string| no ||none| +|imsi|query|string| no ||none| +|neId|query|string| no ||none| +|sortField|query|string| no ||排序字段| +|sortOrder|query|string| no ||排序方式 desc asc| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "success", + "rows": [ + { + "id": "3", + "msisdn": "8612307550990", + "imsi": "460000100000030", + "ambr": "def_ambr", + "nssai": "def_nssai", + "rat": "0", + "arfb": "def_arfb", + "sar": "def_sar", + "cn": "3", + "smData": "1-000001&cmnet&ims", + "smfSel": "def_snssai", + "epsDat": "1,64,24,65,def_eps,1,2,010200000000,-", + "neId": "", + "epsFlag": "1", + "epsOdb": "64", + "hplmnOdb": "24", + "ard": "65", + "epstpl": "def_eps", + "contextId": "1", + "apnContext": "010200000000", + "staticIp": "-" + } + ], + "total": 1 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|true|none||none| +|»» msisdn|string|true|none||none| +|»» imsi|string|true|none||none| +|»» ambr|string|true|none||none| +|»» nssai|string|true|none||none| +|»» rat|string|true|none||none| +|»» arfb|string|true|none||none| +|»» sar|string|true|none||none| +|»» cn|string|true|none||none| +|»» smData|string|true|none||none| +|»» smfSel|string|true|none||none| +|»» epsDat|string|true|none||none| +|»» neId|string|true|none||none| +|»» epsFlag|string|true|none||none| +|»» epsOdb|string|true|none||none| +|»» hplmnOdb|string|true|none||none| +|»» ard|string|true|none||none| +|»» epstpl|string|true|none||none| +|»» contextId|string|true|none||none| +|»» apnContext|string|true|none||none| +|»» staticIp|string|true|none||none| +|» total|integer|true|none||none| + +# 中文src目录接口/网元数据模块/MME + +## GET MME-UE会话事件列表 + +GET /neData/mme/ue/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|neType|query|string| yes ||网元类型, 暂时支持MME| +|neId|query|string| yes ||网元ID| +|startTime|query|string| no ||开始时间 毫秒| +|endTime|query|string| no ||结束时间 毫秒| +|sortField|query|string| no ||排序字段，填写结果字段| +|sortOrder|query|string| no ||排序升降序，asc desc| +|eventType|query|string| no ||事件类型 ECM STATUS, EMM STATUS| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{ + "code": 0, + "msg": "string", + "rows": [ + { + "id": "string", + "neType": "string", + "neName": "string", + "rmUID": "string", + "timestamp": 0, + "eventType": "string", + "eventJSON": "string", + "createdAt": "string" + } + ], + "total": 0 +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» rows|[object]|true|none||none| +|»» id|string|true|none||none| +|»» neType|string|true|none||none| +|»» neName|string|true|none||none| +|»» rmUID|string|true|none||none| +|»» timestamp|integer|true|none||none| +|»» eventType|string|true|none||none| +|»» eventJSON|string|true|none||none| +|»» createdAt|string|true|none||none| +|» total|integer|true|none||none| + +## DELETE MME-UE会话删除 + +DELETE /neData/mme/ue/{ueIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|ueIds|path|string| yes ||多个逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 1, + "msg": "Deleted successfully: 1" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## POST MME-UE会话列表导出 + +POST /neData/mme/ue/export + +> Body Parameters + +```json +{ + "neType": "MME", + "neId": "001", + "eventType": "", + "imsi": "", + "startTime": "", + "endTime": "", + "sortField": "timestamp", + "sortOrder": "desc", + "pageNum": 1, + "pageSize": 100 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» neType|body|string| yes ||网元类型, 暂时支持MME| +|» neId|body|string| yes ||none| +|» eventType|body|string| no ||事件类型 ECM STATUS, EMM STATUS| +|» imsi|body|string| no ||none| +|» startTime|body|string| no ||none| +|» endTime|body|string| no ||none| +|» sortField|body|string| yes ||排序字段 timestamp| +|» sortOrder|body|string| yes ||排序升降序，asc desc| +|» pageNum|body|integer| yes ||none| +|» pageSize|body|integer| yes ||最大10000| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# 中文src目录接口/系统模块/参数配置信息 + +## GET 参数配置列表 + +GET /system/config/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|configName|query|string| no ||参数名称| +|configKey|query|string| no ||参数键名| +|configType|query|string| no ||系统内置-是Y 否N| +|beginTime|query|string| no ||创建时间-开始| +|endTime|query|string| no ||创建时间-结束| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 4, + "rows": [ + { + "configId": 1, + "configName": "用户管理-账号初始密码", + "configKey": "sys.user.initPassword", + "configValue": "123456", + "configType": "Y", + "createBy": "maskAdmin", + "createTime": "1682264527266", + "updateBy": "", + "updateTime": "0", + "remark": "导入用户初始化密码 123456" + }, + { + "configId": 2, + "configName": "账号自助-验证码开关", + "configKey": "sys.account.captchaEnabled", + "configValue": "true", + "configType": "Y", + "createBy": "maskAdmin", + "createTime": "1682264527271", + "updateBy": "", + "updateTime": "0", + "remark": "是否开启验证码功能（true开启，false关闭）" + }, + { + "configId": 3, + "configName": "账号自助-验证码类型", + "configKey": "sys.account.captchaType", + "configValue": "math", + "configType": "Y", + "createBy": "maskAdmin", + "createTime": "1682264527277", + "updateBy": "", + "updateTime": "0", + "remark": "使用验证码类型（math数值计算，char字符验证）" + }, + { + "configId": 4, + "configName": "账号自助-是否开启用户注册功能", + "configKey": "sys.account.registerUser", + "configValue": "true", + "configType": "Y", + "createBy": "maskAdmin", + "createTime": "1682264527280", + "updateBy": "maskAdmin", + "updateTime": "1683291796123", + "remark": "是否开启注册用户功能（true开启，false关闭）" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» configId|integer|true|none|配置ID|none| +|»» configName|string|true|none|配置名称|none| +|»» configKey|string|true|none|参数键名|none| +|»» configValue|string|true|none|配置值|none| +|»» configType|string|true|none|系统内置|Y是 N否| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none||none| +|»» updateBy|string|true|none||none| +|»» updateTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## POST 参数配置列表导出 + +POST /system/config/export + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=config_export_10_1684131509100.xlsx +content-length: 18337 +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +> Body Parameters + +```json +{ + "configName": "string", + "configKey": "string", + "beginTime": "string", + "endTime": "string", + "pageNum": 0, + "pageSize": 0 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» configName|body|string| no | 参数名称|none| +|» configKey|body|string| no | 参数键名|none| +|» beginTime|body|string| no | 创建开始时间|none| +|» endTime|body|string| no | 创建结束时间|none| +|» pageNum|body|number| yes | 页数，默认1|none| +|» pageSize|body|number| yes | 单页记录数，默认10|none| + +> Response Examples + +```json +{ + "code": 500, + "msg": "导出数据记录为空" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 根据参数键名取值 + +GET /system/config/configKey/{configKey} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|configKey|path|string| yes ||参数键名| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": "true" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|string|true|none|配置值|none| + +## GET 参数配置信息 + +GET /system/config/{configId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|configId|path|string| yes ||配置ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "configId": 4, + "configName": "账号自助-是否开启用户注册功能", + "configKey": "sys.account.registerUser", + "configValue": "true", + "configType": "Y", + "createBy": "maskAdmin", + "createTime": "1682264527280", + "updateBy": "maskAdmin", + "updateTime": "1683291796123", + "remark": "是否开启注册用户功能（true开启，false关闭）" + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object¦null|true|none||none| +|»» configId|integer|true|none|配置ID|none| +|»» configName|string|true|none|配置名称|none| +|»» configKey|string|true|none|参数键名|none| +|»» configValue|string|true|none|配置值|none| +|»» configType|string|true|none|系统内置|Y是 N否| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none||none| +|»» updateBy|string|true|none||none| +|»» updateTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## POST 参数配置新增 + +POST /system/config + +> Body Parameters + +```json +{ + "configName": "string", + "configKey": "string", + "configValue": "string", + "configType": "string", + "remark": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» configName|body|string| yes | 配置名称|none| +|» configKey|body|string| yes | 参数键名|none| +|» configValue|body|string| yes | 配置值|none| +|» configType|body|string| yes | 系统内置|Y是 N否| +|» remark|body|string| yes | 备注|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "参数配置新增【xxxx】失败，参数键名已存在" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 参数配置修改 + +PUT /system/config + +> Body Parameters + +```json +{ + "configName": "string", + "configKey": "string", + "configValue": "string", + "configType": "string", + "remark": "string", + "configId": 0 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» configName|body|string| yes | 配置名称|none| +|» configKey|body|string| yes | 参数键名|none| +|» configValue|body|string| yes | 配置值|none| +|» configType|body|string| yes | 系统内置|Y是 N否| +|» remark|body|string| yes | 备注|none| +|» configId|body|integer| yes | 配置ID|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问参数配置数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 根据参数键名改值 + +PUT /system/config/changeValue + +> Body Parameters + +```json +{ + "key": "sys.logo.filePathIcon", + "value": "核心网" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» key|body|string| yes ||none| +|» value|body|string| yes ||none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "参数配置新增【xxxx】失败，参数键名已存在" +} +``` + +```json +{ + "code": 1, + "msg": "success" +} +``` + +```json +{ + "code": 0, + "msg": "变更状态与旧值相等！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 参数配置删除 + +DELETE /system/config/{configIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|configIds|path|string| yes ||配置ID，多个用英文逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "内置参数 xxx 不能删除" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 参数缓存刷新 + +PUT /system/config/refreshCache + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/系统模块/部门信息 + +## GET 部门列表 + +GET /system/dept/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|status|query|string| no ||状态（0正常 1停用）| +|deptName|query|string| no ||部门名称| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [ + { + "deptId": "100", + "parentId": "0", + "ancestors": "0", + "deptName": "MASK科技", + "orderNum": 0, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526241" + }, + { + "deptId": "101", + "parentId": "100", + "ancestors": "0,100", + "deptName": "广西总公司", + "orderNum": 1, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526245" + }, + { + "deptId": "102", + "parentId": "100", + "ancestors": "0,100", + "deptName": "广东分公司", + "orderNum": 2, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526248" + }, + { + "deptId": "103", + "parentId": "101", + "ancestors": "0,100,101", + "deptName": "研发部门", + "orderNum": 1, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526251" + }, + { + "deptId": "104", + "parentId": "101", + "ancestors": "0,100,101", + "deptName": "市场部门", + "orderNum": 2, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526254" + }, + { + "deptId": "105", + "parentId": "101", + "ancestors": "0,100,101", + "deptName": "测试部门", + "orderNum": 3, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526257" + }, + { + "deptId": "106", + "parentId": "101", + "ancestors": "0,100,101", + "deptName": "财务部门", + "orderNum": 4, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526261" + }, + { + "deptId": "107", + "parentId": "101", + "ancestors": "0,100,101", + "deptName": "运维部门", + "orderNum": 5, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526264" + }, + { + "deptId": "108", + "parentId": "102", + "ancestors": "0,100,102", + "deptName": "市场部门", + "orderNum": 1, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526268" + }, + { + "deptId": "109", + "parentId": "102", + "ancestors": "0,100,102", + "deptName": "财务部门", + "orderNum": 2, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526271" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[object]|true|none||none| +|»» deptId|string|true|none|部门ID|none| +|»» parentId|string|true|none|父部门ID|none| +|»» ancestors|string|true|none|祖级列表|none| +|»» deptName|string|true|none|部门名称|none| +|»» orderNum|integer|true|none|显示顺序|none| +|»» leader|string|true|none|负责人|none| +|»» phone|string|true|none|联系电话|none| +|»» email|string|true|none|邮箱|none| +|»» status|string|true|none|部门状态|0正常 1停用| +|»» delFlag|string|true|none|删除标志|0代表存在 1代表删除| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none||none| + +## GET 部门列表（排除节点） + +GET /system/dept/list/exclude/{deptId} + +进行更新操作时，可选的上级应排除当前部门下的所有节点 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|deptId|path|string| yes ||部门编号| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [ + { + "deptId": "100", + "parentId": "0", + "ancestors": "0", + "deptName": "MASK科技", + "orderNum": 0, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526241" + }, + { + "deptId": "102", + "parentId": "100", + "ancestors": "0,100", + "deptName": "广东分公司", + "orderNum": 2, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526248" + }, + { + "deptId": "108", + "parentId": "102", + "ancestors": "0,100,102", + "deptName": "市场部门", + "orderNum": 1, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526268" + }, + { + "deptId": "109", + "parentId": "102", + "ancestors": "0,100,102", + "deptName": "财务部门", + "orderNum": 2, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "delFlag": "0", + "createBy": "maskAdmin", + "createTime": "1682264526271" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[object]|true|none||none| +|»» deptId|string|true|none|部门ID|none| +|»» parentId|string|true|none|父部门ID|none| +|»» ancestors|string|true|none|祖级列表|none| +|»» deptName|string|true|none|部门名称|none| +|»» orderNum|integer|true|none|显示顺序|none| +|»» leader|string|true|none|负责人|none| +|»» phone|string|true|none|联系电话|none| +|»» email|string|true|none|邮箱|none| +|»» status|string|true|none|部门状态|0正常 1停用| +|»» delFlag|string|true|none|删除标志|0代表存在 1代表删除| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none||none| + +## GET 部门树结构列表 + +GET /system/dept/treeSelect + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|status|query|string| no ||状态（0正常 1停用）| +|deptName|query|string| no ||部门名称| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [ + { + "id": "100", + "label": "MASK科技", + "children": [ + { + "id": "101", + "label": "广西总公司", + "children": [ + { + "id": "103", + "label": "研发部门", + "children": [] + }, + { + "id": "104", + "label": "市场部门", + "children": [] + }, + { + "id": "105", + "label": "测试部门", + "children": [] + }, + { + "id": "106", + "label": "财务部门", + "children": [] + }, + { + "id": "107", + "label": "运维部门", + "children": [] + } + ] + }, + { + "id": "102", + "label": "广东分公司", + "children": [ + { + "id": "108", + "label": "市场部门", + "children": [] + }, + { + "id": "109", + "label": "财务部门", + "children": [] + } + ] + } + ] + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[object]|true|none||none| +|»» id|string|true|none||none| +|»» label|string|true|none||none| +|»» children|[object]|true|none||none| +|»»» id|string|true|none||none| +|»»» label|string|true|none||none| +|»»» children|[object]|false|none||none| + +## GET 部门树结构列表（指定角色） + +GET /system/dept/roleDeptTreeSelect/{roleId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|roleId|path|string| yes ||角色ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "depts": [ + { + "id": "100", + "label": "MASK科技", + "children": [ + { + "id": "101", + "label": "广西总公司", + "children": [ + { + "id": "103", + "label": "研发部门", + "children": [] + }, + { + "id": "104", + "label": "市场部门", + "children": [] + }, + { + "id": "105", + "label": "测试部门", + "children": [] + }, + { + "id": "106", + "label": "财务部门", + "children": [] + }, + { + "id": "107", + "label": "运维部门", + "children": [] + } + ] + }, + { + "id": "102", + "label": "广东分公司", + "children": [ + { + "id": "108", + "label": "市场部门", + "children": [] + }, + { + "id": "109", + "label": "财务部门", + "children": [] + } + ] + } + ] + } + ], + "checkedKeys": [] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» depts|[object]|true|none|部门节点|none| +|»»» id|string|true|none|ID|none| +|»»» label|string|true|none|名称|none| +|»»» children|[object]|true|none|子节点|none| +|»»»» id|string|false|none|ID|none| +|»»»» label|string|false|none|名称|none| +|»»»» children|[object]|false|none|子节点|none| +|»» checkedKeys|[object]|true|none|已选ID数组|none| + +## POST 部门新增 + +POST /system/dept + +> Body Parameters + +```json +{ + "orderNum": 0, + "deptName": "string", + "leader": "string", + "phone": "string", + "email": "string", + "status": "string", + "parentId": "string", + "parentName": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» orderNum|body|integer| yes | 显示顺序|none| +|» deptName|body|string| yes | 部门名称|none| +|» leader|body|string| yes | 负责人|none| +|» phone|body|string| yes | 联系电话|none| +|» email|body|string| yes | 邮箱|none| +|» status|body|string| yes | 部门状态|0正常 1停用| +|» parentId|body|string| yes | 父部门ID|0为根节点| +|» parentName|body|string| no | 父部门名称|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "部门新增【xxx】失败，部门名称已存在" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 部门修改 + +PUT /system/dept + +> Body Parameters + +```json +{ + "orderNum": 0, + "deptName": "string", + "leader": "string", + "phone": "string", + "email": "string", + "status": "string", + "parentId": "string", + "parentName": "string", + "deptId": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» orderNum|body|integer| yes | 显示顺序|none| +|» deptName|body|string| yes | 部门名称|none| +|» leader|body|string| yes | 负责人|none| +|» phone|body|string| yes | 联系电话|none| +|» email|body|string| yes | 邮箱|none| +|» status|body|string| yes | 部门状态|0正常 1停用| +|» parentId|body|string| yes | 父部门ID|none| +|» parentName|body|string| no | 父部门名称|none| +|» deptId|body|string| yes | 部门ID|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问部门数据" +} +``` + +```json +{ + "code": 500, + "msg": "部门修改【拉高济查】失败，上级部门不能是自己" +} +``` + +```json +{ + "code": 500, + "msg": "该部门包含未停用的子部门！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 部门删除 + +DELETE /system/dept/{deptId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|deptId|path|string| yes ||部门ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问部门数据" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 部门信息 + +GET /system/dept/{deptId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|deptId|path|string| yes ||部门编号| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "deptId": "109", + "parentId": "102", + "ancestors": "0,100,102", + "deptName": "财务部门", + "orderNum": 2, + "leader": "MASK", + "phone": "15888888888", + "email": "mask@qq.com", + "status": "1", + "parentName": "广东分公司" + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object¦null|true|none||none| +|»» deptId|string|true|none|部门ID|none| +|»» parentId|string|true|none|父部门ID|none| +|»» ancestors|string|true|none|祖级列表|none| +|»» deptName|string|true|none|部门名称|none| +|»» orderNum|integer|true|none|显示顺序|none| +|»» leader|string|true|none|负责人|none| +|»» phone|string|true|none|联系电话|none| +|»» email|string|true|none|邮箱|none| +|»» status|string|true|none|部门状态|0正常 1停用| +|»» parentName|string|true|none|父部门名称|none| + +# 中文src目录接口/系统模块/字典数据信息 + +## POST 字典数据列表导出 + +POST /system/dict/data/export + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=dict_data_export_10_1684245668586.xlsx +content-length: 18236 +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +> Body Parameters + +```json +{ + "dictLabel": "string", + "dictType": "string", + "status": "string", + "beginTime": "string", + "endTime": "string", + "pageNum": 0, + "pageSize": 0 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» dictLabel|body|string| no | 数据标签|none| +|» dictType|body|string| no | 字典类型|none| +|» status|body|string| no | 状态|0正常 1停用| +|» beginTime|body|string| no | 创建开始时间|none| +|» endTime|body|string| no | 创建结束时间|none| +|» pageNum|body|number| yes | 页数，默认1|none| +|» pageSize|body|number| yes | 单页记录数，默认10|none| + +> Response Examples + +```json +{ + "code": 500, + "msg": "导出数据记录为空" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 字典数据列表 + +GET /system/dict/data/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|dictType|query|string| no ||字典类型| +|dictLabel|query|string| no ||数据标签| +|status|query|string| no ||状态（0正常 1停用）| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 3, + "rows": [ + { + "dictCode": "1", + "dictSort": 1, + "dictLabel": "未知", + "dictValue": "0", + "dictType": "sys_user_sex", + "tagClass": "", + "tagType": "", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527109", + "remark": "性别男" + }, + { + "dictCode": "2", + "dictSort": 2, + "dictLabel": "男", + "dictValue": "1", + "dictType": "sys_user_sex", + "tagClass": "", + "tagType": "", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527118", + "remark": "性别女" + }, + { + "dictCode": "3", + "dictSort": 3, + "dictLabel": "女", + "dictValue": "2", + "dictType": "sys_user_sex", + "tagClass": "", + "tagType": "", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527126", + "remark": "性别未知" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» dictCode|string|true|none|编码ID|none| +|»» dictSort|integer|true|none|排序|none| +|»» dictLabel|string|true|none|标签名称|none| +|»» dictValue|string|true|none|标签值|none| +|»» dictType|string|true|none|字典类型|从字典类型列表中获取| +|»» tagClass|string|true|none|样式属性（样式扩展）|预设的class样式| +|»» tagType|string|true|none|标签类型（预设颜色）|预设数据固定项| +|»» status|string|true|none|状态|0停用 1正常| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## GET 字典数据详情 + +GET /system/dict/data/{dictCode} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|dictCode|path|string| yes ||编码ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "dictCode": "15", + "dictSort": 2, + "dictLabel": "公告", + "dictValue": "2", + "dictType": "sys_notice_type", + "tagClass": "", + "tagType": "processing", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527183", + "remark": "公告" + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» dictCode|string|true|none|编码ID|none| +|»» dictSort|integer|true|none|排序|none| +|»» dictLabel|string|true|none|标签名称|none| +|»» dictValue|string|true|none|标签值|none| +|»» dictType|string|true|none|字典类型|从字典类型列表中获取| +|»» tagClass|string|true|none|样式属性（样式扩展）|预设的class样式| +|»» tagType|string|true|none|标签类型（预设颜色）|预设数据固定项| +|»» status|string|true|none|状态|0停用 1正常| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## GET 字典数据列表（指定字典类型） + +GET /system/dict/data/type/{dictType} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|dictType|path|string| yes ||字典类型，从字典类型列表中获取| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [ + { + "dictCode": "1", + "dictSort": 1, + "dictLabel": "未知", + "dictValue": "0", + "dictType": "sys_user_sex", + "tagClass": "", + "tagType": "", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527109", + "remark": "性别男" + }, + { + "dictCode": "2", + "dictSort": 2, + "dictLabel": "男", + "dictValue": "1", + "dictType": "sys_user_sex", + "tagClass": "", + "tagType": "", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527118", + "remark": "性别女" + }, + { + "dictCode": "3", + "dictSort": 3, + "dictLabel": "女", + "dictValue": "2", + "dictType": "sys_user_sex", + "tagClass": "", + "tagType": "", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527126", + "remark": "性别未知" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[object]|true|none||none| +|»» dictCode|string|false|none|编码ID|none| +|»» dictSort|integer|false|none|排序|none| +|»» dictLabel|string|false|none|标签名称|none| +|»» dictValue|string|false|none|标签值|none| +|»» dictType|string|false|none|字典类型|从字典类型列表中获取| +|»» tagClass|string|false|none|样式属性（样式扩展）|预设的class样式| +|»» tagType|string|false|none|标签类型（预设颜色）|预设数据固定项| +|»» status|string|false|none|状态|0停用 1正常| +|»» createBy|string|false|none||none| +|»» createTime|string|false|none||none| +|»» remark|string|false|none|备注|none| + +## POST 字典数据新增 + +POST /system/dict/data + +> Body Parameters + +```json +{ + "dictType": "string", + "dictLabel": "string", + "dictValue": "string", + "dictSort": 0, + "tagClass": "string", + "tagType": "string", + "status": "string", + "remark": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» dictType|body|string| yes | 字典类型|从字典类型列表中获取| +|» dictLabel|body|string| yes | 标签名称|none| +|» dictValue|body|string| yes | 标签值|none| +|» dictSort|body|integer| yes | 排序|none| +|» tagClass|body|string| yes | 样式属性（样式扩展）|预设的class样式| +|» tagType|body|string| yes | 标签类型（预设颜色）|预设数据固定项| +|» status|body|string| yes | 状态|0停用 1正常| +|» remark|body|string| yes | 备注|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "数据新增【xxxx】失败，该字典类型下标签名已存在" +} +``` + +```json +{ + "code": 500, + "msg": "数据新增【x】失败，该字典类型下标签值已存在" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问字典类型数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 字典数据修改 + +PUT /system/dict/data + +> Body Parameters + +```json +{ + "dictCode": "string", + "dictType": "string", + "dictLabel": "string", + "dictValue": "string", + "dictSort": 0, + "tagClass": "string", + "tagType": "string", + "status": "string", + "remark": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» dictCode|body|string| yes | 编码ID|none| +|» dictType|body|string| yes | 字典类型|从字典类型列表中获取| +|» dictLabel|body|string| yes | 标签名称|none| +|» dictValue|body|string| yes | 标签值|none| +|» dictSort|body|integer| yes | 排序|none| +|» tagClass|body|string| yes | 样式属性（样式扩展）|预设的class样式| +|» tagType|body|string| yes | 标签类型（预设颜色）|预设数据固定项| +|» status|body|string| yes | 状态|0停用 1正常| +|» remark|body|string| yes | 备注|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问字典类型数据！" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问字典编码数据！" +} +``` + +```json +{ + "code": 500, + "msg": "数据修改【x】失败，该字典类型下标签值已存在" +} +``` + +```json +{ + "code": 500, + "msg": "数据修改【xxxx】失败，该字典类型下标签名已存在" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 字典数据删除 + +DELETE /system/dict/data/{dictCodes} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|dictCodes|path|string| yes ||字典编码ID，多个用英文逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问字典编码数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/系统模块/字典类型信息 + +## GET 字典类型列表 + +GET /system/dict/type/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|dictName|query|string| no ||名称| +|dictType|query|string| no ||类型| +|status|query|string| no ||状态（0正常 1停用）| +|beginTime|query|string| no ||创建时间-开始| +|endTime|query|string| no ||创建时间-结束| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 10, + "rows": [ + { + "dictId": "1", + "dictName": "用户性别", + "dictType": "sys_user_sex", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526985", + "remark": "用户性别列表" + }, + { + "dictId": "2", + "dictName": "菜单状态", + "dictType": "sys_show_hide", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526992", + "remark": "菜单状态列表" + }, + { + "dictId": "3", + "dictName": "系统开关", + "dictType": "sys_normal_disable", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526999", + "remark": "系统开关列表" + }, + { + "dictId": "4", + "dictName": "任务状态", + "dictType": "sys_job_status", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527005", + "remark": "任务状态列表" + }, + { + "dictId": "5", + "dictName": "任务分组", + "dictType": "sys_job_group", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527010", + "remark": "任务分组列表" + }, + { + "dictId": "6", + "dictName": "系统是否", + "dictType": "sys_yes_no", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527016", + "remark": "系统是否列表" + }, + { + "dictId": "7", + "dictName": "通知类型", + "dictType": "sys_notice_type", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527023", + "remark": "通知类型列表" + }, + { + "dictId": "8", + "dictName": "通知状态", + "dictType": "sys_notice_status", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527029", + "remark": "通知状态列表" + }, + { + "dictId": "9", + "dictName": "操作类型", + "dictType": "sys_oper_type", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527035", + "remark": "操作类型列表" + }, + { + "dictId": "10", + "dictName": "系统状态", + "dictType": "sys_common_status", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264527042", + "remark": "登录状态列表" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» dictId|string|true|none|字典ID|none| +|»» dictName|string|true|none|名称|none| +|»» dictType|string|true|none|类型|none| +|»» status|string|true|none|状态|0停用 1正常| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## GET 字典类型详细 + +GET /system/dict/type/{dictId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|dictId|path|string| yes ||字典ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "dictId": "1", + "dictName": "用户性别", + "dictType": "sys_user_sex", + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526985", + "remark": "用户性别列表" + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object¦null|true|none||none| +|»» dictId|string|true|none|字典ID|none| +|»» dictName|string|true|none|名称|none| +|»» dictType|string|true|none|类型|none| +|»» status|string|true|none|状态|0停用 1正常| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## POST 字典类型列表导出 + +POST /system/dict/type/export + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=dict_type_export_12_1684240671183.xlsx +content-length: 18246 +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +> Body Parameters + +```json +{ + "dictName": "string", + "dictType": "string", + "status": "string", + "beginTime": "string", + "endTime": "string", + "pageNum": 0, + "pageSize": 0 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» dictName|body|string| no | 名称|none| +|» dictType|body|string| no | 类型|none| +|» status|body|string| no | 状态|0正常 1停用| +|» beginTime|body|string| no | 创建开始时间|none| +|» endTime|body|string| no | 创建结束时间|none| +|» pageNum|body|number| yes | 页数，默认1|none| +|» pageSize|body|number| yes | 单页记录数，默认10|none| + +> Response Examples + +```json +{ + "code": 500, + "msg": "导出数据记录为空" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 字典类型新增 + +POST /system/dict/type + +> Body Parameters + +```json +{ + "dictName": "string", + "dictType": "string", + "status": "string", + "remark": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» dictName|body|string| yes | 名称|none| +|» dictType|body|string| yes | 类型|none| +|» status|body|string| yes | 状态|0停用 1正常| +|» remark|body|string| yes | 备注|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "字典新增【xxx】失败，字典名称已存在" +} +``` + +```json +{ + "code": 500, + "msg": "字典新增【xxxx】失败，字典类型已存在" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 字典类型修改 + +PUT /system/dict/type + +> Body Parameters + +```json +{ + "dictName": "string", + "dictType": "string", + "remark": "string", + "status": "string", + "dictId": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» dictName|body|string| yes | 名称|none| +|» dictType|body|string| yes | 类型|none| +|» remark|body|string| yes | 备注|none| +|» status|body|string| yes | 状态|0停用 1正常| +|» dictId|body|string| no | 字典ID|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "字典修改【xxxx】失败，字典名称已存在" +} +``` + +```json +{ + "code": 500, + "msg": "字典修改【xxxx】失败，字典类型已存在" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 字典类型删除 + +DELETE /system/dict/type/{dictIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|dictIds|path|string| yes ||字典ID，多个用英文逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问字典类型数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 字典类型选择框列表 + +GET /system/dict/type/getDictOptionselect + +在字典数据中进行下拉项选择 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [ + { + "label": "用户性别", + "value": "sys_user_sex" + }, + { + "label": "菜单状态", + "value": "sys_show_hide" + }, + { + "label": "系统开关", + "value": "sys_normal_disable" + }, + { + "label": "任务状态", + "value": "sys_job_status" + }, + { + "label": "任务分组", + "value": "sys_job_group" + }, + { + "label": "系统是否", + "value": "sys_yes_no" + }, + { + "label": "通知类型", + "value": "sys_notice_type" + }, + { + "label": "通知状态", + "value": "sys_notice_status" + }, + { + "label": "操作类型", + "value": "sys_oper_type" + }, + { + "label": "系统状态", + "value": "sys_common_status" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[object]|true|none||none| +|»» label|string|true|none|标签名称|none| +|»» value|string|true|none|标签值|none| + +## PUT 字典类型刷新缓存 + +PUT /system/dict/type/refreshCache + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/系统模块/菜单信息 + +## GET 菜单列表 + +GET /system/menu/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|menuName|query|string| no ||菜单名称| +|status|query|string| no ||菜单状态 0正常 1停用| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [ + { + "menuId": "1", + "menuName": "系统管理", + "parentId": "0", + "menuSort": 1, + "path": "system", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "D", + "visible": "1", + "status": "1", + "perms": "", + "icon": "#", + "createTime": "1682264526443", + "remark": "系统管理目录" + }, + { + "menuId": "2", + "menuName": "系统监控", + "parentId": "0", + "menuSort": 2, + "path": "monitor", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "D", + "visible": "1", + "status": "1", + "perms": "", + "icon": "#", + "createTime": "1682264526448", + "remark": "系统监控目录" + }, + { + "menuId": "3", + "menuName": "系统工具", + "parentId": "0", + "menuSort": 3, + "path": "tool", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "D", + "visible": "1", + "status": "1", + "perms": "", + "icon": "#", + "createTime": "1682264526452", + "remark": "系统工具目录" + }, + { + "menuId": "4", + "menuName": "开源仓库", + "parentId": "0", + "menuSort": 4, + "path": "https://gitee.com/TsMask", + "component": "", + "isFrame": "0", + "isCache": "0", + "menuType": "D", + "visible": "1", + "status": "1", + "perms": "", + "icon": "#", + "createTime": "1682264526456", + "remark": "开源仓库跳转外部链接打开新窗口" + }, + { + "menuId": "100", + "menuName": "用户管理", + "parentId": "1", + "menuSort": 1, + "path": "user", + "component": "system/user/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "system:user:list", + "icon": "#", + "createTime": "1682264526459", + "remark": "用户管理菜单" + }, + { + "menuId": "101", + "menuName": "角色管理", + "parentId": "1", + "menuSort": 2, + "path": "role", + "component": "system/role/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "system:role:list", + "icon": "#", + "createTime": "1682264526463", + "remark": "角色管理菜单" + }, + { + "menuId": "102", + "menuName": "分配角色", + "parentId": "1", + "menuSort": 3, + "path": "role/inline/auth-user/:roleId", + "component": "system/role/auth-user", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "0", + "status": "1", + "perms": "system:role:auth", + "icon": "#", + "createTime": "1682264526467", + "remark": "分配角色内嵌隐藏菜单" + }, + { + "menuId": "103", + "menuName": "菜单管理", + "parentId": "1", + "menuSort": 4, + "path": "menu", + "component": "system/menu/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "system:menu:list", + "icon": "#", + "createTime": "1682264526471", + "remark": "菜单管理菜单" + }, + { + "menuId": "104", + "menuName": "部门管理", + "parentId": "1", + "menuSort": 5, + "path": "dept", + "component": "system/dept/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "system:dept:list", + "icon": "#", + "createTime": "1682264526475", + "remark": "部门管理菜单" + }, + { + "menuId": "105", + "menuName": "岗位管理", + "parentId": "1", + "menuSort": 6, + "path": "post", + "component": "system/post/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "system:post:list", + "icon": "#", + "createTime": "1682264526479", + "remark": "岗位管理菜单" + }, + { + "menuId": "106", + "menuName": "字典管理", + "parentId": "1", + "menuSort": 7, + "path": "dict", + "component": "system/dict/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "system:dict:list", + "icon": "#", + "createTime": "1682264526484", + "remark": "字典管理菜单" + }, + { + "menuId": "107", + "menuName": "字典数据", + "parentId": "1", + "menuSort": 8, + "path": "dict/inline/data/:dictId", + "component": "system/dict/data", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "0", + "status": "1", + "perms": "system:dict:data", + "icon": "#", + "createTime": "1682264526488", + "remark": "字典数据内嵌隐藏菜单" + }, + { + "menuId": "108", + "menuName": "参数设置", + "parentId": "1", + "menuSort": 9, + "path": "config", + "component": "system/config/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "system:config:list", + "icon": "#", + "createTime": "1682264526491", + "remark": "参数设置菜单" + }, + { + "menuId": "109", + "menuName": "通知公告", + "parentId": "1", + "menuSort": 10, + "path": "notice", + "component": "system/notice/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "system:notice:list", + "icon": "#", + "createTime": "1682264526495", + "remark": "通知公告菜单" + }, + { + "menuId": "111", + "menuName": "日志管理", + "parentId": "1", + "menuSort": 11, + "path": "log", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "D", + "visible": "1", + "status": "1", + "perms": "", + "icon": "#", + "createTime": "1682264526498", + "remark": "日志管理菜单" + }, + { + "menuId": "112", + "menuName": "服务监控", + "parentId": "2", + "menuSort": 1, + "path": "server-info", + "component": "monitor/server/info", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "monitor:server:info", + "icon": "#", + "createTime": "1682264526502", + "remark": "服务监控菜单" + }, + { + "menuId": "113", + "menuName": "缓存监控", + "parentId": "2", + "menuSort": 2, + "path": "cache-info", + "component": "monitor/cache/info", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "monitor:cache:info", + "icon": "#", + "createTime": "1682264526505", + "remark": "缓存监控菜单" + }, + { + "menuId": "114", + "menuName": "缓存列表", + "parentId": "2", + "menuSort": 3, + "path": "cache", + "component": "monitor/cache/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "monitor:cache:list", + "icon": "#", + "createTime": "1682264526509", + "remark": "缓存列表菜单" + }, + { + "menuId": "115", + "menuName": "在线用户", + "parentId": "2", + "menuSort": 4, + "path": "online", + "component": "monitor/online/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "monitor:online:list", + "icon": "#", + "createTime": "1682264526513", + "remark": "在线用户菜单" + }, + { + "menuId": "116", + "menuName": "调度任务", + "parentId": "2", + "menuSort": 5, + "path": "job", + "component": "monitor/job/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "monitor:job:list", + "icon": "#", + "createTime": "1682264526517", + "remark": "调度任务菜单" + }, + { + "menuId": "117", + "menuName": "调度日志", + "parentId": "2", + "menuSort": 6, + "path": "job/inline/log/:jobId", + "component": "monitor/job/log", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "0", + "status": "1", + "perms": "monitor:job:log", + "icon": "#", + "createTime": "1682264526520", + "remark": "调度日志内嵌隐藏菜单" + }, + { + "menuId": "118", + "menuName": "系统接口", + "parentId": "3", + "menuSort": 1, + "path": "swagger", + "component": "tool/swagger/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "monitor:swagger:list", + "icon": "#", + "createTime": "1682264526524", + "remark": "系统接口菜单" + }, + { + "menuId": "1000", + "menuName": "用户查询", + "parentId": "100", + "menuSort": 1, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:user:query", + "icon": "#", + "createTime": "1682264526537", + "remark": "" + }, + { + "menuId": "1001", + "menuName": "用户新增", + "parentId": "100", + "menuSort": 2, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:user:add", + "icon": "#", + "createTime": "1682264526540", + "remark": "" + }, + { + "menuId": "1002", + "menuName": "用户修改", + "parentId": "100", + "menuSort": 3, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:user:edit", + "icon": "#", + "createTime": "1682264526545", + "remark": "" + }, + { + "menuId": "1003", + "menuName": "用户删除", + "parentId": "100", + "menuSort": 4, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:user:remove", + "icon": "#", + "createTime": "1682264526549", + "remark": "" + }, + { + "menuId": "1004", + "menuName": "用户导出", + "parentId": "100", + "menuSort": 5, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:user:export", + "icon": "#", + "createTime": "1682264526552", + "remark": "" + }, + { + "menuId": "1005", + "menuName": "用户导入", + "parentId": "100", + "menuSort": 6, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:user:import", + "icon": "#", + "createTime": "1682264526556", + "remark": "" + }, + { + "menuId": "1006", + "menuName": "重置密码", + "parentId": "100", + "menuSort": 7, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:user:resetPwd", + "icon": "#", + "createTime": "1682264526561", + "remark": "" + }, + { + "menuId": "1007", + "menuName": "角色查询", + "parentId": "101", + "menuSort": 1, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:role:query", + "icon": "#", + "createTime": "1682264526564", + "remark": "" + }, + { + "menuId": "1008", + "menuName": "角色新增", + "parentId": "101", + "menuSort": 2, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:role:add", + "icon": "#", + "createTime": "1682264526567", + "remark": "" + }, + { + "menuId": "1009", + "menuName": "角色修改", + "parentId": "101", + "menuSort": 3, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:role:edit", + "icon": "#", + "createTime": "1682264526571", + "remark": "" + }, + { + "menuId": "1010", + "menuName": "角色删除", + "parentId": "101", + "menuSort": 4, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:role:remove", + "icon": "#", + "createTime": "1682264526575", + "remark": "" + }, + { + "menuId": "1011", + "menuName": "角色导出", + "parentId": "101", + "menuSort": 5, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:role:export", + "icon": "#", + "createTime": "1682264526579", + "remark": "" + }, + { + "menuId": "1012", + "menuName": "菜单查询", + "parentId": "103", + "menuSort": 1, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:menu:query", + "icon": "#", + "createTime": "1682264526583", + "remark": "" + }, + { + "menuId": "1013", + "menuName": "菜单新增", + "parentId": "103", + "menuSort": 2, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:menu:add", + "icon": "#", + "createTime": "1682264526586", + "remark": "" + }, + { + "menuId": "1014", + "menuName": "菜单修改", + "parentId": "103", + "menuSort": 3, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:menu:edit", + "icon": "#", + "createTime": "1682264526589", + "remark": "" + }, + { + "menuId": "1015", + "menuName": "菜单删除", + "parentId": "103", + "menuSort": 4, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:menu:remove", + "icon": "#", + "createTime": "1682264526592", + "remark": "" + }, + { + "menuId": "1016", + "menuName": "部门查询", + "parentId": "104", + "menuSort": 1, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:dept:query", + "icon": "#", + "createTime": "1682264526595", + "remark": "" + }, + { + "menuId": "1017", + "menuName": "部门新增", + "parentId": "104", + "menuSort": 2, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:dept:add", + "icon": "#", + "createTime": "1682264526598", + "remark": "" + }, + { + "menuId": "1018", + "menuName": "部门修改", + "parentId": "104", + "menuSort": 3, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:dept:edit", + "icon": "#", + "createTime": "1682264526600", + "remark": "" + }, + { + "menuId": "1019", + "menuName": "部门删除", + "parentId": "104", + "menuSort": 4, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:dept:remove", + "icon": "#", + "createTime": "1682264526603", + "remark": "" + }, + { + "menuId": "1020", + "menuName": "岗位查询", + "parentId": "105", + "menuSort": 1, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:post:query", + "icon": "#", + "createTime": "1682264526606", + "remark": "" + }, + { + "menuId": "1021", + "menuName": "岗位新增", + "parentId": "105", + "menuSort": 2, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:post:add", + "icon": "#", + "createTime": "1682264526609", + "remark": "" + }, + { + "menuId": "1022", + "menuName": "岗位修改", + "parentId": "105", + "menuSort": 3, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:post:edit", + "icon": "#", + "createTime": "1682264526612", + "remark": "" + }, + { + "menuId": "1023", + "menuName": "岗位删除", + "parentId": "105", + "menuSort": 4, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:post:remove", + "icon": "#", + "createTime": "1682264526616", + "remark": "" + }, + { + "menuId": "1024", + "menuName": "岗位导出", + "parentId": "105", + "menuSort": 5, + "path": "", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:post:export", + "icon": "#", + "createTime": "1682264526618", + "remark": "" + }, + { + "menuId": "1025", + "menuName": "字典查询", + "parentId": "106", + "menuSort": 1, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:dict:query", + "icon": "#", + "createTime": "1682264526621", + "remark": "" + }, + { + "menuId": "1026", + "menuName": "字典新增", + "parentId": "106", + "menuSort": 2, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:dict:add", + "icon": "#", + "createTime": "1682264526623", + "remark": "" + }, + { + "menuId": "1027", + "menuName": "字典修改", + "parentId": "106", + "menuSort": 3, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:dict:edit", + "icon": "#", + "createTime": "1682264526627", + "remark": "" + }, + { + "menuId": "1028", + "menuName": "字典删除", + "parentId": "106", + "menuSort": 4, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:dict:remove", + "icon": "#", + "createTime": "1682264526630", + "remark": "" + }, + { + "menuId": "1029", + "menuName": "字典导出", + "parentId": "106", + "menuSort": 5, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:dict:export", + "icon": "#", + "createTime": "1682264526632", + "remark": "" + }, + { + "menuId": "1030", + "menuName": "参数查询", + "parentId": "108", + "menuSort": 1, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:config:query", + "icon": "#", + "createTime": "1682264526635", + "remark": "" + }, + { + "menuId": "1031", + "menuName": "参数新增", + "parentId": "108", + "menuSort": 2, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:config:add", + "icon": "#", + "createTime": "1682264526638", + "remark": "" + }, + { + "menuId": "1032", + "menuName": "参数修改", + "parentId": "108", + "menuSort": 3, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:config:edit", + "icon": "#", + "createTime": "1682264526640", + "remark": "" + }, + { + "menuId": "1033", + "menuName": "参数删除", + "parentId": "108", + "menuSort": 4, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:config:remove", + "icon": "#", + "createTime": "1682264526643", + "remark": "" + }, + { + "menuId": "1034", + "menuName": "参数导出", + "parentId": "108", + "menuSort": 5, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:config:export", + "icon": "#", + "createTime": "1682264526646", + "remark": "" + }, + { + "menuId": "1035", + "menuName": "公告查询", + "parentId": "109", + "menuSort": 1, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:notice:query", + "icon": "#", + "createTime": "1682264526650", + "remark": "" + }, + { + "menuId": "1036", + "menuName": "公告新增", + "parentId": "109", + "menuSort": 2, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:notice:add", + "icon": "#", + "createTime": "1682264526654", + "remark": "" + }, + { + "menuId": "1037", + "menuName": "公告修改", + "parentId": "109", + "menuSort": 3, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:notice:edit", + "icon": "#", + "createTime": "1682264526658", + "remark": "" + }, + { + "menuId": "1038", + "menuName": "公告删除", + "parentId": "109", + "menuSort": 4, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "system:notice:remove", + "icon": "#", + "createTime": "1682264526662", + "remark": "" + }, + { + "menuId": "500", + "menuName": "操作日志", + "parentId": "111", + "menuSort": 1, + "path": "operlog", + "component": "monitor/operlog/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "monitor:operlog:list", + "icon": "#", + "createTime": "1682264526528", + "remark": "操作日志菜单" + }, + { + "menuId": "501", + "menuName": "登录日志", + "parentId": "111", + "menuSort": 2, + "path": "logininfor", + "component": "monitor/logininfor/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "monitor:logininfor:list", + "icon": "#", + "createTime": "1682264526532", + "remark": "登录日志菜单" + }, + { + "menuId": "1046", + "menuName": "缓存查询", + "parentId": "114", + "menuSort": 1, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:cache:query", + "icon": "#", + "createTime": "1682264526692", + "remark": "" + }, + { + "menuId": "1047", + "menuName": "缓存删除", + "parentId": "114", + "menuSort": 2, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:cache:remove", + "icon": "#", + "createTime": "1682264526696", + "remark": "" + }, + { + "menuId": "1048", + "menuName": "在线查询", + "parentId": "115", + "menuSort": 1, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:online:query", + "icon": "#", + "createTime": "1682264526700", + "remark": "" + }, + { + "menuId": "1049", + "menuName": "批量强退", + "parentId": "115", + "menuSort": 2, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:online:batchLogout", + "icon": "#", + "createTime": "1682264526704", + "remark": "" + }, + { + "menuId": "1050", + "menuName": "单条强退", + "parentId": "115", + "menuSort": 3, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:online:forceLogout", + "icon": "#", + "createTime": "1682264526707", + "remark": "" + }, + { + "menuId": "1051", + "menuName": "任务查询", + "parentId": "116", + "menuSort": 1, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:job:query", + "icon": "#", + "createTime": "1682264526713", + "remark": "" + }, + { + "menuId": "1052", + "menuName": "任务新增", + "parentId": "116", + "menuSort": 2, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:job:add", + "icon": "#", + "createTime": "1682264526717", + "remark": "" + }, + { + "menuId": "1053", + "menuName": "任务修改", + "parentId": "116", + "menuSort": 3, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:job:edit", + "icon": "#", + "createTime": "1682264526721", + "remark": "" + }, + { + "menuId": "1054", + "menuName": "任务删除", + "parentId": "116", + "menuSort": 4, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:job:remove", + "icon": "#", + "createTime": "1682264526725", + "remark": "" + }, + { + "menuId": "1055", + "menuName": "状态修改", + "parentId": "116", + "menuSort": 5, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:job:changeStatus", + "icon": "#", + "createTime": "1682264526730", + "remark": "" + }, + { + "menuId": "1056", + "menuName": "任务导出", + "parentId": "116", + "menuSort": 6, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:job:export", + "icon": "#", + "createTime": "1682264526735", + "remark": "" + }, + { + "menuId": "1039", + "menuName": "操作查询", + "parentId": "500", + "menuSort": 1, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:operlog:query", + "icon": "#", + "createTime": "1682264526665", + "remark": "" + }, + { + "menuId": "1040", + "menuName": "操作删除", + "parentId": "500", + "menuSort": 2, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:operlog:remove", + "icon": "#", + "createTime": "1682264526670", + "remark": "" + }, + { + "menuId": "1041", + "menuName": "日志导出", + "parentId": "500", + "menuSort": 3, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:operlog:export", + "icon": "#", + "createTime": "1682264526673", + "remark": "" + }, + { + "menuId": "1042", + "menuName": "登录查询", + "parentId": "501", + "menuSort": 1, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:logininfor:query", + "icon": "#", + "createTime": "1682264526677", + "remark": "" + }, + { + "menuId": "1043", + "menuName": "登录删除", + "parentId": "501", + "menuSort": 2, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:logininfor:remove", + "icon": "#", + "createTime": "1682264526681", + "remark": "" + }, + { + "menuId": "1044", + "menuName": "日志导出", + "parentId": "501", + "menuSort": 3, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:logininfor:export", + "icon": "#", + "createTime": "1682264526684", + "remark": "" + }, + { + "menuId": "1045", + "menuName": "账户解锁", + "parentId": "501", + "menuSort": 4, + "path": "#", + "component": "", + "isFrame": "1", + "isCache": "1", + "menuType": "B", + "visible": "1", + "status": "1", + "perms": "monitor:logininfor:unlock", + "icon": "#", + "createTime": "1682264526688", + "remark": "" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|[object]|true|none||none| +|»» menuId|string|true|none|菜单ID|none| +|»» menuName|string|true|none|菜单名称|none| +|»» parentId|string|true|none|父菜单ID|none| +|»» menuSort|integer|true|none|显示顺序|none| +|»» path|string|true|none|路由地址|none| +|»» component|string|true|none|组件路径|none| +|»» isFrame|string|true|none|是否内部跳转|0否 1是| +|»» isCache|string|true|none|是否缓存|0不缓存 1缓存| +|»» menuType|string|true|none|菜单类型|D目录 M菜单 B按钮| +|»» visible|string|true|none|是否显示|0隐藏 1显示| +|»» status|string|true|none|状态|0停用 1正常| +|»» perms|string|true|none|权限标识|none| +|»» icon|string|true|none|图标|无图标要#号或空字符串| +|»» createTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## GET 菜单信息 + +GET /system/menu/{menuId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|menuId|path|string| yes ||菜单ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "menuId": "100", + "menuName": "用户管理", + "parentId": "1", + "menuSort": 1, + "path": "user", + "component": "system/user/index", + "isFrame": "1", + "isCache": "1", + "menuType": "M", + "visible": "1", + "status": "1", + "perms": "system:user:list", + "icon": "#", + "createTime": "1682264526459", + "remark": "用户管理菜单" + } +} +``` + +```json +{ + "code": 200, + "msg": "成功", + "data": null +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object¦null|true|none||none| +|»» menuId|string|true|none|菜单ID|none| +|»» menuName|string|true|none|菜单名称|none| +|»» parentId|string|true|none|父菜单ID|none| +|»» menuSort|integer|true|none|显示顺序|none| +|»» path|string|true|none|路由地址|none| +|»» component|string|true|none|组件路径|none| +|»» isFrame|string|true|none|是否内部跳转|0否 1是| +|»» isCache|string|true|none|是否缓存|0不缓存 1缓存| +|»» menuType|string|true|none|菜单类型|D目录 M菜单 B按钮| +|»» visible|string|true|none|是否显示|0隐藏 1显示| +|»» status|string|true|none|状态|0停用 1正常| +|»» perms|string|true|none|权限标识|none| +|»» icon|string|true|none|图标|无图标要#号或空字符串| +|»» createTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## DELETE 菜单删除 + +DELETE /system/menu/{menuId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|menuId|path|string| yes ||菜单ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问菜单数据" +} +``` + +```json +{ + "code": 500, + "msg": "存在子菜单,不允许删除" +} +``` + +```json +{ + "code": 500, + "msg": "菜单已分配给角色,不允许删除" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 菜单修改 + +PUT /system/menu + +> Body Parameters + +```json +{ + "menuId": "string", + "parentId": "string", + "menuName": "string", + "menuType": "string", + "menuSort": 0, + "isFrame": "string", + "isCache": "string", + "visible": "string", + "status": "string", + "icon": "string", + "path": "string", + "component": "string", + "perms": "string", + "remark": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» menuId|body|string| yes | 菜单ID|none| +|» parentId|body|string| yes | 父菜单ID|none| +|» menuName|body|string| yes | 菜单名称|none| +|» menuType|body|string| yes | 菜单类型|D目录 M菜单 B按钮| +|» menuSort|body|integer| yes | 显示顺序|默认0| +|» isFrame|body|string| no | 是否内部跳转|目录和菜单必传，0否 1是| +|» isCache|body|string| no | 是否缓存|目录和菜单必传，0不缓存 1缓存| +|» visible|body|string| no | 是否显示|目录和菜单必传，0隐藏 1显示| +|» status|body|string| no | 状态|目录和菜单必传，0停用 1正常| +|» icon|body|string| no | 图标|目录和菜单必传，#无图标| +|» path|body|string| no | 路由地址|目录和菜单必传| +|» component|body|string| no | 组件路径|菜单必传| +|» perms|body|string| no | 权限标识|菜单和按钮必传| +|» remark|body|string| no | 备注|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问菜单数据" +} +``` + +```json +{ + "code": 500, + "msg": "菜单修改【xxxx】失败，非内部地址必须以http(s)://开头" +} +``` + +```json +{ + "code": 500, + "msg": "菜单修改【xxxx】失败，菜单路由地址已存在" +} +``` + +```json +{ + "code": 500, + "msg": "菜单修改【xxx】失败，菜单名称已存在" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## POST 菜单新增 + +POST /system/menu + +> Body Parameters + +```json +{ + "parentId": "string", + "menuName": "string", + "menuType": "string", + "menuSort": 0, + "isFrame": "string", + "isCache": "string", + "visible": "string", + "status": "string", + "icon": "string", + "path": "string", + "component": "string", + "perms": "string", + "remark": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» parentId|body|string| yes | 父菜单ID|根据菜单ID| +|» menuName|body|string| yes | 菜单名称|none| +|» menuType|body|string| yes | 菜单类型|D目录 M菜单 B按钮| +|» menuSort|body|integer| yes | 显示顺序|默认0| +|» isFrame|body|string| no | 是否内部跳转|目录和菜单必传，0否 1是| +|» isCache|body|string| no | 是否缓存|目录和菜单必传，0不缓存 1缓存| +|» visible|body|string| no | 是否显示|目录和菜单必传，0隐藏 1显示| +|» status|body|string| no | 状态|目录和菜单必传，0停用 1正常| +|» icon|body|string| no | 图标|目录和菜单必传，#无图标| +|» path|body|string| no | 路由地址|目录和菜单必传| +|» component|body|string| no | 组件路径|菜单必传| +|» perms|body|string| no | 权限标识|菜单和按钮必传| +|» remark|body|string| no | 备注|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "菜单新增【xxx】失败，菜单路由地址已存在" +} +``` + +```json +{ + "code": 500, + "msg": "菜单新增【xxxx】失败，菜单名称已存在" +} +``` + +```json +{ + "code": 500, + "msg": "菜单新增【xxxx】失败，非内部地址必须以http(s)://开头" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 菜单树结构列表（指定角色） + +GET /system/menu/roleMenuTreeSelect/{roleId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|roleId|path|string| yes ||角色ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "menus": [ + { + "id": "1", + "label": "系统管理", + "children": [ + { + "id": "100", + "label": "用户管理", + "children": [ + { + "id": "1000", + "label": "用户查询", + "children": [] + }, + { + "id": "1001", + "label": "用户新增", + "children": [] + }, + { + "id": "1002", + "label": "用户修改", + "children": [] + }, + { + "id": "1003", + "label": "用户删除", + "children": [] + }, + { + "id": "1004", + "label": "用户导出", + "children": [] + }, + { + "id": "1005", + "label": "用户导入", + "children": [] + }, + { + "id": "1006", + "label": "重置密码", + "children": [] + } + ] + }, + { + "id": "101", + "label": "角色管理", + "children": [ + { + "id": "1007", + "label": "角色查询", + "children": [] + }, + { + "id": "1008", + "label": "角色新增", + "children": [] + }, + { + "id": "1009", + "label": "角色修改", + "children": [] + }, + { + "id": "1010", + "label": "角色删除", + "children": [] + }, + { + "id": "1011", + "label": "角色导出", + "children": [] + } + ] + }, + { + "id": "102", + "label": "分配角色", + "children": [] + }, + { + "id": "103", + "label": "菜单管理", + "children": [ + { + "id": "1012", + "label": "菜单查询", + "children": [] + }, + { + "id": "1013", + "label": "菜单新增", + "children": [] + }, + { + "id": "1014", + "label": "菜单修改", + "children": [] + }, + { + "id": "1015", + "label": "菜单删除", + "children": [] + } + ] + }, + { + "id": "104", + "label": "部门管理", + "children": [ + { + "id": "1016", + "label": "部门查询", + "children": [] + }, + { + "id": "1017", + "label": "部门新增", + "children": [] + }, + { + "id": "1018", + "label": "部门修改", + "children": [] + }, + { + "id": "1019", + "label": "部门删除", + "children": [] + } + ] + }, + { + "id": "105", + "label": "岗位管理", + "children": [ + { + "id": "1020", + "label": "岗位查询", + "children": [] + }, + { + "id": "1021", + "label": "岗位新增", + "children": [] + }, + { + "id": "1022", + "label": "岗位修改", + "children": [] + }, + { + "id": "1023", + "label": "岗位删除", + "children": [] + }, + { + "id": "1024", + "label": "岗位导出", + "children": [] + } + ] + }, + { + "id": "106", + "label": "字典管理", + "children": [ + { + "id": "1025", + "label": "字典查询", + "children": [] + }, + { + "id": "1026", + "label": "字典新增", + "children": [] + }, + { + "id": "1027", + "label": "字典修改", + "children": [] + }, + { + "id": "1028", + "label": "字典删除", + "children": [] + }, + { + "id": "1029", + "label": "字典导出", + "children": [] + } + ] + }, + { + "id": "107", + "label": "字典数据", + "children": [] + }, + { + "id": "108", + "label": "参数设置", + "children": [ + { + "id": "1030", + "label": "参数查询", + "children": [] + }, + { + "id": "1031", + "label": "参数新增", + "children": [] + }, + { + "id": "1032", + "label": "参数修改", + "children": [] + }, + { + "id": "1033", + "label": "参数删除", + "children": [] + }, + { + "id": "1034", + "label": "参数导出", + "children": [] + } + ] + }, + { + "id": "109", + "label": "通知公告", + "children": [ + { + "id": "1035", + "label": "公告查询", + "children": [] + }, + { + "id": "1036", + "label": "公告新增", + "children": [] + }, + { + "id": "1037", + "label": "公告修改", + "children": [] + }, + { + "id": "1038", + "label": "公告删除", + "children": [] + } + ] + }, + { + "id": "111", + "label": "日志管理", + "children": [ + { + "id": "500", + "label": "操作日志", + "children": [ + { + "id": "1039", + "label": "操作查询", + "children": "[Object]" + }, + { + "id": "1040", + "label": "操作删除", + "children": "[Object]" + }, + { + "id": "1041", + "label": "日志导出", + "children": "[Object]" + } + ] + }, + { + "id": "501", + "label": "登录日志", + "children": [ + { + "id": "1042", + "label": "登录查询", + "children": "[Object]" + }, + { + "id": "1043", + "label": "登录删除", + "children": "[Object]" + }, + { + "id": "1044", + "label": "日志导出", + "children": "[Object]" + }, + { + "id": "1045", + "label": "账户解锁", + "children": "[Object]" + } + ] + } + ] + } + ] + }, + { + "id": "2", + "label": "系统监控", + "children": [ + { + "id": "112", + "label": "服务监控", + "children": [] + }, + { + "id": "113", + "label": "缓存监控", + "children": [] + }, + { + "id": "114", + "label": "缓存列表", + "children": [ + { + "id": "1046", + "label": "缓存查询", + "children": [] + }, + { + "id": "1047", + "label": "缓存删除", + "children": [] + } + ] + }, + { + "id": "115", + "label": "在线用户", + "children": [ + { + "id": "1048", + "label": "在线查询", + "children": [] + }, + { + "id": "1049", + "label": "批量强退", + "children": [] + }, + { + "id": "1050", + "label": "单条强退", + "children": [] + } + ] + }, + { + "id": "116", + "label": "调度任务", + "children": [ + { + "id": "1051", + "label": "任务查询", + "children": [] + }, + { + "id": "1052", + "label": "任务新增", + "children": [] + }, + { + "id": "1053", + "label": "任务修改", + "children": [] + }, + { + "id": "1054", + "label": "任务删除", + "children": [] + }, + { + "id": "1055", + "label": "状态修改", + "children": [] + }, + { + "id": "1056", + "label": "任务导出", + "children": [] + } + ] + }, + { + "id": "117", + "label": "调度日志", + "children": [] + } + ] + }, + { + "id": "3", + "label": "系统工具", + "children": [ + { + "id": "118", + "label": "系统接口", + "children": [] + } + ] + }, + { + "id": "4", + "label": "开源仓库", + "children": [] + }, + { + "id": "2002", + "label": "备千验白儿这", + "children": [] + }, + { + "id": "2001", + "label": "要形存做情式2史", + "children": [] + } + ], + "checkedKeys": [] + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» menus|[object]|true|none|菜单节点|none| +|»»» id|string|true|none|ID|none| +|»»» label|string|true|none|名称|none| +|»»» children|[object]|true|none|子节点|none| +|»»»» id|string|false|none|ID|none| +|»»»» label|string|false|none|名称|none| +|»»»» children|[object]|false|none|子节点|none| +|»» checkedKeys|[object]|true|none|已选ID数组|none| + +## GET 菜单树结构列表 + +GET /system/menu/treeSelect + +角色新增修改中菜单权限列表使用 + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|menuName|query|string| no ||菜单名称| +|status|query|string| no ||菜单状态 0正常 1停用| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": [ + { + "id": "1", + "label": "系统管理", + "children": [ + { + "id": "100", + "label": "用户管理", + "children": [ + { + "id": "1000", + "label": "用户查询", + "children": [] + }, + { + "id": "1001", + "label": "用户新增", + "children": [] + }, + { + "id": "1002", + "label": "用户修改", + "children": [] + }, + { + "id": "1003", + "label": "用户删除", + "children": [] + }, + { + "id": "1004", + "label": "用户导出", + "children": [] + }, + { + "id": "1005", + "label": "用户导入", + "children": [] + }, + { + "id": "1006", + "label": "重置密码", + "children": [] + } + ] + }, + { + "id": "101", + "label": "角色管理", + "children": [ + { + "id": "1007", + "label": "角色查询", + "children": [] + }, + { + "id": "1008", + "label": "角色新增", + "children": [] + }, + { + "id": "1009", + "label": "角色修改", + "children": [] + }, + { + "id": "1010", + "label": "角色删除", + "children": [] + }, + { + "id": "1011", + "label": "角色导出", + "children": [] + } + ] + }, + { + "id": "102", + "label": "分配角色", + "children": [] + }, + { + "id": "103", + "label": "菜单管理", + "children": [ + { + "id": "1012", + "label": "菜单查询", + "children": [] + }, + { + "id": "1013", + "label": "菜单新增", + "children": [] + }, + { + "id": "1014", + "label": "菜单修改", + "children": [] + }, + { + "id": "1015", + "label": "菜单删除", + "children": [] + } + ] + }, + { + "id": "104", + "label": "部门管理", + "children": [ + { + "id": "1016", + "label": "部门查询", + "children": [] + }, + { + "id": "1017", + "label": "部门新增", + "children": [] + }, + { + "id": "1018", + "label": "部门修改", + "children": [] + }, + { + "id": "1019", + "label": "部门删除", + "children": [] + } + ] + }, + { + "id": "105", + "label": "岗位管理", + "children": [ + { + "id": "1020", + "label": "岗位查询", + "children": [] + }, + { + "id": "1021", + "label": "岗位新增", + "children": [] + }, + { + "id": "1022", + "label": "岗位修改", + "children": [] + }, + { + "id": "1023", + "label": "岗位删除", + "children": [] + }, + { + "id": "1024", + "label": "岗位导出", + "children": [] + } + ] + }, + { + "id": "106", + "label": "字典管理", + "children": [ + { + "id": "1025", + "label": "字典查询", + "children": [] + }, + { + "id": "1026", + "label": "字典新增", + "children": [] + }, + { + "id": "1027", + "label": "字典修改", + "children": [] + }, + { + "id": "1028", + "label": "字典删除", + "children": [] + }, + { + "id": "1029", + "label": "字典导出", + "children": [] + } + ] + }, + { + "id": "107", + "label": "字典数据", + "children": [] + }, + { + "id": "108", + "label": "参数设置", + "children": [ + { + "id": "1030", + "label": "参数查询", + "children": [] + }, + { + "id": "1031", + "label": "参数新增", + "children": [] + }, + { + "id": "1032", + "label": "参数修改", + "children": [] + }, + { + "id": "1033", + "label": "参数删除", + "children": [] + }, + { + "id": "1034", + "label": "参数导出", + "children": [] + } + ] + }, + { + "id": "109", + "label": "通知公告", + "children": [ + { + "id": "1035", + "label": "公告查询", + "children": [] + }, + { + "id": "1036", + "label": "公告新增", + "children": [] + }, + { + "id": "1037", + "label": "公告修改", + "children": [] + }, + { + "id": "1038", + "label": "公告删除", + "children": [] + } + ] + }, + { + "id": "111", + "label": "日志管理", + "children": [ + { + "id": "500", + "label": "操作日志", + "children": [ + { + "id": "1039", + "label": "操作查询", + "children": [] + }, + { + "id": "1040", + "label": "操作删除", + "children": [] + }, + { + "id": "1041", + "label": "日志导出", + "children": [] + } + ] + }, + { + "id": "501", + "label": "登录日志", + "children": [ + { + "id": "1042", + "label": "登录查询", + "children": [] + }, + { + "id": "1043", + "label": "登录删除", + "children": [] + }, + { + "id": "1044", + "label": "日志导出", + "children": [] + }, + { + "id": "1045", + "label": "账户解锁", + "children": [] + } + ] + } + ] + } + ] + }, + { + "id": "2", + "label": "系统监控", + "children": [ + { + "id": "112", + "label": "服务监控", + "children": [] + }, + { + "id": "113", + "label": "缓存监控", + "children": [] + }, + { + "id": "114", + "label": "缓存列表", + "children": [ + { + "id": "1046", + "label": "缓存查询", + "children": [] + }, + { + "id": "1047", + "label": "缓存删除", + "children": [] + } + ] + }, + { + "id": "115", + "label": "在线用户", + "children": [ + { + "id": "1048", + "label": "在线查询", + "children": [] + }, + { + "id": "1049", + "label": "批量强退", + "children": [] + }, + { + "id": "1050", + "label": "单条强退", + "children": [] + } + ] + }, + { + "id": "116", + "label": "调度任务", + "children": [ + { + "id": "1051", + "label": "任务查询", + "children": [] + }, + { + "id": "1052", + "label": "任务新增", + "children": [] + }, + { + "id": "1053", + "label": "任务修改", + "children": [] + }, + { + "id": "1054", + "label": "任务删除", + "children": [] + }, + { + "id": "1055", + "label": "状态修改", + "children": [] + }, + { + "id": "1056", + "label": "任务导出", + "children": [] + } + ] + }, + { + "id": "117", + "label": "调度日志", + "children": [] + } + ] + }, + { + "id": "3", + "label": "系统工具", + "children": [ + { + "id": "118", + "label": "系统接口", + "children": [] + } + ] + }, + { + "id": "4", + "label": "开源仓库", + "children": [] + }, + { + "id": "2002", + "label": "备千验白儿这", + "children": [] + }, + { + "id": "2001", + "label": "要形存做情式2史", + "children": [] + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» menus|[object]|true|none||none| +|»»» id|string|true|none|ID|none| +|»»» label|string|true|none|名称|none| +|»»» children|[object]|true|none|子节点|none| +|»»»» id|string|false|none|ID|none| +|»»»» label|string|false|none|名称|none| +|»»»» children|[object]|false|none|子节点|none| +|»» checkedKeys|[object]|true|none|已选ID数组|none| + +# 中文src目录接口/系统模块/岗位信息 + +## GET 岗位列表 + +GET /system/post/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|postCode|query|string| no ||岗位编码| +|postName|query|string| no ||岗位名称| +|status|query|string| no ||状态（0正常 1停用）| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 4, + "rows": [ + { + "postId": "1", + "postCode": "ceo", + "postName": "董事长", + "postSort": 1, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526344", + "remark": "" + }, + { + "postId": "2", + "postCode": "se", + "postName": "项目经理", + "postSort": 2, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526348", + "remark": "" + }, + { + "postId": "3", + "postCode": "hr", + "postName": "人力资源", + "postSort": 3, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526354", + "remark": "" + }, + { + "postId": "4", + "postCode": "user", + "postName": "普通员工", + "postSort": 4, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526358", + "remark": "" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» postId|string|true|none|岗位ID|none| +|»» postCode|string|true|none|编码|none| +|»» postName|string|true|none|名称|none| +|»» postSort|integer|true|none|排序|none| +|»» status|string|true|none|状态|none| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## POST 岗位列表导出 + +POST /system/post/export + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=post_export_16_1684133344353.xlsx +content-length: 19438 +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +> Body Parameters + +```json +{ + "configName": "string", + "postCode": "string", + "status": "string", + "pageNum": 0, + "pageSize": 0 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» configName|body|string| no | 岗位名称|none| +|» postCode|body|string| no | 岗位编码|none| +|» status|body|string| no | 状态|0正常 1停用| +|» pageNum|body|number| yes | 页数，默认1|none| +|» pageSize|body|number| yes | 单页记录数，默认10|none| + +> Response Examples + +```json +{ + "code": 500, + "msg": "导出数据记录为空" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 岗位详细 + +GET /system/post/{postId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|postId|path|string| yes ||岗位ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "postId": "1", + "postCode": "ceo", + "postName": "董事长", + "postSort": 1, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526344", + "remark": "" + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object¦null|true|none||none| +|»» postId|string|true|none|岗位ID|none| +|»» postCode|string|true|none|编码|none| +|»» postName|string|true|none|名称|none| +|»» postSort|integer|true|none|排序|none| +|»» status|string|true|none|状态|none| +|»» createBy|string|true|none||none| +|»» createTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## POST 岗位新增 + +POST /system/post + +> Body Parameters + +```json +{ + "postCode": "string", + "postName": "string", + "postSort": "string", + "phone": "string", + "remark": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» postCode|body|string| yes | 岗位编码|none| +|» postName|body|string| yes | 岗位名称|none| +|» postSort|body|string| yes | 排序|none| +|» phone|body|string| yes | 状态|0正常 1停用| +|» remark|body|string| yes | 备注|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "岗位新增【xxx】失败，岗位名称已存在" +} +``` + +```json +{ + "code": 500, + "msg": "岗位新增【xxx】失败，岗位编码已存在" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 岗位修改 + +PUT /system/post + +> Body Parameters + +```json +{ + "postCode": "string", + "postName": "string", + "postSort": "string", + "phone": "string", + "remark": "string", + "postId": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» postCode|body|string| yes | 岗位编码|none| +|» postName|body|string| yes | 岗位名称|none| +|» postSort|body|string| yes | 排序|none| +|» phone|body|string| yes | 状态|0正常 1停用| +|» remark|body|string| yes | 备注|none| +|» postId|body|string| yes | 岗位ID|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "岗位修改【xxx】失败，岗位名称已存在" +} +``` + +```json +{ + "code": 500, + "msg": "岗位修改【xxx】失败，岗位编码已存在" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 岗位删除 + +DELETE /system/post/{postIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|postIds|path|string| yes ||岗位ID，多个用英文逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问岗位数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/系统模块/个人信息 + +## GET 基础信息获取 + +GET /system/user/profile + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "user": { + "roles": [ + { + "roleId": "1", + "roleName": "管理员", + "roleKey": "admin", + "roleSort": 1, + "dataScope": "1", + "status": "1" + } + ], + "userId": "1", + "deptId": "103", + "userName": "maskAdmin", + "nickName": "管理员", + "userType": "sys", + "email": "", + "avatar": "", + "phonenumber": "", + "sex": "1", + "status": "1", + "delFlag": "0", + "loginIp": "127.0.0.1", + "loginDate": "1683968355811", + "createBy": "maskAdmin", + "createTime": "1682264526306", + "remark": "管理员", + "dept": { + "deptId": "103", + "parentId": "101", + "ancestors": "0,100,101", + "deptName": "研发部门", + "orderNum": 1, + "leader": "MASK", + "status": "1" + } + }, + "roleGroup": [ + "管理员" + ], + "postGroup": [ + "董事长" + ] + } +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none|用户信息|none| +|»» user|object|true|none|用户信息|none| +|»»» roles|[object]|true|none|角色信息|none| +|»»»» roleId|string|false|none||none| +|»»»» roleName|string|false|none||none| +|»»»» roleKey|string|false|none||none| +|»»»» roleSort|integer|false|none||none| +|»»»» dataScope|string|false|none||none| +|»»»» status|string|false|none||none| +|»»» userId|string|true|none||none| +|»»» deptId|string|true|none||none| +|»»» userName|string|true|none||none| +|»»» nickName|string|true|none||none| +|»»» userType|string|true|none||none| +|»»» email|string|true|none||none| +|»»» avatar|string|true|none||none| +|»»» phonenumber|string|true|none||none| +|»»» sex|string|true|none||none| +|»»» status|string|true|none||none| +|»»» delFlag|string|true|none||none| +|»»» loginIp|string|true|none||none| +|»»» loginDate|string|true|none||none| +|»»» createBy|string|true|none||none| +|»»» createTime|string|true|none||none| +|»»» remark|string|true|none||none| +|»»» dept|object|false|none|岗位|none| +|»»»» deptId|string|true|none||none| +|»»»» parentId|string|true|none||none| +|»»»» ancestors|string|true|none||none| +|»»»» deptName|string|true|none||none| +|»»»» orderNum|integer|true|none||none| +|»»»» leader|string|true|none||none| +|»»»» status|string|true|none||none| +|»» roleGroup|[string]|true|none|角色|字符数组| +|»» postGroup|[string]|true|none|岗位|字符数组| + +## PUT 基础信息修改 + +PUT /system/user/profile + +> Body Parameters + +```json +{ + "nickName": "阎秀兰", + "sex": "1", + "phonenumber": "18169338391", + "email": "t.eknevzfl@htejfppo.so" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» nickName|body|string| yes | 昵称|none| +|» email|body|string| no | 邮箱|none| +|» phonenumber|body|string| no | 手机|none| +|» sex|body|string| yes | 性别|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "修改用户【xxxx】失败，手机号码格式错误" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 修改头像 + +POST /system/user/profile/avatar + +> Body Parameters + +```yaml +file: "" + +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» file|body|string(binary)| yes ||请选择等比大小图片作为头像，如200x200、400x400| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": "/upload/avatar/2023/04/o_1d2bofn8f19dh5s11okpje61mipg_画板1_bf3wq4h6.png" +} +``` + +```json +{ + "code": 500, + "msg": "上传文件类型不支持，仅支持以下类型：jpg,jpeg,png" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|string|true|none|图片地址|none| + +## PUT 修改密码 + +PUT /system/user/profile/updatePwd + +> Body Parameters + +```json +{ + "oldPassword": "admin@1234", + "newPassword": "Admin@1234" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» oldPassword|body|string| yes | 旧密码|none| +|» newPassword|body|string| yes | 新密码|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "新密码不能与旧密码相同" +} +``` + +```json +{ + "code": 500, + "msg": "修改密码失败，旧密码错误" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/系统模块/角色信息 + +## GET 角色信息列表 + +GET /system/role/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|roleName|query|string| no ||角色名称| +|roleKey|query|string| no ||权限字符| +|status|query|string| no ||状态 0正常 1停用| +|beginTime|query|string| no ||创建时间-开始| +|endTime|query|string| no ||创建时间-结束| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 2, + "rows": [ + { + "roleId": "1", + "roleName": "管理员", + "roleKey": "admin", + "roleSort": 1, + "dataScope": "1", + "menuCheckStrictly": "1", + "deptCheckStrictly": "1", + "status": "1", + "delFlag": "0", + "createTime": "1682264526399", + "remark": "管理员" + }, + { + "roleId": "2", + "roleName": "普通角色", + "roleKey": "common", + "roleSort": 2, + "dataScope": "2", + "menuCheckStrictly": "1", + "deptCheckStrictly": "1", + "status": "1", + "delFlag": "0", + "createTime": "1682264526404", + "remark": "普通角色" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» roleId|string|true|none|角色ID|none| +|»» roleName|string|true|none|名称|none| +|»» roleKey|string|true|none|键值|none| +|»» roleSort|integer|true|none|排序|none| +|»» dataScope|string|true|none|数据范围|1：全部数据权限 2：自定数据权限 3：本部门数据权限 4：本部门及以下数据权限 5：仅本人数据权限）| +|»» menuCheckStrictly|string|true|none|菜单树选择项是否关联显示|0：父子不互相关联显示 1：父子互相关联显示| +|»» deptCheckStrictly|string|true|none|部门树选择项是否关联显示|0：父子不互相关联显示 1：父子互相关联显示| +|»» status|string|true|none|角色状态|0停用 1正常| +|»» delFlag|string|true|none|删除标志|0代表存在 1代表删除| +|»» createTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## GET 角色分配用户列表 + +GET /system/role/authUser/allocatedList + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|userName|query|string| no ||用户名称| +|phonenumber|query|string| no ||用户手机号| +|status|query|string| no ||用户状态| +|roleId|query|string| yes ||角色ID| +|allocated|query|string| yes ||已分配角色用户 true是 false否| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 1, + "rows": [ + { + "roles": [], + "userId": "2", + "deptId": "105", + "userName": "maskUser", + "nickName": "普通用户", + "email": "maskUser@qq.com", + "phonenumber": "13412341234", + "status": "1", + "createTime": "1682264526309", + "dept": { + "deptId": "105", + "deptName": "测试部门" + } + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» status|string|false|none|角色状态|0停用 1正常| +|»» createTime|string|false|none|创建时间|none| +|»» roles|[string]|false|none|角色ID数组|none| +|»» userId|string|false|none|用户ID|none| +|»» deptId|string|false|none|部门ID|none| +|»» userName|string|false|none|用户名称|none| +|»» nickName|string|false|none|用户昵称|none| +|»» email|string|false|none|邮箱|none| +|»» phonenumber|string|false|none|手机号|none| +|»» dept|object|false|none|部门信息|none| +|»»» deptId|string|false|none|部门ID|none| +|»»» deptName|string|false|none|部门名称|none| + +## GET 角色信息详情 + +GET /system/role/{roleId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|roleId|path|string| yes ||角色ID| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "roleId": "1", + "roleName": "管理员", + "roleKey": "admin", + "roleSort": 1, + "dataScope": "1", + "menuCheckStrictly": "1", + "deptCheckStrictly": "1", + "status": "1", + "delFlag": "0", + "createTime": "1682264526399", + "remark": "管理员" + } +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object|true|none||none| +|»» roleId|string|true|none|角色ID|none| +|»» roleName|string|true|none|名称|none| +|»» roleKey|string|true|none|键值|none| +|»» roleSort|integer|true|none|排序|none| +|»» dataScope|string|true|none|数据范围|1：全部数据权限 2：自定数据权限 3：本部门数据权限 4：本部门及以下数据权限 5：仅本人数据权限）| +|»» menuCheckStrictly|string|true|none|菜单树选择项是否关联显示|0：父子不互相关联显示 1：父子互相关联显示| +|»» deptCheckStrictly|string|true|none|部门树选择项是否关联显示|0：父子不互相关联显示 1：父子互相关联显示| +|»» status|string|true|none|角色状态|0停用 1正常| +|»» delFlag|string|true|none|删除标志|0代表存在 1代表删除| +|»» createTime|string|true|none||none| +|»» remark|string|true|none|备注|none| + +## PUT 角色信息修改 + +PUT /system/role + +> Body Parameters + +```json +{ + "roleName": "string", + "roleKey": "string", + "roleSort": 0, + "status": "string", + "remark": "string", + "dataScope": "string", + "menuCheckStrictly": "string", + "menuIds": [ + "string" + ], + "roleId": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» roleName|body|string| yes | 名称|none| +|» roleKey|body|string| yes | 键值|none| +|» roleSort|body|integer| yes | 排序|none| +|» status|body|string| yes | 角色状态|0停用 1正常| +|» remark|body|string| yes | 备注|none| +|» dataScope|body|string| yes | 数据范围|1：全部数据权限 2：自定数据权限 3：本部门数据权限 4：本部门及以下数据权限 5：仅本人数据权限）| +|» menuCheckStrictly|body|string| yes | 菜单树选择项是否关联显示|0：父子不互相关联显示 1：父子互相关联显示| +|» menuIds|body|[string]| yes | 菜单权限|菜单ID数组| +|» roleId|body|string| yes | 角色ID|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "角色修改【xxx】失败，角色名称已存在" +} +``` + +```json +{ + "code": 500, + "msg": "角色修改【xxxx】失败，权限键值已存在" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问角色数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 角色信息新增 + +POST /system/role + +> Body Parameters + +```json +{ + "roleName": "string", + "roleKey": "string", + "roleSort": 0, + "status": "string", + "remark": "string", + "dataScope": "string", + "menuCheckStrictly": "string", + "menuIds": [ + "string" + ] +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» roleName|body|string| yes | 名称|none| +|» roleKey|body|string| yes | 键值|none| +|» roleSort|body|integer| yes | 排序|none| +|» status|body|string| yes | 角色状态|0停用 1正常| +|» remark|body|string| yes | 备注|none| +|» dataScope|body|string| yes | 数据范围|1：全部数据权限 2：自定数据权限 3：本部门数据权限 4：本部门及以下数据权限 5：仅本人数据权限）| +|» menuCheckStrictly|body|string| yes | 菜单树选择项是否关联显示|0：父子不互相关联显示 1：父子互相关联显示| +|» menuIds|body|[string]| yes | 菜单权限|菜单ID数组| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "角色新增【xxxx】失败，角色名称已存在" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## DELETE 角色信息删除 + +DELETE /system/role/{roleIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|roleIds|path|string| yes ||角色ID，多个可用英文逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问角色数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## PUT 角色状态变更 + +PUT /system/role/changeStatus + +> Body Parameters + +```json +{ + "roleId": "string", + "status": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» roleId|body|string| yes | 角色ID|none| +|» status|body|string| no | 状态|0停用 1正常| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问角色数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 角色数据权限修改 + +PUT /system/role/dataScope + +> Body Parameters + +```json +{ + "dataScope": "string", + "deptCheckStrictly": "string", + "menuIds": [ + "string" + ], + "roleId": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» dataScope|body|string| yes | 数据范围|1：全部数据权限 2：自定数据权限 3：本部门数据权限 4：本部门及以下数据权限 5：仅本人数据权限）| +|» deptCheckStrictly|body|string| yes | 部门树选择项是否关联显示|0：父子不互相关联显示 1：父子互相关联显示| +|» menuIds|body|[string]| no | 部门权限|数据范围选择2时必传，部门ID数组| +|» roleId|body|string| yes | 角色ID|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问角色数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 角色列表导出 + +POST /system/role/export + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=role_export_16_1684133344353.xlsx +content-length: 19438 +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +> Body Parameters + +```json +{ + "roleName": "string", + "roleKey": "string", + "status": "string", + "beginTime": "string", + "endTime": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» roleName|body|string| no | 角色名称|none| +|» roleKey|body|string| no | 权限字符|none| +|» status|body|string| no | 状态|0正常 1停用| +|» beginTime|body|string| no | 创建时间-开始|none| +|» endTime|body|string| no | 创建时间-结束|none| + +> Response Examples + +```json +{ + "code": 500, + "msg": "导出数据记录为空" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 角色分配选择授权 + +PUT /system/role/authUser/checked + +> Body Parameters + +```json +{ + "roleId": "string", + "userIds": "string", + "checked": true +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» roleId|body|string| yes | 角色ID|none| +|» userIds|body|string| yes | 用户ID|多个可用英文逗号分隔| +|» checked|body|boolean| yes | 选择操作|添加true 取消false| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问角色数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/系统模块/用户信息 + +## POST 用户信息列表导入模板下载 + +POST /system/user/importTemplate + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=user_import_template_1684230715497.xlsx +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{ + "code": 0, + "msg": "string" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 用户信息列表 + +GET /system/user/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|userName|query|string| no ||用户名称| +|phonenumber|query|string| no ||手机号码| +|status|query|string| no ||状态| +|beginTime|query|string| no ||创建时间-开始| +|endTime|query|string| no ||创建时间-结束| +|deptId|query|string| no ||部门ID| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 1, + "rows": [ + { + "roles": [], + "userId": "2", + "deptId": "105", + "nickName": "普通用户", + "userName": "maskUser", + "email": "maskUser@qq.com", + "avatar": "", + "phonenumber": "13412341234", + "sex": "1", + "status": "1", + "delFlag": "0", + "loginIp": "192.168.56.1", + "loginDate": "1683364764238", + "createBy": "maskAdmin", + "createTime": "1682264526309", + "remark": "普通人员", + "dept": { + "deptId": "105", + "deptName": "测试部门", + "leader": "MASK" + } + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» roles|[string]|true|none|角色ID数组|none| +|»» userId|string|true|none|用户ID|none| +|»» deptId|string¦null|true|none|部门ID|none| +|»» nickName|string|true|none|用户昵称|none| +|»» userName|string|true|none|用户名称|none| +|»» email|string|true|none|邮箱|none| +|»» avatar|string|true|none|头像|none| +|»» phonenumber|string|true|none|电话|none| +|»» sex|string|true|none|性别|0未知 1男 2女| +|»» status|string|true|none|状态|0停用 1正常| +|»» delFlag|string|true|none|是否删除|0代表存在 1代表删除| +|»» loginIp|string|true|none|登录IP|none| +|»» loginDate|string|true|none|登录时间|none| +|»» createBy|string|true|none|创建人|none| +|»» createTime|string|true|none|创建时间|none| +|»» remark|string¦null|true|none|备注|none| +|»» dept|object|true|none|部门信息|none| +|»»» deptId|string¦null|true|none|部门ID|none| +|»»» deptName|string¦null|true|none|部门名称|none| +|»»» leader|string¦null|true|none|负责人|none| + +## GET 用户信息详情 + +GET /system/user/{userId} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|userId|path|string| yes ||用户ID，新增0| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "user": { + "roles": [ + { + "roleId": "2", + "roleName": "普通角色", + "roleKey": "common", + "roleSort": 2, + "dataScope": "2", + "status": "1" + } + ], + "userId": "2", + "deptId": "105", + "userName": "maskUser", + "nickName": "普通用户", + "userType": "sys", + "email": "maskUser@qq.com", + "avatar": "", + "phonenumber": "13412341234", + "sex": "1", + "status": "1", + "delFlag": "0", + "loginIp": "192.168.56.1", + "loginDate": "1683364764238", + "createBy": "maskAdmin", + "createTime": "1682264526309", + "remark": "普通人员", + "dept": { + "deptId": "105", + "parentId": "101", + "ancestors": "0,100,101", + "deptName": "测试部门", + "orderNum": 3, + "leader": "MASK", + "status": "1" + } + }, + "roleIds": [ + "2" + ], + "postIds": [ + "2" + ], + "roles": [ + { + "roleId": "2", + "roleName": "普通角色", + "roleKey": "common", + "roleSort": 2, + "dataScope": "2", + "menuCheckStrictly": "1", + "deptCheckStrictly": "1", + "status": "1", + "delFlag": "0", + "createTime": "1682264526404", + "remark": "普通角色" + } + ], + "posts": [ + { + "postId": "1", + "postCode": "ceo", + "postName": "董事长", + "postSort": 1, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526344", + "remark": "" + }, + { + "postId": "2", + "postCode": "se", + "postName": "项目经理", + "postSort": 2, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526348", + "remark": "" + }, + { + "postId": "3", + "postCode": "hr", + "postName": "人力资源", + "postSort": 3, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526354", + "remark": "" + }, + { + "postId": "4", + "postCode": "user", + "postName": "普通员工", + "postSort": 4, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526358", + "remark": "" + } + ] + } +} +``` + +```json +{ + "code": 200, + "msg": "成功", + "data": { + "user": {}, + "roleIds": [], + "postIds": [], + "roles": [ + { + "roleId": "2", + "roleName": "普通角色", + "roleKey": "common", + "roleSort": 2, + "dataScope": "2", + "menuCheckStrictly": "1", + "deptCheckStrictly": "1", + "status": "1", + "delFlag": "0", + "createTime": "1682264526404", + "remark": "普通角色" + } + ], + "posts": [ + { + "postId": "1", + "postCode": "ceo", + "postName": "董事长", + "postSort": 1, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526344", + "remark": "" + }, + { + "postId": "2", + "postCode": "se", + "postName": "项目经理", + "postSort": 2, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526348", + "remark": "" + }, + { + "postId": "3", + "postCode": "hr", + "postName": "人力资源", + "postSort": 3, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526354", + "remark": "" + }, + { + "postId": "4", + "postCode": "user", + "postName": "普通员工", + "postSort": 4, + "status": "1", + "createBy": "maskAdmin", + "createTime": "1682264526358", + "remark": "" + } + ] + } +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问用户数据" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» data|object¦null|true|none||none| +|»» user|object|true|none|用户信息|none| +|»»» roles|[object]|true|none|角色信息|none| +|»»»» roleId|string|false|none|角色ID|none| +|»»»» roleName|string|false|none|名称|none| +|»»»» roleKey|string|false|none|键值|none| +|»»»» roleSort|integer|false|none|排序|none| +|»»»» dataScope|string|false|none|数据范围|1：全部数据权限 2：自定数据权限 3：本部门数据权限 4：本部门及以下数据权限 5：仅本人数据权限）| +|»»»» status|string|false|none|角色状态|0停用 1正常| +|»»» userId|string|true|none|用户ID|none| +|»»» deptId|string¦null|true|none|部门ID|none| +|»»» userName|string|true|none|用户名称|none| +|»»» nickName|string|true|none|用户昵称|none| +|»»» email|string|true|none|邮箱|none| +|»»» avatar|string|true|none|头像|none| +|»»» phonenumber|string|true|none|电话|none| +|»»» sex|string|true|none|性别|0未知 1男 2女| +|»»» status|string|true|none|状态|0停用 1正常| +|»»» delFlag|string|true|none|是否删除|0代表存在 1代表删除| +|»»» loginIp|string|true|none|登录IP|none| +|»»» loginDate|string|true|none|登录时间|none| +|»»» createBy|string|true|none|创建人|none| +|»»» createTime|string|true|none|创建时间|none| +|»»» remark|string¦null|true|none|备注|none| +|»»» dept|object|true|none|部门信息|none| +|»»»» deptId|string|true|none|部门ID|none| +|»»»» parentId|string|true|none|父部门ID|none| +|»»»» ancestors|string|true|none|祖级列表|none| +|»»»» deptName|string|true|none|部门名称|none| +|»»»» orderNum|integer|true|none|显示顺序|none| +|»»»» leader|string|true|none|负责人|none| +|»»»» status|string|true|none|部门状态|0正常 1停用| +|»»»» phone|string|false|none|联系电话|none| +|»»»» email|string|false|none|邮箱|none| +|»» roleIds|[string]|true|none|已选角色ID|none| +|»» postIds|[string]|true|none|已选岗位ID|none| +|»» roles|[object]|true|none|角色信息数组|none| +|»»» roleId|string|true|none|角色ID|none| +|»»» roleName|string|true|none|名称|none| +|»»» roleKey|string|true|none|键值|none| +|»»» roleSort|integer|true|none|排序|none| +|»»» dataScope|string|true|none|数据范围|1：全部数据权限 2：自定数据权限 3：本部门数据权限 4：本部门及以下数据权限 5：仅本人数据权限）| +|»»» menuCheckStrictly|string|true|none|菜单树选择项是否关联显示|0：父子不互相关联显示 1：父子互相关联显示| +|»»» deptCheckStrictly|string|true|none|部门树选择项是否关联显示|0：父子不互相关联显示 1：父子互相关联显示| +|»»» status|string|true|none|角色状态|0停用 1正常| +|»»» delFlag|string|true|none|删除标志|0代表存在 1代表删除| +|»»» createTime|string|true|none||none| +|»»» remark|string|true|none|备注|none| +|»» posts|[object]|true|none|岗位信息数组|none| +|»»» postId|string|true|none|岗位ID|none| +|»»» postCode|string|true|none|编码|none| +|»»» postName|string|true|none|名称|none| +|»»» postSort|integer|true|none|排序|none| +|»»» status|string|true|none|状态|none| +|»»» createBy|string|true|none||none| +|»»» createTime|string|true|none||none| +|»»» remark|string|true|none|备注|none| + +## POST 用户信息新增 + +POST /system/user + +> Body Parameters + +```json +{ + "remark": "去只传周物给", + "deptId": 102, + "nickName": "龙杰", + "email": "h.vrcjiz@qcfgqedxw.bz", + "phonenumber": "18641692257", + "sex": "0", + "status": "1", + "roleIds": [ + 2 + ], + "postIds": [ + 1, + 2, + 3, + 4 + ], + "userName": "gijobqebs", + "password": "123456" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» userName|body|string| yes | 用户名称|none| +|» password|body|string| yes | 用户密码|none| +|» nickName|body|string| yes | 用户昵称|none| +|» email|body|string| yes | 邮箱|none| +|» phonenumber|body|string| yes | 电话|none| +|» sex|body|string| yes | 性别|0未知 1男 2女| +|» status|body|string| yes | 状态|0停用 1正常| +|» remark|body|string| yes | 备注|none| +|» deptId|body|string| yes | 部门ID|none| +|» roleIds|body|[string]| yes | 角色ID数组|none| +|» postIds|body|[string]| yes | 岗位ID数组|none| +|» userType|body|string| no | 用户类型|sys系统用户| +|» avatar|body|string| no | 头像|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +```json +{ + "code": 500, + "msg": "新增用户【xxxx】失败，登录账号已存在" +} +``` + +```json +{ + "code": 500, + "msg": "新增用户【xxxx】失败，手机号码已存在" +} +``` + +```json +{ + "code": 500, + "msg": "新增用户【zwciugaw2】失败，邮箱已存在" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## PUT 用户信息修改 + +PUT /system/user + +> Body Parameters + +```json +{ + "remark": "群劳设着给王", + "deptId": 80, + "nickName": "许芳", + "email": "x.swtaf@oypeubb.tg", + "phonenumber": "18106129309", + "sex": "1", + "status": "1", + "roleIds": [ + 2 + ], + "postIds": [ + 2 + ], + "userId": "101", + "userName": "x34bvpi" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» userId|body|string| yes | 用户ID|none| +|» userName|body|string| yes | 用户名称|none| +|» nickName|body|string| yes | 用户昵称|none| +|» email|body|string| yes | 邮箱|none| +|» phonenumber|body|string| yes | 电话|none| +|» sex|body|string| yes | 性别|0未知 1男 2女| +|» status|body|string| yes | 状态|0停用 1正常| +|» remark|body|string| yes | 备注|none| +|» deptId|body|string| yes | 部门ID|none| +|» roleIds|body|[string]| yes | 角色ID数组|none| +|» postIds|body|[string]| yes | 岗位ID数组|none| +|» userType|body|string| no | 用户类型|sys系统用户| +|» avatar|body|string| no | 头像|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +```json +{ + "code": 500, + "msg": "修改用户【xxx】失败，手机号码已存在" +} +``` + +```json +{ + "code": 500, + "msg": "修改用户【liming】失败，登录账号已存在" +} +``` + +```json +{ + "code": 500, + "msg": "修改用户【xxx】失败，邮箱已存在" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 用户信息列表导出 + +POST /system/user/export + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=user_export_11_1684230271701.xlsx +content-length: 21499 +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +> Body Parameters + +```json +{ + "userName": "string", + "phonenumber": "string", + "status": "string", + "beginTime": "string", + "endTime": "string", + "deptId": "string", + "pageNum": 0, + "pageSize": 0 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» userName|body|string| no | 用户名称|none| +|» phonenumber|body|string| no | 手机号码|none| +|» status|body|string| no | 状态|0停用 1正常| +|» beginTime|body|string| no | 创建开始时间|none| +|» endTime|body|string| no | 创建结束时间|none| +|» deptId|body|string| no | 部门ID|none| +|» pageNum|body|number| yes | 页数，默认1|none| +|» pageSize|body|number| yes | 单页记录数，默认10|none| + +> Response Examples + +```json +{ + "code": 500, + "msg": "导出数据记录为空" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## POST 用户信息列表导入 + +POST /system/user/importData + +> Body Parameters + +```yaml +file: [] +updateSupport: "{% mock 'pick' , ['false','true'] %}" + +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» file|body|string(binary)| no ||导入xls、xlsx表格文件| +|» updateSupport|body|string| no ||是否更新已经存在的数据，默认false| + +> Response Examples + +```json +{ + "code": 200, + "msg": "恭喜您，数据已全部导入成功！共 1 条，数据如下：
序号：1 登录名称 user001 导入成功" +} +``` + +```json +{ + "code": 200, + "msg": "恭喜您，数据已全部导入成功！共 0 条，数据如下：" +} +``` + +```json +{ + "code": 200, + "msg": "恭喜您，数据已全部导入成功！共 1 条，数据如下：
序号：1 登录名称 user001 更新成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +```json +{ + "code": 500, + "msg": "很抱歉，导入失败！共 5 条数据格式不正确，错误如下：
表格中必填列表项，登录名称、用户名称
表格中必填列表项，登录名称、用户名称
表格中必填列表项，登录名称、用户名称
表格中必填列表项，登录名称、用户名称
表格中必填列表项，登录名称、用户名称" +} +``` + +```json +{ + "code": 500, + "msg": "导入用户数据不能为空！" +} +``` + +```json +{ + "code": 500, + "msg": "上传文件类型不支持，仅支持以下类型：xls,xlsx" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 用户信息删除 + +DELETE /system/user/{userIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|userIds|path|string| yes ||用户ID，多个用英文逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问用户数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 用户重置密码 + +PUT /system/user/resetPwd + +> Body Parameters + +```json +{ + "password": "string", + "userId": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» password|body|string| yes | 密码|none| +|» userId|body|string| yes | 用户ID|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问用户数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 用户状态修改 + +PUT /system/user/changeStatus + +> Body Parameters + +```json +{ + "status": "string", + "userId": "string" +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» status|body|string| yes | 状态|0停用 1正常| +|» userId|body|string| yes | 用户ID|none| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "没有权限访问用户数据！" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/系统模块/系统日志/操作日志信息 + +## GET 操作日志列表 + +GET /system/log/operate/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|title|query|string| no ||操作模块名称| +|operName|query|string| no ||操作人员名称| +|businessType|query|string| no ||操作类型| +|status|query|string| no ||操作状态| +|beginTime|query|string| no ||操作开始时间| +|endTime|query|string| no ||操作结束时间| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 125, + "rows": [ + { + "operId": "224", + "title": "通知公告信息", + "businessType": "3", + "method": "SysNoticeController.remove()", + "requestMethod": "DELETE", + "operatorType": "1", + "operName": "maskAdmin", + "deptName": "研发部门", + "operUrl": "/system/notice/17", + "operIp": "127.0.0.1", + "operLocation": "内网IP", + "operParam": "{}", + "operMsg": "{\"code\":200,\"msg\":\"成功\"}", + "status": "1", + "operTime": "1684071705357" + }, + { + "operId": "223", + "title": "通知公告信息", + "businessType": "1", + "method": "SysNoticeController.add()", + "requestMethod": "POST", + "operatorType": "1", + "operName": "maskAdmin", + "deptName": "研发部门", + "operUrl": "/system/notice", + "operIp": "127.0.0.1", + "operLocation": "内网IP", + "operParam": "{\"noticeTitle\":\"常员报情\",\"noticeType\":\"1\",\"noticeContent\":\"记月为认交叫次去铁亲基天会产。气深情问值约于严火更思目部光交。在目部深效五己运设接本报资。论型治感标消当期再件始军品团命院写结。\",\"status\":\"1\"}", + "operMsg": "{\"code\":200,\"msg\":\"成功\"}", + "status": "1", + "operTime": "1684071683254" + }, + { + "operId": "222", + "title": "通知公告信息", + "businessType": "1", + "method": "SysNoticeController.add()", + "requestMethod": "POST", + "operatorType": "1", + "operName": "maskAdmin", + "deptName": "研发部门", + "operUrl": "/system/notice", + "operIp": "127.0.0.1", + "operLocation": "内网IP", + "operParam": "{\"noticeTitle\":\"常员报情\",\"noticeType\":\"1\",\"noticeContent\":\"记月为认交叫次去铁亲基天会产。气深情问值约于严火更思目部光交。在目部深效五己运设接本报资。论型治感标消当期再件始军品团命院写结。\",\"status\":\"1\"}", + "operMsg": "{\"code\":200,\"msg\":\"成功\"}", + "status": "1", + "operTime": "1684071682157" + }, + { + "operId": "221", + "title": "通知公告信息", + "businessType": "3", + "method": "SysNoticeController.remove()", + "requestMethod": "DELETE", + "operatorType": "1", + "operName": "maskAdmin", + "deptName": "研发部门", + "operUrl": "/system/notice/201", + "operIp": "127.0.0.1", + "operLocation": "内网IP", + "operParam": "{}", + "operMsg": "{\"code\":500,\"msg\":\"失败\"}", + "status": "0", + "operTime": "1684071669833" + }, + { + "operId": "220", + "title": "通知公告信息", + "businessType": "3", + "method": "SysNoticeController.remove()", + "requestMethod": "DELETE", + "operatorType": "1", + "operName": "maskAdmin", + "deptName": "研发部门", + "operUrl": "/system/notice/11,12,13", + "operIp": "127.0.0.1", + "operLocation": "内网IP", + "operParam": "{}", + "operMsg": "{\"code\":200,\"msg\":\"成功\"}", + "status": "1", + "operTime": "1684071570065" + }, + { + "operId": "219", + "title": "通知公告信息", + "businessType": "3", + "method": "SysNoticeController.remove()", + "requestMethod": "DELETE", + "operatorType": "1", + "operName": "maskAdmin", + "deptName": "研发部门", + "operUrl": "/system/notice/7,58,96,8,45", + "operIp": "127.0.0.1", + "operLocation": "内网IP", + "operParam": "{}", + "operMsg": "{\"code\":500,\"msg\":\"失败\"}", + "status": "0", + "operTime": "1684071537536" + }, + { + "operId": "218", + "title": "通知公告信息", + "businessType": "1", + "method": "SysNoticeController.add()", + "requestMethod": "POST", + "operatorType": "1", + "operName": "maskAdmin", + "deptName": "研发部门", + "operUrl": "/system/notice", + "operIp": "127.0.0.1", + "operLocation": "内网IP", + "operParam": "{\"noticeTitle\":\"常员报情\",\"noticeType\":\"1\",\"noticeContent\":\"记月为认交叫次去铁亲基天会产。气深情问值约于严火更思目部光交。在目部深效五己运设接本报资。论型治感标消当期再件始军品团命院写结。\",\"status\":\"1\"}", + "operMsg": "{\"code\":200,\"msg\":\"成功\"}", + "status": "1", + "operTime": "1684071459926" + }, + { + "operId": "217", + "title": "通知公告信息", + "businessType": "1", + "method": "SysNoticeController.add()", + "requestMethod": "POST", + "operatorType": "1", + "operName": "maskAdmin", + "deptName": "研发部门", + "operUrl": "/system/notice", + "operIp": "127.0.0.1", + "operLocation": "内网IP", + "operParam": "{\"noticeTitle\":\"结西基\",\"noticeType\":\"2\",\"noticeContent\":\"运素元低角工老风三易切员火组干。任下极你部万利求听在这年。见准需东经布资张口动太领员本。引果历常高划党却分造行火九影。干强百历但所可存各拉技白广强日如定提。整次段得受都着维东转律自化。\",\"status\":\"0\"}", + "operMsg": "{\"code\":200,\"msg\":\"成功\"}", + "status": "1", + "operTime": "1684071429311" + }, + { + "operId": "216", + "title": "通知公告信息", + "businessType": "1", + "method": "SysNoticeController.add()", + "requestMethod": "POST", + "operatorType": "1", + "operName": "maskAdmin", + "deptName": "研发部门", + "operUrl": "/system/notice", + "operIp": "127.0.0.1", + "operLocation": "内网IP", + "operParam": "{\"noticeTitle\":\"结西基\",\"noticeType\":\"2\",\"noticeContent\":\"运素元低角工老风三易切员火组干。任下极你部万利求听在这年。见准需东经布资张口动太领员本。引果历常高划党却分造行火九影。干强百历但所可存各拉技白广强日如定提。整次段得受都着维东转律自化。\",\"status\":\"0\"}", + "operMsg": "{\"code\":200,\"msg\":\"成功\"}", + "status": "1", + "operTime": "1684071426784" + }, + { + "operId": "215", + "title": "通知公告信息", + "businessType": "1", + "method": "SysNoticeController.add()", + "requestMethod": "POST", + "operatorType": "1", + "operName": "maskAdmin", + "deptName": "研发部门", + "operUrl": "/system/notice", + "operIp": "127.0.0.1", + "operLocation": "内网IP", + "operParam": "{\"noticeTitle\":\"结西基\",\"noticeType\":\"2\",\"noticeContent\":\"运素元低角工老风三易切员火组干。任下极你部万利求听在这年。见准需东经布资张口动太领员本。引果历常高划党却分造行火九影。干强百历但所可存各拉技白广强日如定提。整次段得受都着维东转律自化。\",\"status\":\"0\"}", + "operMsg": "{\"code\":200,\"msg\":\"成功\"}", + "status": "1", + "operTime": "1684071419755" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» operId|string|true|none||none| +|»» title|string|true|none||none| +|»» businessType|string|true|none||none| +|»» method|string|true|none||none| +|»» requestMethod|string|true|none||none| +|»» operatorType|string|true|none|操作类型|字典类型中配置| +|»» operName|string|true|none|操作人名称|none| +|»» deptName|string|true|none|操作人部门|none| +|»» operUrl|string|true|none||none| +|»» operIp|string|true|none|IP地址|none| +|»» operLocation|string|true|none|IP地区|none| +|»» operParam|string|true|none|请求参数|none| +|»» operMsg|string|true|none|操作信息|none| +|»» status|string|true|none|状态|none| +|»» operTime|string|true|none|时间|none| +|»» costTime|string|true|none|消耗时间（毫秒）|none| + +## POST 操作日志列表导出 + +POST /system/log/operate/export + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=operlog_export_20_1684073261184.xlsx +content-length: 36500 +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +> Body Parameters + +```json +{ + "title": "string", + "operName": "string", + "businessType": "string", + "status": "string", + "beginTime": "string", + "endTime": "string", + "pageNum": 0, + "pageSize": 0 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» title|body|string| no | 操作模块名称|none| +|» operName|body|string| no | 操作人员名称|none| +|» businessType|body|string| no | 操作类型|none| +|» status|body|string| no | 操作状态|none| +|» beginTime|body|string| no | 操作开始时间|none| +|» endTime|body|string| no | 操作结束时间|none| +|» pageNum|body|number| yes | 页数，默认1|none| +|» pageSize|body|number| yes | 单页记录数，默认10|none| + +> Response Examples + +```json +{ + "code": 500, + "msg": "导出数据记录为空" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 操作日志清空 + +DELETE /system/log/operate/clean + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 操作日志删除 + +DELETE /system/log/operate/{operIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|operIds|path|string| yes ||操作日志ID，多个可用英文逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/系统模块/系统日志/登录访问信息 + +## GET 登录访问列表 + +GET /system/log/login/list + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|ipaddr|query|string| no ||登录地址ip| +|userName|query|string| no ||用户名称| +|status|query|string| no ||登录状态 0失败 1成功| +|beginTime|query|string| no ||登录开始时间| +|endTime|query|string| no ||登录结束时间| +|pageNum|query|number| no ||Page number，default 1| +|pageSize|query|number| no ||Size of one page，default 10| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功", + "total": 130, + "rows": [ + { + "infoId": "119", + "userName": "maskAdmin", + "ipaddr": "127.0.0.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "status": "1", + "msg": "登录成功", + "loginTime": "1683370928996" + }, + { + "infoId": "118", + "userName": "liming", + "ipaddr": "127.0.0.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "status": "1", + "msg": "退出成功", + "loginTime": "1683370924042" + }, + { + "infoId": "117", + "userName": "liming", + "ipaddr": "127.0.0.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "status": "1", + "msg": "登录成功", + "loginTime": "1683370402328" + }, + { + "infoId": "116", + "userName": "liming", + "ipaddr": "127.0.0.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "status": "1", + "msg": "注册成功", + "loginTime": "1683370382877" + }, + { + "infoId": "115", + "userName": "maskAdmin", + "ipaddr": "127.0.0.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "status": "1", + "msg": "退出成功", + "loginTime": "1683370352406" + }, + { + "infoId": "114", + "userName": "maskAdmin", + "ipaddr": "192.168.56.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "status": "1", + "msg": "登录成功", + "loginTime": "1683364801882" + }, + { + "infoId": "113", + "userName": "maskUser", + "ipaddr": "192.168.56.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "status": "1", + "msg": "退出成功", + "loginTime": "1683364794403" + }, + { + "infoId": "112", + "userName": "maskUser", + "ipaddr": "192.168.56.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "status": "1", + "msg": "登录成功", + "loginTime": "1683364764244" + }, + { + "infoId": "111", + "userName": "wangdf", + "ipaddr": "192.168.56.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "status": "1", + "msg": "注册成功", + "loginTime": "1683364746502" + }, + { + "infoId": "110", + "userName": "maskAdmin", + "ipaddr": "192.168.56.1", + "loginLocation": "内网IP", + "browser": "Chrome 86.0.4240.198", + "os": "Windows 10", + "status": "1", + "msg": "退出成功", + "loginTime": "1683364727385" + } + ] +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| +|» total|integer|true|none||none| +|» rows|[object]|true|none||none| +|»» infoId|string|true|none|登录记录ID|none| +|»» userName|string|true|none|登录用户名称|none| +|»» ipaddr|string|true|none|IP地址|none| +|»» loginLocation|string|true|none|IP地区|none| +|»» browser|string|true|none|浏览器|none| +|»» os|string|true|none|操作系统|none| +|»» status|string|true|none|状态|0失败 1成功| +|»» msg|string|true|none|操作行为|none| +|»» loginTime|string|true|none|登录时间|none| + +## POST 登录访问列表导出 + +POST /system/log/login/export + +正常返回文件流，响应头如下 + +```text +content-disposition: attachment;filename=logininfor_export_124_1684076929742.xlsx +content-length: 24305 +content-type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet +``` + +> Body Parameters + +```json +{ + "ipaddr": "string", + "userName": "string", + "status": "string", + "beginTime": "string", + "endTime": "string", + "pageNum": 0, + "pageSize": 0 +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» ipaddr|body|string| no | 登录地址ip|none| +|» userName|body|string| no | 用户名称|none| +|» status|body|string| no | 登录状态|0失败 1成功| +|» beginTime|body|string| no | 登录开始时间|none| +|» endTime|body|string| no | 登录结束时间|none| +|» pageNum|body|number| yes | 页数，默认1|none| +|» pageSize|body|number| yes | 单页记录数，默认10|none| + +> Response Examples + +```json +{ + "code": 500, + "msg": "导出数据记录为空" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 登录访问清空 + +DELETE /system/log/login/clean + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## PUT 登录访问账户解锁 + +PUT /system/log/login/{userName} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|userName|path|string| yes ||登录用户名| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## DELETE 登录访问删除 + +DELETE /system/log/login/{loginIds} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|loginIds|path|string| yes ||日志ID，多个可用英文逗号分隔| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 200, + "msg": "成功" +} +``` + +```json +{ + "code": 500, + "msg": "失败" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/图表模块/G6关系图 + +## GET 获取图数据 + +GET /chart/graph + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|group|query|string| yes ||关系图组名称| +|type|query|string| no ||组内类型 | +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## POST 保存图数据 + +POST /chart/graph + +> Body Parameters + +```json +{ + "group": "neGG", + "data": { + "nodes": [ + { + "id": "AMF", + "comboId": "", + "x": -194, + "y": -147, + "type": "rect", + "size": [ + 80, + 40 + ], + "anchorPoints": false, + "style": { + "active": { + "fill": "rgb(247, 250, 255)", + "stroke": "rgb(95, 149, 255)", + "lineWidth": 2, + "shadowColor": "rgb(95, 149, 255)", + "shadowBlur": 10 + }, + "selected": { + "fill": "rgb(255, 255, 255)", + "stroke": "rgb(95, 149, 255)", + "lineWidth": 4, + "shadowColor": "rgb(95, 149, 255)", + "shadowBlur": 10, + "text-shape": { + "fontWeight": 500 + } + }, + "highlight": { + "fill": "rgb(223, 234, 255)", + "stroke": "#4572d9", + "lineWidth": 2, + "text-shape": { + "fontWeight": 500 + } + }, + "inactive": { + "fill": "rgb(247, 250, 255)", + "stroke": "rgb(191, 213, 255)", + "lineWidth": 1 + }, + "disable": { + "fill": "rgb(250, 250, 250)", + "stroke": "rgb(224, 224, 224)", + "lineWidth": 1 + }, + "radius": 4, + "stroke": "#f33535", + "lineWidth": 1, + "cursor": "pointer", + "fill": "#902323" + }, + "label": "AMF", + "labelCfg": { + "position": "right", + "offset": 0, + "style": { + "fill": "#fff0f0", + "fontSize": 12, + "fontWeight": 500 + } + }, + "icon": { + "show": false, + "img": "/svg/service.svg", + "width": 25, + "height": 25, + "offset": 20 + }, + "direction": "up" + }, + { + "id": "SMF", + "comboId": "", + "x": -290, + "y": 32, + "type": "triangle", + "size": 30, + "anchorPoints": false, + "style": { + "active": { + "fill": "rgb(247, 250, 255)", + "stroke": "rgb(95, 149, 255)", + "lineWidth": 2, + "shadowColor": "rgb(95, 149, 255)", + "shadowBlur": 10 + }, + "selected": { + "fill": "rgb(255, 255, 255)", + "stroke": "rgb(95, 149, 255)", + "lineWidth": 4, + "shadowColor": "rgb(95, 149, 255)", + "shadowBlur": 10, + "text-shape": { + "fontWeight": 500 + } + }, + "highlight": { + "fill": "rgb(223, 234, 255)", + "stroke": "#4572d9", + "lineWidth": 2, + "text-shape": { + "fontWeight": 500 + } + }, + "inactive": { + "fill": "rgb(247, 250, 255)", + "stroke": "rgb(191, 213, 255)", + "lineWidth": 1 + }, + "disable": { + "fill": "rgb(250, 250, 250)", + "stroke": "rgb(224, 224, 224)", + "lineWidth": 1 + }, + "radius": 4, + "stroke": "#8b3232", + "lineWidth": 1, + "cursor": "pointer", + "fill": "#7e2020" + }, + "label": "SMF", + "labelCfg": { + "position": "bottom", + "offset": 0, + "style": { + "fill": "#cc7171", + "fontSize": 12, + "fontWeight": 500 + } + }, + "direction": "up", + "icon": { + "show": false, + "img": "/svg/service.svg", + "width": 25, + "height": 25, + "offset": 20 + } + }, + { + "id": "UDM", + "comboId": "k", + "x": 165, + "y": -5, + "type": "ellipse", + "size": [ + 40, + 30 + ], + "anchorPoints": false, + "style": { + "radius": 4, + "stroke": "#52e0c9", + "lineWidth": 2, + "cursor": "pointer", + "fill": "#ffcccc" + }, + "label": "UDM", + "labelCfg": { + "position": "center", + "offset": 0, + "style": { + "fill": "#318fbf", + "fontSize": 12, + "fontWeight": 500 + } + }, + "direction": "up", + "icon": { + "show": true, + "img": "/svg/service.svg", + "width": 25, + "height": 25, + "offset": 20 + }, + "depth": 12 + }, + { + "id": "UPF", + "comboId": "k", + "x": 2, + "y": 59, + "type": "image", + "size": [ + 30, + 30 + ], + "anchorPoints": false, + "label": "UPF", + "labelCfg": { + "position": "center", + "offset": 0, + "style": { + "fill": "#b92727", + "fontSize": 12, + "fontWeight": 500 + } + }, + "direction": "up", + "icon": { + "show": true, + "img": "/svg/service.svg", + "width": 25, + "height": 25, + "offset": 20 + }, + "img": "/svg/service.svg", + "clipCfg": { + "show": true, + "width": 0, + "height": 0, + "type": "circle" + }, + "style": { + "radius": 4, + "stroke": "#ffffff", + "lineWidth": 1, + "cursor": "pointer" + }, + "depth": 11 + } + ], + "edges": [ + { + "id": "AMF~1704176260916~SMF", + "source": "AMF", + "target": "SMF", + "type": "polyline", + "style": { + "offset": 20, + "radius": 2, + "stroke": "#ffd500", + "lineWidth": 4, + "cursor": "pointer", + "active": { + "stroke": "rgb(95, 149, 255)", + "lineWidth": 1 + }, + "selected": { + "stroke": "rgb(95, 149, 255)", + "lineWidth": 2, + "shadowColor": "rgb(95, 149, 255)", + "shadowBlur": 10, + "text-shape": { + "fontWeight": 500 + } + }, + "highlight": { + "stroke": "rgb(95, 149, 255)", + "lineWidth": 2, + "text-shape": { + "fontWeight": 500 + } + }, + "inactive": { + "stroke": "rgb(234, 234, 234)", + "lineWidth": 1 + }, + "disable": { + "stroke": "rgb(245, 245, 245)", + "lineWidth": 1 + }, + "endArrow": true + }, + "label": "3分3发", + "labelCfg": { + "refX": 0, + "refY": 0, + "position": "middle", + "autoRotate": false, + "style": { + "fill": "#e73636", + "fontSize": 12, + "fontWeight": 500 + } + }, + "startPoint": { + "x": -234.5, + "y": -147, + "anchorIndex": 0, + "id": "-234.5|||-147" + }, + "endPoint": { + "x": -275.50545794061196, + "y": 4.90120389771695, + "id": "-275.50545794061196|||4.90120389771695" + } + }, + { + "id": "AMF~1704176447324~k", + "source": "AMF", + "target": "k", + "type": "polyline", + "style": { + "active": { + "stroke": "rgb(95, 149, 255)", + "lineWidth": 1 + }, + "selected": { + "stroke": "rgb(95, 149, 255)", + "lineWidth": 2, + "shadowColor": "rgb(95, 149, 255)", + "shadowBlur": 10, + "text-shape": { + "fontWeight": 500 + } + }, + "highlight": { + "stroke": "rgb(95, 149, 255)", + "lineWidth": 2, + "text-shape": { + "fontWeight": 500 + } + }, + "inactive": { + "stroke": "rgb(234, 234, 234)", + "lineWidth": 1 + }, + "disable": { + "stroke": "rgb(245, 245, 245)", + "lineWidth": 1 + }, + "offset": 20, + "radius": 2, + "stroke": "#ff5900", + "lineWidth": 4, + "cursor": "pointer", + "endArrow": true + }, + "label": "签文本及其配", + "labelCfg": { + "refX": 0, + "refY": 0, + "position": "middle", + "autoRotate": false, + "style": { + "fill": "#bd1f1f", + "fontSize": 12, + "fontWeight": 500 + } + }, + "isComboEdge": true, + "startPoint": { + "x": -153.5, + "y": -147, + "anchorIndex": 1, + "id": "-153.5|||-147" + }, + "endPoint": { + "x": -43.5, + "y": 26.5, + "anchorIndex": 0, + "id": "-43.5|||26.5" + } + } + ], + "combos": [ + { + "id": "k", + "type": "rect", + "size": [ + 40, + 40 + ], + "padding": [ + 30, + 30, + 30, + 30 + ], + "style": { + "active": { + "stroke": "rgb(95, 149, 255)", + "lineWidth": 1, + "fill": "rgb(247, 250, 255)" + }, + "selected": { + "stroke": "rgb(95, 149, 255)", + "lineWidth": 2, + "fill": "rgb(253, 253, 253)", + "shadowColor": "rgb(95, 149, 255)", + "shadowBlur": 10, + "text-shape": { + "fontWeight": 500 + } + }, + "highlight": { + "stroke": "#4572d9", + "lineWidth": 2, + "fill": "rgb(253, 253, 253)", + "text-shape": { + "fontWeight": 500 + } + }, + "inactive": { + "stroke": "rgb(224, 224, 224)", + "fill": "rgb(253, 253, 253)", + "lineWidth": 1 + }, + "disable": { + "stroke": "rgb(234, 234, 234)", + "fill": "rgb(250, 250, 250)", + "lineWidth": 1 + }, + "radius": 2, + "fill": "#ffffff", + "stroke": "#ffffff", + "lineWidth": 1, + "cursor": "grab", + "fillOpacity": 0.5, + "r": 99.5, + "width": 199, + "height": 95 + }, + "label": "标签文本及其配置", + "labelCfg": { + "refX": 10, + "refY": 10, + "position": "top", + "style": { + "fill": "#b93131", + "fontSize": 12, + "fontWeight": 500 + } + }, + "children": [ + { + "id": "UDM", + "comboId": "k", + "itemType": "node", + "depth": 12 + }, + { + "id": "UPF", + "comboId": "k", + "itemType": "node", + "depth": 12 + } + ], + "depth": 10, + "x": 86.5, + "y": 26.5 + } + ] + } +} +``` + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| +|body|body|object| no ||none| +|» group|body|string| yes ||none| +|» data|body|object| yes ||none| +|»» nodes|body|[object]| yes ||none| +|»»» id|body|string| yes ||none| +|»»» comboId|body|string| yes ||none| +|»»» x|body|integer| yes ||none| +|»»» y|body|integer| yes ||none| +|»»» type|body|string| yes ||none| +|»»» size|body|[integer]| yes ||none| +|»»» anchorPoints|body|boolean| yes ||none| +|»»» style|body|object| yes ||none| +|»»»» active|body|object| no ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»»» shadowColor|body|string| yes ||none| +|»»»»» shadowBlur|body|integer| yes ||none| +|»»»» selected|body|object| no ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»»» shadowColor|body|string| yes ||none| +|»»»»» shadowBlur|body|integer| yes ||none| +|»»»»» text-shape|body|object| yes ||none| +|»»»»»» fontWeight|body|integer| yes ||none| +|»»»» highlight|body|object| no ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»»» text-shape|body|object| yes ||none| +|»»»»»» fontWeight|body|integer| yes ||none| +|»»»» inactive|body|object| no ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»» disable|body|object| no ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»» radius|body|integer| yes ||none| +|»»»» stroke|body|string| yes ||none| +|»»»» lineWidth|body|integer| yes ||none| +|»»»» cursor|body|string| yes ||none| +|»»»» fill|body|string| no ||none| +|»»» label|body|string| yes ||none| +|»»» labelCfg|body|object| yes ||none| +|»»»» position|body|string| yes ||none| +|»»»» offset|body|integer| yes ||none| +|»»»» style|body|object| yes ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» fontSize|body|integer| yes ||none| +|»»»»» fontWeight|body|integer| yes ||none| +|»»» icon|body|object| yes ||none| +|»»»» show|body|boolean| yes ||none| +|»»»» img|body|string| yes ||none| +|»»»» width|body|integer| yes ||none| +|»»»» height|body|integer| yes ||none| +|»»»» offset|body|integer| yes ||none| +|»»» direction|body|string| yes ||none| +|»»» depth|body|integer| yes ||none| +|»»» img|body|string| no ||none| +|»»» clipCfg|body|object| no ||none| +|»»»» show|body|boolean| yes ||none| +|»»»» width|body|integer| yes ||none| +|»»»» height|body|integer| yes ||none| +|»»»» type|body|string| yes ||none| +|»» edges|body|[object]| yes ||none| +|»»» id|body|string| yes ||none| +|»»» source|body|string| yes ||none| +|»»» target|body|string| yes ||none| +|»»» type|body|string| yes ||none| +|»»» style|body|object| yes ||none| +|»»»» offset|body|integer| yes ||none| +|»»»» radius|body|integer| yes ||none| +|»»»» stroke|body|string| yes ||none| +|»»»» lineWidth|body|integer| yes ||none| +|»»»» cursor|body|string| yes ||none| +|»»»» active|body|object| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»» selected|body|object| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»»» shadowColor|body|string| yes ||none| +|»»»»» shadowBlur|body|integer| yes ||none| +|»»»»» text-shape|body|object| yes ||none| +|»»»»»» fontWeight|body|integer| yes ||none| +|»»»» highlight|body|object| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»»» text-shape|body|object| yes ||none| +|»»»»»» fontWeight|body|integer| yes ||none| +|»»»» inactive|body|object| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»» disable|body|object| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»» endArrow|body|boolean| yes ||none| +|»»» label|body|string| yes ||none| +|»»» labelCfg|body|object| yes ||none| +|»»»» refX|body|integer| yes ||none| +|»»»» refY|body|integer| yes ||none| +|»»»» position|body|string| yes ||none| +|»»»» autoRotate|body|boolean| yes ||none| +|»»»» style|body|object| yes ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» fontSize|body|integer| yes ||none| +|»»»»» fontWeight|body|integer| yes ||none| +|»»» startPoint|body|object| yes ||none| +|»»»» x|body|number| yes ||none| +|»»»» y|body|integer| yes ||none| +|»»»» anchorIndex|body|integer| yes ||none| +|»»»» id|body|string| yes ||none| +|»»» endPoint|body|object| yes ||none| +|»»»» x|body|number| yes ||none| +|»»»» y|body|number| yes ||none| +|»»»» id|body|string| yes ||none| +|»»»» anchorIndex|body|integer| yes ||none| +|»»» isComboEdge|body|boolean| no ||none| +|»» combos|body|[object]| yes ||none| +|»»» id|body|string| no ||none| +|»»» type|body|string| no ||none| +|»»» size|body|[integer]| no ||none| +|»»» padding|body|[integer]| no ||none| +|»»» style|body|object| no ||none| +|»»»» active|body|object| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»»» fill|body|string| yes ||none| +|»»»» selected|body|object| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» shadowColor|body|string| yes ||none| +|»»»»» shadowBlur|body|integer| yes ||none| +|»»»»» text-shape|body|object| yes ||none| +|»»»»»» fontWeight|body|integer| yes ||none| +|»»»» highlight|body|object| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» text-shape|body|object| yes ||none| +|»»»»»» fontWeight|body|integer| yes ||none| +|»»»» inactive|body|object| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»» disable|body|object| yes ||none| +|»»»»» stroke|body|string| yes ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» lineWidth|body|integer| yes ||none| +|»»»» radius|body|integer| yes ||none| +|»»»» fill|body|string| yes ||none| +|»»»» stroke|body|string| yes ||none| +|»»»» lineWidth|body|integer| yes ||none| +|»»»» cursor|body|string| yes ||none| +|»»»» fillOpacity|body|number| yes ||none| +|»»»» r|body|number| yes ||none| +|»»»» width|body|integer| yes ||none| +|»»»» height|body|integer| yes ||none| +|»»» label|body|string| no ||none| +|»»» labelCfg|body|object| no ||none| +|»»»» refX|body|integer| yes ||none| +|»»»» refY|body|integer| yes ||none| +|»»»» position|body|string| yes ||none| +|»»»» style|body|object| yes ||none| +|»»»»» fill|body|string| yes ||none| +|»»»»» fontSize|body|integer| yes ||none| +|»»»»» fontWeight|body|integer| yes ||none| +|»»» children|body|[object]| no ||none| +|»»»» id|body|string| yes ||none| +|»»»» comboId|body|string| yes ||none| +|»»»» itemType|body|string| yes ||none| +|»»»» depth|body|integer| yes ||none| +|»»» depth|body|integer| no ||none| +|»»» x|body|number| no ||none| +|»»» y|body|number| no ||none| + +> Response Examples + +```json +{ + "code": 0, + "msg": "error" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +## GET 图组名称 + +GET /chart/graph/groups + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +## DELETE 删除图组数据 + +DELETE /chart/graph/{group} + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|group|path|string| yes ||图所组名称| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +```json +{ + "code": 0, + "msg": "error" +} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +HTTP Status Code **200** + +|Name|Type|Required|Restrictions|Title|description| +|---|---|---|---|---|---| +|» code|integer|true|none||none| +|» msg|string|true|none||none| + +# 中文src目录接口/WS 模块 + +## GET 测试发送 + +GET /ws/test + +### Params + +|Name|Location|Type|Required|Title|Description| +|---|---|---|---|---|---| +|clientId|query|string| no ||ws链接得到的客户端ID| +|groupID|query|string| no ||组ID 1010| +|Authorization|header|string| yes ||Authoirzation token| +|Referer|header|string| yes ||User Referer| +|User-Agent|header|string| yes ||User Agent| +|Accept-Language|header|string| yes ||en_US;q=0.9| + +> Response Examples + +> 200 Response + +```json +{} +``` + +### Responses + +|HTTP Status Code |Meaning|Description|Data schema| +|---|---|---|---| +|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline| + +### Responses Data Schema + +# Data Schema +