swagger.yaml 52 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206
  1. basePath: /
  2. definitions:
  3. admin.ListMenuData:
  4. properties:
  5. id:
  6. description: ID
  7. type: integer
  8. is_have:
  9. description: 是否已拥有权限
  10. type: integer
  11. name:
  12. description: 菜单名称
  13. type: string
  14. pid:
  15. description: 父类ID
  16. type: integer
  17. type: object
  18. admin.ListMyMenuData:
  19. properties:
  20. icon:
  21. description: 图标
  22. type: string
  23. id:
  24. description: ID
  25. type: integer
  26. link:
  27. description: 链接地址
  28. type: string
  29. name:
  30. description: 菜单名称
  31. type: string
  32. pid:
  33. description: 父类ID
  34. type: integer
  35. type: object
  36. admin.createResponse:
  37. properties:
  38. id:
  39. description: 主键ID
  40. type: integer
  41. type: object
  42. admin.deleteResponse:
  43. properties:
  44. id:
  45. description: 主键ID
  46. type: integer
  47. type: object
  48. admin.detailResponse:
  49. properties:
  50. menu:
  51. description: 菜单栏
  52. items:
  53. $ref: '#/definitions/admin.ListMyMenuData'
  54. type: array
  55. mobile:
  56. description: 手机号
  57. type: string
  58. nickname:
  59. description: 昵称
  60. type: string
  61. username:
  62. description: 用户名
  63. type: string
  64. type: object
  65. admin.listAdminMenuResponse:
  66. properties:
  67. list:
  68. items:
  69. $ref: '#/definitions/admin.ListMenuData'
  70. type: array
  71. username:
  72. type: string
  73. type: object
  74. admin.listData:
  75. properties:
  76. created_at:
  77. description: 创建时间
  78. type: string
  79. created_user:
  80. description: 创建人
  81. type: string
  82. hashid:
  83. description: hashid
  84. type: string
  85. id:
  86. description: ID
  87. type: integer
  88. is_online:
  89. description: 是否在线 1:是 -1:否
  90. type: integer
  91. is_used:
  92. description: 是否启用 1:是 -1:否
  93. type: integer
  94. mobile:
  95. description: 手机号
  96. type: string
  97. nickname:
  98. description: 昵称
  99. type: string
  100. updated_at:
  101. description: 更新时间
  102. type: string
  103. updated_user:
  104. description: 更新人
  105. type: string
  106. username:
  107. description: 用户名
  108. type: string
  109. type: object
  110. admin.listResponse:
  111. properties:
  112. list:
  113. items:
  114. $ref: '#/definitions/admin.listData'
  115. type: array
  116. pagination:
  117. properties:
  118. current_page:
  119. type: integer
  120. per_page_count:
  121. type: integer
  122. total:
  123. type: integer
  124. type: object
  125. type: object
  126. admin.loginResponse:
  127. properties:
  128. token:
  129. description: 用户身份标识
  130. type: string
  131. type: object
  132. admin.logoutResponse:
  133. properties:
  134. username:
  135. description: 用户账号
  136. type: string
  137. type: object
  138. admin.modifyPasswordResponse:
  139. properties:
  140. username:
  141. description: 用户账号
  142. type: string
  143. type: object
  144. admin.modifyPersonalInfoResponse:
  145. properties:
  146. username:
  147. description: 用户账号
  148. type: string
  149. type: object
  150. admin.offlineResponse:
  151. properties:
  152. id:
  153. description: 主键ID
  154. type: integer
  155. type: object
  156. admin.resetPasswordResponse:
  157. properties:
  158. id:
  159. description: 主键ID
  160. type: integer
  161. type: object
  162. admin.updateUsedResponse:
  163. properties:
  164. id:
  165. description: 主键ID
  166. type: integer
  167. type: object
  168. authorized.createAPIResponse:
  169. properties:
  170. id:
  171. description: 主键ID
  172. type: integer
  173. type: object
  174. authorized.createResponse:
  175. properties:
  176. id:
  177. description: 主键ID
  178. type: integer
  179. type: object
  180. authorized.deleteAPIResponse:
  181. properties:
  182. id:
  183. description: 主键ID
  184. type: integer
  185. type: object
  186. authorized.deleteResponse:
  187. properties:
  188. id:
  189. description: 主键ID
  190. type: integer
  191. type: object
  192. authorized.listAPIData:
  193. properties:
  194. api:
  195. description: 调用方对接人
  196. type: string
  197. business_key:
  198. description: 调用方key
  199. type: string
  200. hash_id:
  201. description: hashID
  202. type: string
  203. method:
  204. description: 调用方secret
  205. type: string
  206. type: object
  207. authorized.listAPIResponse:
  208. properties:
  209. business_key:
  210. description: 调用方key
  211. type: string
  212. list:
  213. items:
  214. $ref: '#/definitions/authorized.listAPIData'
  215. type: array
  216. type: object
  217. authorized.listData:
  218. properties:
  219. business_developer:
  220. description: 调用方对接人
  221. type: string
  222. business_key:
  223. description: 调用方key
  224. type: string
  225. business_secret:
  226. description: 调用方secret
  227. type: string
  228. created_at:
  229. description: 创建时间
  230. type: string
  231. created_user:
  232. description: 创建人
  233. type: string
  234. hashid:
  235. description: hashid
  236. type: string
  237. id:
  238. description: ID
  239. type: integer
  240. is_used:
  241. description: 是否启用 1:是 -1:否
  242. type: integer
  243. remark:
  244. description: 备注
  245. type: string
  246. updated_at:
  247. description: 更新时间
  248. type: string
  249. updated_user:
  250. description: 更新人
  251. type: string
  252. type: object
  253. authorized.listResponse:
  254. properties:
  255. list:
  256. items:
  257. $ref: '#/definitions/authorized.listData'
  258. type: array
  259. pagination:
  260. properties:
  261. current_page:
  262. type: integer
  263. per_page_count:
  264. type: integer
  265. total:
  266. type: integer
  267. type: object
  268. type: object
  269. authorized.updateUsedResponse:
  270. properties:
  271. id:
  272. description: 主键ID
  273. type: integer
  274. type: object
  275. code.Failure:
  276. properties:
  277. code:
  278. description: 业务码
  279. type: integer
  280. message:
  281. description: 描述信息
  282. type: string
  283. type: object
  284. config.emailResponse:
  285. properties:
  286. email:
  287. description: 邮箱地址
  288. type: string
  289. type: object
  290. cron.createResponse:
  291. properties:
  292. id:
  293. description: 主键ID
  294. type: integer
  295. type: object
  296. cron.detailResponse:
  297. properties:
  298. command:
  299. description: 执行命令
  300. type: string
  301. http_method:
  302. description: http 请求方式 1:get 2:post
  303. type: integer
  304. is_used:
  305. description: 是否启用 1:是 -1:否
  306. type: integer
  307. name:
  308. description: 任务名称
  309. type: string
  310. notify_keyword:
  311. description: 通知匹配关键字(多个用,分割)
  312. type: string
  313. notify_receiver_email:
  314. description: 通知者邮箱地址(多个用,分割)
  315. type: string
  316. notify_status:
  317. description: 执行结束是否通知 1:不通知 2:失败通知 3:结束通知 4:结果关键字匹配通知
  318. type: integer
  319. notify_type:
  320. description: 通知类型 1:邮件 2:webhook
  321. type: integer
  322. protocol:
  323. description: 执行方式 1:shell 2:http
  324. type: integer
  325. remark:
  326. description: 备注
  327. type: string
  328. retry_interval:
  329. description: 重试间隔(单位:秒)
  330. type: integer
  331. retry_times:
  332. description: 重试次数
  333. type: integer
  334. spec:
  335. description: crontab 表达式
  336. type: string
  337. timeout:
  338. description: 超时时间(单位:秒)
  339. type: integer
  340. type: object
  341. cron.listData:
  342. properties:
  343. command:
  344. description: 执行命令
  345. type: string
  346. created_at:
  347. description: 创建时间
  348. type: string
  349. created_user:
  350. description: 创建人
  351. type: string
  352. hashid:
  353. description: hashid
  354. type: string
  355. http_method:
  356. description: http 请求方式 1:get 2:post
  357. type: integer
  358. http_method_text:
  359. description: http 请求方式
  360. type: string
  361. id:
  362. description: ID
  363. type: integer
  364. is_used:
  365. description: 是否启用 1=启用 2=禁用
  366. type: integer
  367. is_used_text:
  368. description: 是否启用
  369. type: string
  370. name:
  371. description: 任务名称
  372. type: string
  373. notify_status:
  374. description: 执行结束是否通知 1:不通知 2:失败通知 3:结束通知 4:结果关键字匹配通知
  375. type: integer
  376. notify_status_text:
  377. description: 执行结束是否通知
  378. type: string
  379. protocol:
  380. description: 执行方式 1:shell 2:http
  381. type: integer
  382. protocol_text:
  383. description: 执行方式
  384. type: string
  385. retry_interval:
  386. description: 重试间隔(单位:秒)
  387. type: integer
  388. retry_times:
  389. description: 重试次数
  390. type: integer
  391. spec:
  392. description: crontab 表达式
  393. type: string
  394. timeout:
  395. description: 超时时间(单位:秒)
  396. type: integer
  397. updated_at:
  398. description: 更新时间
  399. type: string
  400. updated_user:
  401. description: 更新人
  402. type: string
  403. type: object
  404. cron.listResponse:
  405. properties:
  406. list:
  407. items:
  408. $ref: '#/definitions/cron.listData'
  409. type: array
  410. pagination:
  411. properties:
  412. current_page:
  413. type: integer
  414. per_page_count:
  415. type: integer
  416. total:
  417. type: integer
  418. type: object
  419. type: object
  420. cron.modifyResponse:
  421. properties:
  422. id:
  423. description: 主键ID
  424. type: integer
  425. type: object
  426. cron.updateUsedResponse:
  427. properties:
  428. id:
  429. description: 主键ID
  430. type: integer
  431. type: object
  432. helper.md5Response:
  433. properties:
  434. md5_str:
  435. description: MD5后的字符串
  436. type: string
  437. type: object
  438. helper.signResponse:
  439. properties:
  440. authorization:
  441. description: 签名信息-Authorization
  442. type: string
  443. authorization_date:
  444. description: 签名信息-Authorization-Date
  445. type: string
  446. type: object
  447. menu.createActionResponse:
  448. properties:
  449. id:
  450. description: 主键ID
  451. type: integer
  452. type: object
  453. menu.createRequest:
  454. properties:
  455. icon:
  456. description: 图标
  457. type: string
  458. id:
  459. description: ID
  460. type: string
  461. level:
  462. description: 菜单类型 1:一级菜单 2:二级菜单
  463. type: integer
  464. link:
  465. description: 链接地址
  466. type: string
  467. name:
  468. description: 菜单名称
  469. type: string
  470. pid:
  471. description: 父类ID
  472. type: integer
  473. type: object
  474. menu.createResponse:
  475. properties:
  476. id:
  477. description: 主键ID
  478. type: integer
  479. type: object
  480. menu.deleteActionResponse:
  481. properties:
  482. id:
  483. description: 主键ID
  484. type: integer
  485. type: object
  486. menu.deleteResponse:
  487. properties:
  488. id:
  489. description: 主键ID
  490. type: integer
  491. type: object
  492. menu.detailResponse:
  493. properties:
  494. icon:
  495. description: 图标
  496. type: string
  497. id:
  498. description: 主键ID
  499. type: integer
  500. link:
  501. description: 链接地址
  502. type: string
  503. name:
  504. description: 菜单名称
  505. type: string
  506. pid:
  507. description: 父类ID
  508. type: integer
  509. type: object
  510. menu.listActionData:
  511. properties:
  512. api:
  513. description: 调用方对接人
  514. type: string
  515. hash_id:
  516. description: hashID
  517. type: string
  518. menu_id:
  519. description: 菜单栏ID
  520. type: integer
  521. method:
  522. description: 调用方secret
  523. type: string
  524. type: object
  525. menu.listActionResponse:
  526. properties:
  527. list:
  528. items:
  529. $ref: '#/definitions/menu.listActionData'
  530. type: array
  531. menu_name:
  532. type: string
  533. type: object
  534. menu.listData:
  535. properties:
  536. hashid:
  537. description: hashid
  538. type: string
  539. icon:
  540. description: 图标
  541. type: string
  542. id:
  543. description: ID
  544. type: integer
  545. is_used:
  546. description: 是否启用 1=启用 -1=禁用
  547. type: integer
  548. link:
  549. description: 链接地址
  550. type: string
  551. name:
  552. description: 菜单名称
  553. type: string
  554. pid:
  555. description: 父类ID
  556. type: integer
  557. sort:
  558. description: 排序
  559. type: integer
  560. type: object
  561. menu.listResponse:
  562. properties:
  563. list:
  564. items:
  565. $ref: '#/definitions/menu.listData'
  566. type: array
  567. type: object
  568. menu.updateSortResponse:
  569. properties:
  570. id:
  571. description: 主键ID
  572. type: integer
  573. type: object
  574. menu.updateUsedResponse:
  575. properties:
  576. id:
  577. description: 主键ID
  578. type: integer
  579. type: object
  580. tool.dbData:
  581. properties:
  582. db_name:
  583. description: 数据库名称
  584. type: string
  585. type: object
  586. tool.dbsResponse:
  587. properties:
  588. list:
  589. description: 数据库列表
  590. items:
  591. $ref: '#/definitions/tool.dbData'
  592. type: array
  593. type: object
  594. tool.hashIdsDecodeResponse:
  595. properties:
  596. val:
  597. description: 解密后的值
  598. type: integer
  599. type: object
  600. tool.hashIdsEncodeResponse:
  601. properties:
  602. val:
  603. description: 加密后的值
  604. type: string
  605. type: object
  606. tool.searchCacheResponse:
  607. properties:
  608. ttl:
  609. description: 过期时间
  610. type: string
  611. val:
  612. description: 查询后的值
  613. type: string
  614. type: object
  615. tool.searchMySQLResponse:
  616. properties:
  617. cols:
  618. description: 查询后的行
  619. items:
  620. type: string
  621. type: array
  622. cols_info:
  623. description: 行信息
  624. items:
  625. $ref: '#/definitions/tool.tableColumn'
  626. type: array
  627. list:
  628. description: 查询后的数据
  629. items:
  630. additionalProperties: true
  631. type: object
  632. type: array
  633. type: object
  634. tool.sendMessageResponse:
  635. properties:
  636. status:
  637. description: 状态
  638. type: string
  639. type: object
  640. tool.tableColumn:
  641. properties:
  642. column_comment:
  643. description: 字段注释
  644. type: string
  645. column_name:
  646. description: 字段名称
  647. type: string
  648. type: object
  649. tool.tableData:
  650. properties:
  651. table_comment:
  652. description: 数据表备注
  653. type: string
  654. table_name:
  655. description: 数据表名称
  656. type: string
  657. type: object
  658. tool.tablesResponse:
  659. properties:
  660. list:
  661. description: 数据表列表
  662. items:
  663. $ref: '#/definitions/tool.tableData'
  664. type: array
  665. type: object
  666. info:
  667. contact: {}
  668. license:
  669. name: MIT
  670. url: https://github.com/xinliangnote/go-gin-api/blob/master/LICENSE
  671. title: swagger 接口文档
  672. version: "2.0"
  673. paths:
  674. /api/admin:
  675. get:
  676. consumes:
  677. - application/x-www-form-urlencoded
  678. description: 管理员列表
  679. parameters:
  680. - default: 1
  681. description: 第几页
  682. in: query
  683. name: page
  684. required: true
  685. type: integer
  686. - default: 10
  687. description: 每页显示条数
  688. in: query
  689. name: page_size
  690. required: true
  691. type: integer
  692. - description: 用户名
  693. in: query
  694. name: username
  695. type: string
  696. - description: 昵称
  697. in: query
  698. name: nickname
  699. type: string
  700. - description: 手机号
  701. in: query
  702. name: mobile
  703. type: string
  704. produces:
  705. - application/json
  706. responses:
  707. "200":
  708. description: OK
  709. schema:
  710. $ref: '#/definitions/admin.listResponse'
  711. "400":
  712. description: Bad Request
  713. schema:
  714. $ref: '#/definitions/code.Failure'
  715. security:
  716. - LoginToken: []
  717. summary: 管理员列表
  718. tags:
  719. - API.admin
  720. post:
  721. consumes:
  722. - application/x-www-form-urlencoded
  723. description: 新增管理员
  724. parameters:
  725. - description: 用户名
  726. in: formData
  727. name: username
  728. required: true
  729. type: string
  730. - description: 昵称
  731. in: formData
  732. name: nickname
  733. required: true
  734. type: string
  735. - description: 手机号
  736. in: formData
  737. name: mobile
  738. required: true
  739. type: string
  740. - description: MD5后的密码
  741. in: formData
  742. name: password
  743. required: true
  744. type: string
  745. produces:
  746. - application/json
  747. responses:
  748. "200":
  749. description: OK
  750. schema:
  751. $ref: '#/definitions/admin.createResponse'
  752. "400":
  753. description: Bad Request
  754. schema:
  755. $ref: '#/definitions/code.Failure'
  756. security:
  757. - LoginToken: []
  758. summary: 新增管理员
  759. tags:
  760. - API.admin
  761. /api/admin/{id}:
  762. delete:
  763. consumes:
  764. - application/json
  765. description: 删除管理员
  766. parameters:
  767. - description: hashId
  768. in: path
  769. name: id
  770. required: true
  771. type: string
  772. produces:
  773. - application/json
  774. responses:
  775. "200":
  776. description: OK
  777. schema:
  778. $ref: '#/definitions/admin.deleteResponse'
  779. "400":
  780. description: Bad Request
  781. schema:
  782. $ref: '#/definitions/code.Failure'
  783. security:
  784. - LoginToken: []
  785. summary: 删除管理员
  786. tags:
  787. - API.admin
  788. /api/admin/info:
  789. get:
  790. consumes:
  791. - application/x-www-form-urlencoded
  792. description: 管理员详情
  793. produces:
  794. - application/json
  795. responses:
  796. "200":
  797. description: OK
  798. schema:
  799. $ref: '#/definitions/admin.detailResponse'
  800. "400":
  801. description: Bad Request
  802. schema:
  803. $ref: '#/definitions/code.Failure'
  804. security:
  805. - LoginToken: []
  806. summary: 管理员详情
  807. tags:
  808. - API.admin
  809. /api/admin/logout:
  810. post:
  811. consumes:
  812. - application/x-www-form-urlencoded
  813. description: 管理员登出
  814. produces:
  815. - application/json
  816. responses:
  817. "200":
  818. description: OK
  819. schema:
  820. $ref: '#/definitions/admin.logoutResponse'
  821. "400":
  822. description: Bad Request
  823. schema:
  824. $ref: '#/definitions/code.Failure'
  825. security:
  826. - LoginToken: []
  827. summary: 管理员登出
  828. tags:
  829. - API.admin
  830. /api/admin/menu:
  831. post:
  832. consumes:
  833. - application/x-www-form-urlencoded
  834. description: 提交菜单授权
  835. parameters:
  836. - description: Hashid
  837. in: formData
  838. name: id
  839. required: true
  840. type: string
  841. - description: 功能权限ID,多个用,分割
  842. in: formData
  843. name: actions
  844. required: true
  845. type: string
  846. produces:
  847. - application/json
  848. responses:
  849. "200":
  850. description: OK
  851. schema:
  852. $ref: '#/definitions/admin.createResponse'
  853. "400":
  854. description: Bad Request
  855. schema:
  856. $ref: '#/definitions/code.Failure'
  857. security:
  858. - LoginToken: []
  859. summary: 提交菜单授权
  860. tags:
  861. - API.admin
  862. /api/admin/menu/{id}:
  863. get:
  864. consumes:
  865. - application/x-www-form-urlencoded
  866. description: 菜单授权列表
  867. parameters:
  868. - description: hashId
  869. in: path
  870. name: id
  871. required: true
  872. type: string
  873. produces:
  874. - application/json
  875. responses:
  876. "200":
  877. description: OK
  878. schema:
  879. $ref: '#/definitions/admin.listAdminMenuResponse'
  880. "400":
  881. description: Bad Request
  882. schema:
  883. $ref: '#/definitions/code.Failure'
  884. security:
  885. - LoginToken: []
  886. summary: 菜单授权列表
  887. tags:
  888. - API.admin
  889. /api/admin/modify_password:
  890. patch:
  891. consumes:
  892. - application/x-www-form-urlencoded
  893. description: 修改密码
  894. parameters:
  895. - description: 旧密码
  896. in: formData
  897. name: old_password
  898. required: true
  899. type: string
  900. - description: 新密码
  901. in: formData
  902. name: new_password
  903. required: true
  904. type: string
  905. produces:
  906. - application/json
  907. responses:
  908. "200":
  909. description: OK
  910. schema:
  911. $ref: '#/definitions/admin.modifyPasswordResponse'
  912. "400":
  913. description: Bad Request
  914. schema:
  915. $ref: '#/definitions/code.Failure'
  916. security:
  917. - LoginToken: []
  918. summary: 修改密码
  919. tags:
  920. - API.admin
  921. /api/admin/modify_personal_info:
  922. patch:
  923. consumes:
  924. - application/x-www-form-urlencoded
  925. description: 修改个人信息
  926. parameters:
  927. - description: 昵称
  928. in: formData
  929. name: nickname
  930. required: true
  931. type: string
  932. - description: 手机号
  933. in: formData
  934. name: mobile
  935. required: true
  936. type: string
  937. produces:
  938. - application/json
  939. responses:
  940. "200":
  941. description: OK
  942. schema:
  943. $ref: '#/definitions/admin.modifyPersonalInfoResponse'
  944. "400":
  945. description: Bad Request
  946. schema:
  947. $ref: '#/definitions/code.Failure'
  948. security:
  949. - LoginToken: []
  950. summary: 修改个人信息
  951. tags:
  952. - API.admin
  953. /api/admin/offline:
  954. patch:
  955. consumes:
  956. - application/x-www-form-urlencoded
  957. description: 下线管理员
  958. parameters:
  959. - description: Hashid
  960. in: formData
  961. name: id
  962. required: true
  963. type: string
  964. produces:
  965. - application/json
  966. responses:
  967. "200":
  968. description: OK
  969. schema:
  970. $ref: '#/definitions/admin.offlineResponse'
  971. "400":
  972. description: Bad Request
  973. schema:
  974. $ref: '#/definitions/code.Failure'
  975. security:
  976. - LoginToken: []
  977. summary: 下线管理员
  978. tags:
  979. - API.admin
  980. /api/admin/reset_password/{id}:
  981. patch:
  982. consumes:
  983. - application/json
  984. description: 重置密码
  985. parameters:
  986. - description: hashId
  987. in: path
  988. name: id
  989. required: true
  990. type: string
  991. produces:
  992. - application/json
  993. responses:
  994. "200":
  995. description: OK
  996. schema:
  997. $ref: '#/definitions/admin.resetPasswordResponse'
  998. "400":
  999. description: Bad Request
  1000. schema:
  1001. $ref: '#/definitions/code.Failure'
  1002. security:
  1003. - LoginToken: []
  1004. summary: 重置密码
  1005. tags:
  1006. - API.admin
  1007. /api/admin/used:
  1008. patch:
  1009. consumes:
  1010. - application/x-www-form-urlencoded
  1011. description: 更新管理员为启用/禁用
  1012. parameters:
  1013. - description: Hashid
  1014. in: formData
  1015. name: id
  1016. required: true
  1017. type: string
  1018. - description: 是否启用 1:是 -1:否
  1019. in: formData
  1020. name: used
  1021. required: true
  1022. type: integer
  1023. produces:
  1024. - application/json
  1025. responses:
  1026. "200":
  1027. description: OK
  1028. schema:
  1029. $ref: '#/definitions/admin.updateUsedResponse'
  1030. "400":
  1031. description: Bad Request
  1032. schema:
  1033. $ref: '#/definitions/code.Failure'
  1034. security:
  1035. - LoginToken: []
  1036. summary: 更新管理员为启用/禁用
  1037. tags:
  1038. - API.admin
  1039. /api/authorized:
  1040. get:
  1041. consumes:
  1042. - application/x-www-form-urlencoded
  1043. description: 调用方列表
  1044. parameters:
  1045. - default: 1
  1046. description: 第几页
  1047. in: query
  1048. name: page
  1049. required: true
  1050. type: integer
  1051. - default: 10
  1052. description: 每页显示条数
  1053. in: query
  1054. name: page_size
  1055. required: true
  1056. type: integer
  1057. - description: 调用方key
  1058. in: query
  1059. name: business_key
  1060. type: string
  1061. - description: 调用方secret
  1062. in: query
  1063. name: business_secret
  1064. type: string
  1065. - description: 调用方对接人
  1066. in: query
  1067. name: business_developer
  1068. type: string
  1069. - description: 备注
  1070. in: path
  1071. name: remark
  1072. type: string
  1073. produces:
  1074. - application/json
  1075. responses:
  1076. "200":
  1077. description: OK
  1078. schema:
  1079. $ref: '#/definitions/authorized.listResponse'
  1080. "400":
  1081. description: Bad Request
  1082. schema:
  1083. $ref: '#/definitions/code.Failure'
  1084. security:
  1085. - LoginToken: []
  1086. summary: 调用方列表
  1087. tags:
  1088. - API.authorized
  1089. post:
  1090. consumes:
  1091. - application/x-www-form-urlencoded
  1092. description: 新增调用方
  1093. parameters:
  1094. - description: 调用方key
  1095. in: formData
  1096. name: business_key
  1097. required: true
  1098. type: string
  1099. - description: 调用方对接人
  1100. in: formData
  1101. name: business_developer
  1102. required: true
  1103. type: string
  1104. - description: 备注
  1105. in: formData
  1106. name: remark
  1107. required: true
  1108. type: string
  1109. produces:
  1110. - application/json
  1111. responses:
  1112. "200":
  1113. description: OK
  1114. schema:
  1115. $ref: '#/definitions/authorized.createResponse'
  1116. "400":
  1117. description: Bad Request
  1118. schema:
  1119. $ref: '#/definitions/code.Failure'
  1120. security:
  1121. - LoginToken: []
  1122. summary: 新增调用方
  1123. tags:
  1124. - API.authorized
  1125. /api/authorized/{id}:
  1126. delete:
  1127. consumes:
  1128. - application/json
  1129. description: 删除调用方
  1130. parameters:
  1131. - description: hashId
  1132. in: path
  1133. name: id
  1134. required: true
  1135. type: string
  1136. produces:
  1137. - application/json
  1138. responses:
  1139. "200":
  1140. description: OK
  1141. schema:
  1142. $ref: '#/definitions/authorized.deleteResponse'
  1143. "400":
  1144. description: Bad Request
  1145. schema:
  1146. $ref: '#/definitions/code.Failure'
  1147. security:
  1148. - LoginToken: []
  1149. summary: 删除调用方
  1150. tags:
  1151. - API.authorized
  1152. /api/authorized/used:
  1153. patch:
  1154. consumes:
  1155. - application/x-www-form-urlencoded
  1156. description: 更新调用方为启用/禁用
  1157. parameters:
  1158. - description: hashID
  1159. in: formData
  1160. name: id
  1161. required: true
  1162. type: string
  1163. - description: 是否启用 1:是 -1:否
  1164. in: formData
  1165. name: used
  1166. required: true
  1167. type: integer
  1168. produces:
  1169. - application/json
  1170. responses:
  1171. "200":
  1172. description: OK
  1173. schema:
  1174. $ref: '#/definitions/authorized.updateUsedResponse'
  1175. "400":
  1176. description: Bad Request
  1177. schema:
  1178. $ref: '#/definitions/code.Failure'
  1179. security:
  1180. - LoginToken: []
  1181. summary: 更新调用方为启用/禁用
  1182. tags:
  1183. - API.authorized
  1184. /api/authorized_api:
  1185. get:
  1186. consumes:
  1187. - application/x-www-form-urlencoded
  1188. description: 调用方接口地址列表
  1189. parameters:
  1190. - description: hashID
  1191. in: query
  1192. name: id
  1193. required: true
  1194. type: string
  1195. produces:
  1196. - application/json
  1197. responses:
  1198. "200":
  1199. description: OK
  1200. schema:
  1201. $ref: '#/definitions/authorized.listAPIResponse'
  1202. "400":
  1203. description: Bad Request
  1204. schema:
  1205. $ref: '#/definitions/code.Failure'
  1206. security:
  1207. - LoginToken: []
  1208. summary: 调用方接口地址列表
  1209. tags:
  1210. - API.authorized
  1211. post:
  1212. consumes:
  1213. - application/x-www-form-urlencoded
  1214. description: 授权调用方接口地址
  1215. parameters:
  1216. - description: HashID
  1217. in: formData
  1218. name: id
  1219. required: true
  1220. type: string
  1221. - description: 请求方法
  1222. in: formData
  1223. name: method
  1224. required: true
  1225. type: string
  1226. - description: 请求地址
  1227. in: formData
  1228. name: api
  1229. required: true
  1230. type: string
  1231. produces:
  1232. - application/json
  1233. responses:
  1234. "200":
  1235. description: OK
  1236. schema:
  1237. $ref: '#/definitions/authorized.createAPIResponse'
  1238. "400":
  1239. description: Bad Request
  1240. schema:
  1241. $ref: '#/definitions/code.Failure'
  1242. security:
  1243. - LoginToken: []
  1244. summary: 授权调用方接口地址
  1245. tags:
  1246. - API.authorized
  1247. /api/authorized_api/{id}:
  1248. delete:
  1249. consumes:
  1250. - application/json
  1251. description: 删除调用方接口地址
  1252. parameters:
  1253. - description: 主键ID
  1254. in: path
  1255. name: id
  1256. required: true
  1257. type: string
  1258. produces:
  1259. - application/json
  1260. responses:
  1261. "200":
  1262. description: OK
  1263. schema:
  1264. $ref: '#/definitions/authorized.deleteAPIResponse'
  1265. "400":
  1266. description: Bad Request
  1267. schema:
  1268. $ref: '#/definitions/code.Failure'
  1269. security:
  1270. - LoginToken: []
  1271. summary: 删除调用方接口地址
  1272. tags:
  1273. - API.authorized
  1274. /api/config/email:
  1275. patch:
  1276. consumes:
  1277. - application/x-www-form-urlencoded
  1278. description: 修改邮件配置
  1279. parameters:
  1280. - description: 邮箱服务器
  1281. in: formData
  1282. name: host
  1283. required: true
  1284. type: string
  1285. - description: 端口
  1286. in: formData
  1287. name: port
  1288. required: true
  1289. type: string
  1290. - description: 发件人邮箱
  1291. in: formData
  1292. name: user
  1293. required: true
  1294. type: string
  1295. - description: 发件人密码
  1296. in: formData
  1297. name: pass
  1298. required: true
  1299. type: string
  1300. - description: 收件人邮箱地址,多个用,分割
  1301. in: formData
  1302. name: to
  1303. required: true
  1304. type: string
  1305. produces:
  1306. - application/json
  1307. responses:
  1308. "200":
  1309. description: OK
  1310. schema:
  1311. $ref: '#/definitions/config.emailResponse'
  1312. "400":
  1313. description: Bad Request
  1314. schema:
  1315. $ref: '#/definitions/code.Failure'
  1316. security:
  1317. - LoginToken: []
  1318. summary: 修改邮件配置
  1319. tags:
  1320. - API.config
  1321. /api/cron:
  1322. get:
  1323. consumes:
  1324. - application/x-www-form-urlencoded
  1325. description: 任务列表
  1326. parameters:
  1327. - default: 1
  1328. description: 第几页
  1329. in: query
  1330. name: page
  1331. required: true
  1332. type: integer
  1333. - default: 10
  1334. description: 每页显示条数
  1335. in: query
  1336. name: page_size
  1337. required: true
  1338. type: integer
  1339. - description: 任务名称
  1340. in: query
  1341. name: name
  1342. type: string
  1343. - description: 执行方式 1:shell 2:http
  1344. in: query
  1345. name: protocol
  1346. type: integer
  1347. - description: 是否启用 1:是 -1:否
  1348. in: query
  1349. name: is_used
  1350. type: integer
  1351. produces:
  1352. - application/json
  1353. responses:
  1354. "200":
  1355. description: OK
  1356. schema:
  1357. $ref: '#/definitions/cron.listResponse'
  1358. "400":
  1359. description: Bad Request
  1360. schema:
  1361. $ref: '#/definitions/code.Failure'
  1362. security:
  1363. - LoginToken: []
  1364. summary: 任务列表
  1365. tags:
  1366. - API.cron
  1367. post:
  1368. consumes:
  1369. - application/x-www-form-urlencoded
  1370. description: 创建任务
  1371. parameters:
  1372. - description: 任务名称
  1373. in: formData
  1374. name: name
  1375. required: true
  1376. type: string
  1377. - description: crontab 表达式
  1378. in: formData
  1379. name: spec
  1380. required: true
  1381. type: string
  1382. - description: 执行命令
  1383. in: formData
  1384. name: command
  1385. required: true
  1386. type: string
  1387. - description: 执行方式 1:shell 2:http
  1388. in: formData
  1389. name: protocol
  1390. required: true
  1391. type: integer
  1392. - description: http 请求方式 1:get 2:post
  1393. in: formData
  1394. name: http_method
  1395. type: integer
  1396. - description: 超时时间(单位:秒)
  1397. in: formData
  1398. name: timeout
  1399. required: true
  1400. type: integer
  1401. - description: 重试次数
  1402. in: formData
  1403. name: retry_times
  1404. required: true
  1405. type: integer
  1406. - description: 重试间隔(单位:秒)
  1407. in: formData
  1408. name: retry_interval
  1409. required: true
  1410. type: integer
  1411. - description: 执行结束是否通知 1:不通知 2:失败通知 3:结束通知 4:结果关键字匹配通知
  1412. in: formData
  1413. name: notify_status
  1414. required: true
  1415. type: integer
  1416. - description: 通知类型 1:邮件 2:webhook
  1417. in: formData
  1418. name: notify_type
  1419. type: integer
  1420. - description: 通知者邮箱地址(多个用,分割)
  1421. in: formData
  1422. name: notify_receiver_email
  1423. type: string
  1424. - description: 通知匹配关键字(多个用,分割)
  1425. in: formData
  1426. name: notify_keyword
  1427. type: string
  1428. - description: 备注
  1429. in: formData
  1430. name: remark
  1431. type: string
  1432. - description: 是否启用 1:是 -1:否
  1433. in: formData
  1434. name: is_used
  1435. required: true
  1436. type: integer
  1437. produces:
  1438. - application/json
  1439. responses:
  1440. "200":
  1441. description: OK
  1442. schema:
  1443. $ref: '#/definitions/cron.createResponse'
  1444. "400":
  1445. description: Bad Request
  1446. schema:
  1447. $ref: '#/definitions/code.Failure'
  1448. security:
  1449. - LoginToken: []
  1450. summary: 创建任务
  1451. tags:
  1452. - API.cron
  1453. /api/cron/{id}:
  1454. get:
  1455. consumes:
  1456. - application/json
  1457. description: 获取单条任务详情
  1458. parameters:
  1459. - description: hashId
  1460. in: path
  1461. name: id
  1462. required: true
  1463. type: string
  1464. produces:
  1465. - application/json
  1466. responses:
  1467. "200":
  1468. description: OK
  1469. schema:
  1470. $ref: '#/definitions/cron.detailResponse'
  1471. "400":
  1472. description: Bad Request
  1473. schema:
  1474. $ref: '#/definitions/code.Failure'
  1475. security:
  1476. - LoginToken: []
  1477. summary: 获取单条任务详情
  1478. tags:
  1479. - API.cron
  1480. patch:
  1481. consumes:
  1482. - application/json
  1483. description: 手动执行单条任务
  1484. parameters:
  1485. - description: hashId
  1486. in: path
  1487. name: id
  1488. required: true
  1489. type: string
  1490. produces:
  1491. - application/json
  1492. responses:
  1493. "200":
  1494. description: OK
  1495. schema:
  1496. $ref: '#/definitions/cron.detailResponse'
  1497. "400":
  1498. description: Bad Request
  1499. schema:
  1500. $ref: '#/definitions/code.Failure'
  1501. security:
  1502. - LoginToken: []
  1503. summary: 手动执行单条任务
  1504. tags:
  1505. - API.cron
  1506. post:
  1507. consumes:
  1508. - application/x-www-form-urlencoded
  1509. description: 编辑任务
  1510. parameters:
  1511. - description: hashID
  1512. in: formData
  1513. name: id
  1514. required: true
  1515. type: string
  1516. - description: 任务名称
  1517. in: formData
  1518. name: name
  1519. required: true
  1520. type: string
  1521. - description: crontab 表达式
  1522. in: formData
  1523. name: spec
  1524. required: true
  1525. type: string
  1526. - description: 执行命令
  1527. in: formData
  1528. name: command
  1529. required: true
  1530. type: string
  1531. - description: 执行方式 1:shell 2:http
  1532. in: formData
  1533. name: protocol
  1534. required: true
  1535. type: integer
  1536. - description: http 请求方式 1:get 2:post
  1537. in: formData
  1538. name: http_method
  1539. type: integer
  1540. - description: 超时时间(单位:秒)
  1541. in: formData
  1542. name: timeout
  1543. required: true
  1544. type: integer
  1545. - description: 重试次数
  1546. in: formData
  1547. name: retry_times
  1548. required: true
  1549. type: integer
  1550. - description: 重试间隔(单位:秒)
  1551. in: formData
  1552. name: retry_interval
  1553. required: true
  1554. type: integer
  1555. - description: 执行结束是否通知 1:不通知 2:失败通知 3:结束通知 4:结果关键字匹配通知
  1556. in: formData
  1557. name: notify_status
  1558. required: true
  1559. type: integer
  1560. - description: 通知类型 1:邮件 2:webhook
  1561. in: formData
  1562. name: notify_type
  1563. type: integer
  1564. - description: 通知者邮箱地址(多个用,分割)
  1565. in: formData
  1566. name: notify_receiver_email
  1567. type: string
  1568. - description: 通知匹配关键字(多个用,分割)
  1569. in: formData
  1570. name: notify_keyword
  1571. type: string
  1572. - description: 备注
  1573. in: formData
  1574. name: remark
  1575. type: string
  1576. - description: 是否启用 1:是 -1:否
  1577. in: formData
  1578. name: is_used
  1579. required: true
  1580. type: integer
  1581. produces:
  1582. - application/json
  1583. responses:
  1584. "200":
  1585. description: OK
  1586. schema:
  1587. $ref: '#/definitions/cron.modifyResponse'
  1588. "400":
  1589. description: Bad Request
  1590. schema:
  1591. $ref: '#/definitions/code.Failure'
  1592. security:
  1593. - LoginToken: []
  1594. summary: 编辑任务
  1595. tags:
  1596. - API.cron
  1597. /api/cron/used:
  1598. patch:
  1599. consumes:
  1600. - application/x-www-form-urlencoded
  1601. description: 更新任务为启用/禁用
  1602. parameters:
  1603. - description: hashID
  1604. in: formData
  1605. name: id
  1606. required: true
  1607. type: string
  1608. - description: 是否启用 1:是 -1:否
  1609. in: formData
  1610. name: used
  1611. required: true
  1612. type: integer
  1613. produces:
  1614. - application/json
  1615. responses:
  1616. "200":
  1617. description: OK
  1618. schema:
  1619. $ref: '#/definitions/cron.updateUsedResponse'
  1620. "400":
  1621. description: Bad Request
  1622. schema:
  1623. $ref: '#/definitions/code.Failure'
  1624. security:
  1625. - LoginToken: []
  1626. summary: 更新任务为启用/禁用
  1627. tags:
  1628. - API.cron
  1629. /api/login:
  1630. post:
  1631. consumes:
  1632. - application/x-www-form-urlencoded
  1633. description: 管理员登录
  1634. parameters:
  1635. - description: 用户名
  1636. in: formData
  1637. name: username
  1638. required: true
  1639. type: string
  1640. - description: MD5后的密码
  1641. in: formData
  1642. name: password
  1643. required: true
  1644. type: string
  1645. produces:
  1646. - application/json
  1647. responses:
  1648. "200":
  1649. description: OK
  1650. schema:
  1651. $ref: '#/definitions/admin.loginResponse'
  1652. "400":
  1653. description: Bad Request
  1654. schema:
  1655. $ref: '#/definitions/code.Failure'
  1656. security:
  1657. - LoginToken: []
  1658. summary: 管理员登录
  1659. tags:
  1660. - API.admin
  1661. /api/menu:
  1662. get:
  1663. consumes:
  1664. - application/x-www-form-urlencoded
  1665. description: 菜单列表
  1666. produces:
  1667. - application/json
  1668. responses:
  1669. "200":
  1670. description: OK
  1671. schema:
  1672. $ref: '#/definitions/menu.listResponse'
  1673. "400":
  1674. description: Bad Request
  1675. schema:
  1676. $ref: '#/definitions/code.Failure'
  1677. security:
  1678. - LoginToken: []
  1679. summary: 菜单列表
  1680. tags:
  1681. - API.menu
  1682. post:
  1683. consumes:
  1684. - application/x-www-form-urlencoded
  1685. description: 创建/编辑菜单
  1686. parameters:
  1687. - description: 请求信息
  1688. in: body
  1689. name: Request
  1690. required: true
  1691. schema:
  1692. $ref: '#/definitions/menu.createRequest'
  1693. produces:
  1694. - application/json
  1695. responses:
  1696. "200":
  1697. description: OK
  1698. schema:
  1699. $ref: '#/definitions/menu.createResponse'
  1700. "400":
  1701. description: Bad Request
  1702. schema:
  1703. $ref: '#/definitions/code.Failure'
  1704. security:
  1705. - LoginToken: []
  1706. summary: 创建/编辑菜单
  1707. tags:
  1708. - API.menu
  1709. /api/menu/{id}:
  1710. delete:
  1711. consumes:
  1712. - application/json
  1713. description: 删除菜单
  1714. parameters:
  1715. - description: hashId
  1716. in: path
  1717. name: id
  1718. required: true
  1719. type: string
  1720. produces:
  1721. - application/json
  1722. responses:
  1723. "200":
  1724. description: OK
  1725. schema:
  1726. $ref: '#/definitions/menu.deleteResponse'
  1727. "400":
  1728. description: Bad Request
  1729. schema:
  1730. $ref: '#/definitions/code.Failure'
  1731. security:
  1732. - LoginToken: []
  1733. summary: 删除菜单
  1734. tags:
  1735. - API.menu
  1736. get:
  1737. consumes:
  1738. - application/x-www-form-urlencoded
  1739. description: 菜单详情
  1740. parameters:
  1741. - description: hashId
  1742. in: path
  1743. name: id
  1744. required: true
  1745. type: string
  1746. produces:
  1747. - application/json
  1748. responses:
  1749. "200":
  1750. description: OK
  1751. schema:
  1752. $ref: '#/definitions/menu.detailResponse'
  1753. "400":
  1754. description: Bad Request
  1755. schema:
  1756. $ref: '#/definitions/code.Failure'
  1757. security:
  1758. - LoginToken: []
  1759. summary: 菜单详情
  1760. tags:
  1761. - API.menu
  1762. /api/menu/sort:
  1763. patch:
  1764. consumes:
  1765. - application/x-www-form-urlencoded
  1766. description: 更新菜单排序
  1767. parameters:
  1768. - description: hashId
  1769. in: formData
  1770. name: id
  1771. required: true
  1772. type: string
  1773. - description: 排序
  1774. in: formData
  1775. name: sort
  1776. required: true
  1777. type: integer
  1778. produces:
  1779. - application/json
  1780. responses:
  1781. "200":
  1782. description: OK
  1783. schema:
  1784. $ref: '#/definitions/menu.updateSortResponse'
  1785. "400":
  1786. description: Bad Request
  1787. schema:
  1788. $ref: '#/definitions/code.Failure'
  1789. security:
  1790. - LoginToken: []
  1791. summary: 更新菜单排序
  1792. tags:
  1793. - API.menu
  1794. /api/menu/used:
  1795. patch:
  1796. consumes:
  1797. - application/x-www-form-urlencoded
  1798. description: 更新菜单为启用/禁用
  1799. parameters:
  1800. - description: hashId
  1801. in: formData
  1802. name: id
  1803. required: true
  1804. type: string
  1805. - description: 是否启用 1:是 -1:否
  1806. in: formData
  1807. name: used
  1808. required: true
  1809. type: integer
  1810. produces:
  1811. - application/json
  1812. responses:
  1813. "200":
  1814. description: OK
  1815. schema:
  1816. $ref: '#/definitions/menu.updateUsedResponse'
  1817. "400":
  1818. description: Bad Request
  1819. schema:
  1820. $ref: '#/definitions/code.Failure'
  1821. security:
  1822. - LoginToken: []
  1823. summary: 更新菜单为启用/禁用
  1824. tags:
  1825. - API.menu
  1826. /api/menu_action:
  1827. get:
  1828. consumes:
  1829. - application/x-www-form-urlencoded
  1830. description: 功能权限列表
  1831. parameters:
  1832. - description: hashID
  1833. in: query
  1834. name: id
  1835. required: true
  1836. type: string
  1837. produces:
  1838. - application/json
  1839. responses:
  1840. "200":
  1841. description: OK
  1842. schema:
  1843. $ref: '#/definitions/menu.listActionResponse'
  1844. "400":
  1845. description: Bad Request
  1846. schema:
  1847. $ref: '#/definitions/code.Failure'
  1848. security:
  1849. - LoginToken: []
  1850. summary: 功能权限列表
  1851. tags:
  1852. - API.menu
  1853. post:
  1854. consumes:
  1855. - application/x-www-form-urlencoded
  1856. description: 创建功能权限
  1857. parameters:
  1858. - description: HashID
  1859. in: formData
  1860. name: id
  1861. required: true
  1862. type: string
  1863. - description: 请求方法
  1864. in: formData
  1865. name: method
  1866. required: true
  1867. type: string
  1868. - description: 请求地址
  1869. in: formData
  1870. name: api
  1871. required: true
  1872. type: string
  1873. produces:
  1874. - application/json
  1875. responses:
  1876. "200":
  1877. description: OK
  1878. schema:
  1879. $ref: '#/definitions/menu.createActionResponse'
  1880. "400":
  1881. description: Bad Request
  1882. schema:
  1883. $ref: '#/definitions/code.Failure'
  1884. security:
  1885. - LoginToken: []
  1886. summary: 创建功能权限
  1887. tags:
  1888. - API.menu
  1889. /api/menu_action/{id}:
  1890. delete:
  1891. consumes:
  1892. - application/json
  1893. description: 删除功能权限
  1894. parameters:
  1895. - description: hashId
  1896. in: path
  1897. name: id
  1898. required: true
  1899. type: string
  1900. produces:
  1901. - application/json
  1902. responses:
  1903. "200":
  1904. description: OK
  1905. schema:
  1906. $ref: '#/definitions/menu.deleteActionResponse'
  1907. "400":
  1908. description: Bad Request
  1909. schema:
  1910. $ref: '#/definitions/code.Failure'
  1911. security:
  1912. - LoginToken: []
  1913. summary: 删除功能权限
  1914. tags:
  1915. - API.menu
  1916. /api/tool/cache/clear:
  1917. patch:
  1918. consumes:
  1919. - application/x-www-form-urlencoded
  1920. description: 清空缓存
  1921. parameters:
  1922. - description: Redis Key
  1923. in: formData
  1924. name: redis_key
  1925. required: true
  1926. type: string
  1927. produces:
  1928. - application/json
  1929. responses:
  1930. "200":
  1931. description: OK
  1932. schema:
  1933. $ref: '#/definitions/tool.searchCacheResponse'
  1934. "400":
  1935. description: Bad Request
  1936. schema:
  1937. $ref: '#/definitions/code.Failure'
  1938. security:
  1939. - LoginToken: []
  1940. summary: 清空缓存
  1941. tags:
  1942. - API.tool
  1943. /api/tool/cache/search:
  1944. post:
  1945. consumes:
  1946. - application/x-www-form-urlencoded
  1947. description: 查询缓存
  1948. parameters:
  1949. - description: Redis Key
  1950. in: formData
  1951. name: redis_key
  1952. required: true
  1953. type: string
  1954. produces:
  1955. - application/json
  1956. responses:
  1957. "200":
  1958. description: OK
  1959. schema:
  1960. $ref: '#/definitions/tool.searchCacheResponse'
  1961. "400":
  1962. description: Bad Request
  1963. schema:
  1964. $ref: '#/definitions/code.Failure'
  1965. security:
  1966. - LoginToken: []
  1967. summary: 查询缓存
  1968. tags:
  1969. - API.tool
  1970. /api/tool/data/dbs:
  1971. get:
  1972. consumes:
  1973. - application/x-www-form-urlencoded
  1974. description: 查询 DB
  1975. produces:
  1976. - application/json
  1977. responses:
  1978. "200":
  1979. description: OK
  1980. schema:
  1981. $ref: '#/definitions/tool.dbsResponse'
  1982. "400":
  1983. description: Bad Request
  1984. schema:
  1985. $ref: '#/definitions/code.Failure'
  1986. security:
  1987. - LoginToken: []
  1988. summary: 查询 DB
  1989. tags:
  1990. - API.tool
  1991. /api/tool/data/mysql:
  1992. post:
  1993. consumes:
  1994. - application/x-www-form-urlencoded
  1995. description: 执行 SQL 语句
  1996. parameters:
  1997. - description: 数据库名称
  1998. in: formData
  1999. name: db_name
  2000. required: true
  2001. type: string
  2002. - description: 数据表名称
  2003. in: formData
  2004. name: table_name
  2005. required: true
  2006. type: string
  2007. - description: SQL 语句
  2008. in: formData
  2009. name: sql
  2010. required: true
  2011. type: string
  2012. produces:
  2013. - application/json
  2014. responses:
  2015. "200":
  2016. description: OK
  2017. schema:
  2018. $ref: '#/definitions/tool.searchMySQLResponse'
  2019. "400":
  2020. description: Bad Request
  2021. schema:
  2022. $ref: '#/definitions/code.Failure'
  2023. security:
  2024. - LoginToken: []
  2025. summary: 执行 SQL 语句
  2026. tags:
  2027. - API.tool
  2028. /api/tool/data/tables:
  2029. post:
  2030. consumes:
  2031. - application/x-www-form-urlencoded
  2032. description: 查询 Table
  2033. parameters:
  2034. - description: 数据库名称
  2035. in: formData
  2036. name: db_name
  2037. required: true
  2038. type: string
  2039. produces:
  2040. - application/json
  2041. responses:
  2042. "200":
  2043. description: OK
  2044. schema:
  2045. $ref: '#/definitions/tool.tablesResponse'
  2046. "400":
  2047. description: Bad Request
  2048. schema:
  2049. $ref: '#/definitions/code.Failure'
  2050. security:
  2051. - LoginToken: []
  2052. summary: 查询 Table
  2053. tags:
  2054. - API.tool
  2055. /api/tool/hashids/decode/{id}:
  2056. get:
  2057. consumes:
  2058. - application/x-www-form-urlencoded
  2059. description: HashIds 解密
  2060. parameters:
  2061. - description: 需解密的密文
  2062. in: path
  2063. name: id
  2064. required: true
  2065. type: string
  2066. produces:
  2067. - application/json
  2068. responses:
  2069. "200":
  2070. description: OK
  2071. schema:
  2072. $ref: '#/definitions/tool.hashIdsDecodeResponse'
  2073. "400":
  2074. description: Bad Request
  2075. schema:
  2076. $ref: '#/definitions/code.Failure'
  2077. security:
  2078. - LoginToken: []
  2079. summary: HashIds 解密
  2080. tags:
  2081. - API.tool
  2082. /api/tool/hashids/encode/{id}:
  2083. get:
  2084. consumes:
  2085. - application/x-www-form-urlencoded
  2086. description: HashIds 加密
  2087. parameters:
  2088. - description: 需加密的数字
  2089. in: path
  2090. name: id
  2091. required: true
  2092. type: string
  2093. produces:
  2094. - application/json
  2095. responses:
  2096. "200":
  2097. description: OK
  2098. schema:
  2099. $ref: '#/definitions/tool.hashIdsEncodeResponse'
  2100. "400":
  2101. description: Bad Request
  2102. schema:
  2103. $ref: '#/definitions/code.Failure'
  2104. security:
  2105. - LoginToken: []
  2106. summary: HashIds 加密
  2107. tags:
  2108. - API.tool
  2109. /api/tool/send_message:
  2110. post:
  2111. consumes:
  2112. - application/x-www-form-urlencoded
  2113. description: 发送消息
  2114. parameters:
  2115. - description: 消息内容
  2116. in: formData
  2117. name: message
  2118. required: true
  2119. type: string
  2120. produces:
  2121. - application/json
  2122. responses:
  2123. "200":
  2124. description: OK
  2125. schema:
  2126. $ref: '#/definitions/tool.sendMessageResponse'
  2127. "400":
  2128. description: Bad Request
  2129. schema:
  2130. $ref: '#/definitions/code.Failure'
  2131. security:
  2132. - LoginToken: []
  2133. summary: 发送消息
  2134. tags:
  2135. - API.tool
  2136. /helper/md5/{str}:
  2137. get:
  2138. consumes:
  2139. - application/x-www-form-urlencoded
  2140. description: 加密
  2141. parameters:
  2142. - description: 需要加密的字符串
  2143. in: path
  2144. name: str
  2145. required: true
  2146. type: string
  2147. produces:
  2148. - application/json
  2149. responses:
  2150. "200":
  2151. description: OK
  2152. schema:
  2153. $ref: '#/definitions/helper.md5Response'
  2154. "400":
  2155. description: Bad Request
  2156. schema:
  2157. $ref: '#/definitions/code.Failure'
  2158. summary: 加密
  2159. tags:
  2160. - Helper
  2161. /helper/sign:
  2162. post:
  2163. consumes:
  2164. - application/x-www-form-urlencoded
  2165. description: 签名
  2166. parameters:
  2167. - description: 调用方 KEY
  2168. in: formData
  2169. name: key
  2170. required: true
  2171. type: string
  2172. - description: 请求路径 (不附带 querystring),例如:/api/login
  2173. in: formData
  2174. name: path
  2175. required: true
  2176. type: string
  2177. - description: 请求方式,例如:POST
  2178. in: formData
  2179. name: method
  2180. required: true
  2181. type: string
  2182. - description: 请求参数,例如:username=tom&password=123456
  2183. in: formData
  2184. name: params
  2185. required: true
  2186. type: string
  2187. produces:
  2188. - application/json
  2189. responses:
  2190. "200":
  2191. description: OK
  2192. schema:
  2193. $ref: '#/definitions/helper.signResponse'
  2194. "400":
  2195. description: Bad Request
  2196. schema:
  2197. $ref: '#/definitions/code.Failure'
  2198. summary: 签名
  2199. tags:
  2200. - Helper
  2201. securityDefinitions:
  2202. LoginToken:
  2203. in: header
  2204. name: token
  2205. type: apiKey
  2206. swagger: "2.0"