广告平台(媒体使用)
您最多选择25个主题 主题必须以字母或数字开头,可以包含连字符 (-),并且长度不得超过35个字符
 
 
 
 
 
 

1388 行
32 KiB

  1. definitions:
  2. md.AccountBase:
  3. properties:
  4. admin_phone:
  5. example: 管理员手机号
  6. type: string
  7. company_abbreviation:
  8. example: 公司简称
  9. type: string
  10. company_name:
  11. example: 公司名称
  12. type: string
  13. contact_address:
  14. example: 联系地址
  15. type: string
  16. contact_email:
  17. example: 邮箱
  18. type: string
  19. contact_name:
  20. example: 联系人
  21. type: string
  22. contact_phone:
  23. example: 联系电话
  24. type: string
  25. country_region:
  26. example: 国家地区
  27. type: string
  28. currency_conf:
  29. example: 结算币种
  30. type: string
  31. medium_id:
  32. example: 账户ID
  33. type: string
  34. nickname:
  35. example: 昵称
  36. type: string
  37. type: object
  38. md.AccountUpdatePasswordReq:
  39. properties:
  40. captcha:
  41. example: 验证码
  42. type: string
  43. password:
  44. example: 登录密码
  45. type: string
  46. type: object
  47. md.AddAdminReq:
  48. properties:
  49. memo:
  50. type: string
  51. password:
  52. type: string
  53. username:
  54. type: string
  55. required:
  56. - password
  57. - username
  58. type: object
  59. md.AddRoleReq:
  60. properties:
  61. memo:
  62. type: string
  63. name:
  64. type: string
  65. required:
  66. - memo
  67. - name
  68. type: object
  69. md.AdminListReq:
  70. properties:
  71. limit:
  72. type: integer
  73. page:
  74. type: integer
  75. state:
  76. type: integer
  77. username:
  78. type: string
  79. type: object
  80. md.AppletApplicationAdSpaceListData:
  81. properties:
  82. ad_id:
  83. example: 广告位id
  84. type: string
  85. app_id:
  86. example: 小程序appid
  87. type: string
  88. cooperate_state:
  89. example: 合作状态
  90. type: string
  91. id:
  92. example: id
  93. type: string
  94. kind:
  95. example: 广告位类型
  96. type: string
  97. logo:
  98. example: logo
  99. type: string
  100. memo:
  101. example: 备注
  102. type: string
  103. name:
  104. example: 应用名称
  105. type: string
  106. platform:
  107. example: 平台
  108. type: string
  109. state:
  110. example: 应用状态 state=2 才能再次编辑
  111. type: string
  112. type: object
  113. md.AppletApplicationAdSpaceListReq:
  114. properties:
  115. cooperate_state:
  116. example: 合作状态
  117. type: string
  118. limit:
  119. type: string
  120. name:
  121. type: string
  122. page:
  123. type: string
  124. platform:
  125. type: string
  126. type: object
  127. md.AppletApplicationAdSpaceListRes:
  128. properties:
  129. ad_type:
  130. items:
  131. $ref: '#/definitions/md.SelectData'
  132. type: array
  133. application:
  134. items:
  135. additionalProperties:
  136. type: string
  137. type: object
  138. type: array
  139. cooperate_state:
  140. items:
  141. $ref: '#/definitions/md.SelectData'
  142. type: array
  143. list:
  144. items:
  145. $ref: '#/definitions/md.AppletApplicationAdSpaceListData'
  146. type: array
  147. platform:
  148. items:
  149. $ref: '#/definitions/md.SelectData'
  150. type: array
  151. state:
  152. items:
  153. $ref: '#/definitions/md.SelectData'
  154. type: array
  155. total:
  156. type: integer
  157. type: object
  158. md.AppletApplicationAdSpaceSaveReq:
  159. properties:
  160. app_id:
  161. example: 小程序appid
  162. type: string
  163. kind:
  164. example: 广告类型
  165. type: string
  166. name:
  167. example: 应用名称
  168. type: string
  169. type: object
  170. md.AppletApplicationListData:
  171. properties:
  172. app_id:
  173. example: 小程序appid
  174. type: string
  175. cooperate_state:
  176. example: 合作状态
  177. type: string
  178. id:
  179. example: id
  180. type: string
  181. logo:
  182. example: logo
  183. type: string
  184. memo:
  185. example: 备注
  186. type: string
  187. name:
  188. example: 应用名称
  189. type: string
  190. original_id:
  191. example: 小程序id
  192. type: string
  193. platform:
  194. example: 平台
  195. type: string
  196. state:
  197. example: 应用状态 state=3 才能再次编辑
  198. type: string
  199. type: object
  200. md.AppletApplicationListReq:
  201. properties:
  202. cooperate_state:
  203. example: 合作状态
  204. type: string
  205. limit:
  206. type: string
  207. name:
  208. type: string
  209. page:
  210. type: string
  211. platform:
  212. type: string
  213. type: object
  214. md.AppletApplicationListRes:
  215. properties:
  216. cooperate_state:
  217. items:
  218. $ref: '#/definitions/md.SelectData'
  219. type: array
  220. list:
  221. items:
  222. $ref: '#/definitions/md.AppletApplicationListData'
  223. type: array
  224. platform:
  225. items:
  226. $ref: '#/definitions/md.SelectData'
  227. type: array
  228. state:
  229. items:
  230. $ref: '#/definitions/md.SelectData'
  231. type: array
  232. total:
  233. type: integer
  234. type: object
  235. md.AppletApplicationSaveReq:
  236. properties:
  237. app_id:
  238. example: 小程序appid
  239. type: string
  240. id:
  241. example: id
  242. type: string
  243. logo:
  244. example: logo
  245. type: string
  246. name:
  247. example: 应用名称
  248. type: string
  249. original_id:
  250. example: 小程序id
  251. type: string
  252. platform:
  253. example: 平台 微信小程序:wx_applet
  254. type: string
  255. type: object
  256. md.BindAdminRoleReq:
  257. properties:
  258. id:
  259. type: integer
  260. role_ids:
  261. items:
  262. type: integer
  263. type: array
  264. required:
  265. - id
  266. type: object
  267. md.ImgReqUpload:
  268. properties:
  269. dir:
  270. type: string
  271. file_name:
  272. type: string
  273. file_size:
  274. description: 文件大小, 单位byte
  275. type: integer
  276. type: object
  277. md.LoginPhoneReq:
  278. properties:
  279. captcha:
  280. example: 验证码
  281. type: string
  282. username:
  283. example: 登录账号
  284. type: string
  285. required:
  286. - captcha
  287. - username
  288. type: object
  289. md.LoginReq:
  290. properties:
  291. code:
  292. example: 验证码
  293. type: string
  294. password:
  295. example: 登录密码
  296. type: string
  297. username:
  298. example: 登录账号
  299. type: string
  300. required:
  301. - password
  302. - username
  303. type: object
  304. md.LoginResponse:
  305. properties:
  306. token:
  307. type: string
  308. type: object
  309. md.MediumBankInfo:
  310. properties:
  311. bank:
  312. type: string
  313. bank_branch:
  314. type: string
  315. bank_no:
  316. type: string
  317. currency_conf:
  318. type: string
  319. id:
  320. type: string
  321. licence:
  322. type: string
  323. medium_id:
  324. type: string
  325. memo:
  326. type: string
  327. state:
  328. type: string
  329. uuid:
  330. type: string
  331. type: object
  332. md.MediumContactInfo:
  333. properties:
  334. address:
  335. type: string
  336. email:
  337. type: string
  338. id:
  339. type: string
  340. medium_id:
  341. type: string
  342. memo:
  343. type: string
  344. name:
  345. type: string
  346. phone:
  347. type: string
  348. state:
  349. type: string
  350. uuid:
  351. type: string
  352. type: object
  353. md.MediumList:
  354. properties:
  355. business_license_address:
  356. type: string
  357. business_license_img_url:
  358. type: string
  359. certificate_first_type:
  360. type: string
  361. certificate_type:
  362. type: string
  363. certificate_validity:
  364. type: string
  365. company_abbreviation:
  366. type: string
  367. company_name:
  368. type: string
  369. country_region:
  370. type: string
  371. country_region_id:
  372. type: string
  373. id:
  374. type: string
  375. kind:
  376. type: string
  377. legal_representative:
  378. type: string
  379. medium_id:
  380. type: string
  381. memo:
  382. type: string
  383. registered_address:
  384. type: string
  385. registered_address_city_id:
  386. type: string
  387. registered_address_country_id:
  388. type: string
  389. registered_address_county_id:
  390. type: string
  391. registered_address_province_id:
  392. type: string
  393. state:
  394. type: string
  395. unified_social_credit_code:
  396. type: string
  397. uuid:
  398. type: string
  399. type: object
  400. md.Response:
  401. properties:
  402. code:
  403. example: 响应码
  404. type: string
  405. data:
  406. description: 内容
  407. msg:
  408. example: 具体错误原因
  409. type: string
  410. type: object
  411. md.RoleBindPermissionGroupReq:
  412. properties:
  413. permission_ids:
  414. items:
  415. type: integer
  416. type: array
  417. role_id:
  418. type: integer
  419. required:
  420. - role_id
  421. type: object
  422. md.SelectData:
  423. properties:
  424. name:
  425. example: 名称
  426. type: string
  427. value:
  428. example: 值
  429. type: string
  430. type: object
  431. md.SmsReq:
  432. properties:
  433. phone:
  434. type: string
  435. type:
  436. example: 手机号登陆:fast_login 注册:register 修改密码(不用传手机号):update_password
  437. type: string
  438. type: object
  439. md.UpdateAdminReq:
  440. properties:
  441. id:
  442. type: integer
  443. memo:
  444. type: string
  445. password:
  446. type: string
  447. username:
  448. type: string
  449. required:
  450. - id
  451. - password
  452. - username
  453. type: object
  454. md.UpdateAdminStateReq:
  455. properties:
  456. id:
  457. type: integer
  458. state:
  459. type: integer
  460. required:
  461. - id
  462. - state
  463. type: object
  464. md.UpdateRoleReq:
  465. properties:
  466. memo:
  467. type: string
  468. name:
  469. type: string
  470. role_id:
  471. type: integer
  472. required:
  473. - memo
  474. - name
  475. - role_id
  476. type: object
  477. md.UpdateRoleStateReq:
  478. properties:
  479. role_id:
  480. type: integer
  481. state:
  482. type: integer
  483. required:
  484. - role_id
  485. - state
  486. type: object
  487. host: localhost:1004 or xxxxx.medium.dengbiao.top
  488. info:
  489. contact:
  490. email: 1239118001@qq.com
  491. name: dengbiao
  492. url: http://www.swagger.io/support
  493. description: 媒体后台接口
  494. license:
  495. name: Apache 2.0
  496. url: http://www.apache.org/licenses/LICENSE-2.0.html
  497. termsOfService: http://swagger.io/terms/
  498. title: 广告联盟-媒体平台
  499. version: "1.0"
  500. paths:
  501. /api/account/base:
  502. get:
  503. consumes:
  504. - application/json
  505. description: 账号信息
  506. parameters:
  507. - description: 验证参数Bearer和token空格拼接
  508. in: header
  509. name: Authorization
  510. required: true
  511. type: string
  512. produces:
  513. - application/json
  514. responses:
  515. "200":
  516. description: 具体看返回内容
  517. schema:
  518. $ref: '#/definitions/md.AccountBase'
  519. "400":
  520. description: 具体错误
  521. schema:
  522. $ref: '#/definitions/md.Response'
  523. summary: 账号信息
  524. tags:
  525. - 账号中心------嘉俊
  526. /api/account/qualification/bank/save:
  527. post:
  528. consumes:
  529. - application/json
  530. description: 资质认证-银行资质保存
  531. parameters:
  532. - description: 验证参数Bearer和token空格拼接
  533. in: header
  534. name: Authorization
  535. required: true
  536. type: string
  537. - description: 请求参数
  538. in: body
  539. name: args
  540. required: true
  541. schema:
  542. $ref: '#/definitions/md.MediumBankInfo'
  543. produces:
  544. - application/json
  545. responses:
  546. "200":
  547. description: 具体看返回内容
  548. schema:
  549. type: string
  550. "400":
  551. description: 具体错误
  552. schema:
  553. $ref: '#/definitions/md.Response'
  554. summary: 银行资质保存
  555. tags:
  556. - 账号中心------嘉俊
  557. /api/account/qualification/contact/save:
  558. post:
  559. consumes:
  560. - application/json
  561. description: 资质认证-联系方式保存
  562. parameters:
  563. - description: 验证参数Bearer和token空格拼接
  564. in: header
  565. name: Authorization
  566. required: true
  567. type: string
  568. - description: 请求参数
  569. in: body
  570. name: args
  571. required: true
  572. schema:
  573. $ref: '#/definitions/md.MediumContactInfo'
  574. produces:
  575. - application/json
  576. responses:
  577. "200":
  578. description: 具体看返回内容
  579. schema:
  580. type: string
  581. "400":
  582. description: 具体错误
  583. schema:
  584. $ref: '#/definitions/md.Response'
  585. summary: 联系方式保存
  586. tags:
  587. - 账号中心------嘉俊
  588. /api/account/qualification/enterprise/save:
  589. post:
  590. consumes:
  591. - application/json
  592. description: 资质认证-企业认证保存
  593. parameters:
  594. - description: 验证参数Bearer和token空格拼接
  595. in: header
  596. name: Authorization
  597. required: true
  598. type: string
  599. - description: 请求参数
  600. in: body
  601. name: args
  602. required: true
  603. schema:
  604. $ref: '#/definitions/md.MediumList'
  605. produces:
  606. - application/json
  607. responses:
  608. "200":
  609. description: 具体看返回内容
  610. schema:
  611. type: string
  612. "400":
  613. description: 具体错误
  614. schema:
  615. $ref: '#/definitions/md.Response'
  616. summary: 企业认证保存
  617. tags:
  618. - 账号中心------嘉俊
  619. /api/account/qualification/info:
  620. get:
  621. consumes:
  622. - application/json
  623. description: 资质认证-基本信息
  624. parameters:
  625. - description: 验证参数Bearer和token空格拼接
  626. in: header
  627. name: Authorization
  628. required: true
  629. type: string
  630. produces:
  631. - application/json
  632. responses:
  633. "200":
  634. description: 具体看返回内容
  635. schema:
  636. type: string
  637. "400":
  638. description: 具体错误
  639. schema:
  640. $ref: '#/definitions/md.Response'
  641. summary: 基本信息
  642. tags:
  643. - 账号中心------嘉俊
  644. /api/account/qualification/select/base:
  645. get:
  646. consumes:
  647. - application/json
  648. description: 资质认证-认证下拉框选择内容
  649. parameters:
  650. - description: 验证参数Bearer和token空格拼接
  651. in: header
  652. name: Authorization
  653. required: true
  654. type: string
  655. produces:
  656. - application/json
  657. responses:
  658. "200":
  659. description: 具体看返回内容
  660. schema:
  661. type: string
  662. "400":
  663. description: 具体错误
  664. schema:
  665. $ref: '#/definitions/md.Response'
  666. summary: 认证下拉框选择内容
  667. tags:
  668. - 账号中心------嘉俊
  669. /api/account/update/password:
  670. post:
  671. consumes:
  672. - application/json
  673. description: 资质认证-企业认证保存
  674. parameters:
  675. - description: 验证参数Bearer和token空格拼接
  676. in: header
  677. name: Authorization
  678. required: true
  679. type: string
  680. - description: 请求参数
  681. in: body
  682. name: args
  683. required: true
  684. schema:
  685. $ref: '#/definitions/md.AccountUpdatePasswordReq'
  686. produces:
  687. - application/json
  688. responses:
  689. "200":
  690. description: 具体看返回内容
  691. schema:
  692. type: string
  693. "400":
  694. description: 具体错误
  695. schema:
  696. $ref: '#/definitions/md.Response'
  697. summary: 企业认证保存
  698. tags:
  699. - 账号中心------嘉俊
  700. /api/applet/application/ad/space/list:
  701. post:
  702. consumes:
  703. - application/json
  704. description: 小程序应用-广告位列表
  705. parameters:
  706. - description: 验证参数Bearer和token空格拼接
  707. in: header
  708. name: Authorization
  709. required: true
  710. type: string
  711. - description: 请求参数
  712. in: body
  713. name: args
  714. required: true
  715. schema:
  716. $ref: '#/definitions/md.AppletApplicationAdSpaceListReq'
  717. produces:
  718. - application/json
  719. responses:
  720. "200":
  721. description: 具体看返回内容---这是data里面的数据
  722. schema:
  723. $ref: '#/definitions/md.AppletApplicationAdSpaceListRes'
  724. "400":
  725. description: 具体错误
  726. schema:
  727. $ref: '#/definitions/md.Response'
  728. summary: 广告位列表
  729. tags:
  730. - 小程序应用------嘉俊
  731. /api/applet/application/ad/space/save:
  732. post:
  733. consumes:
  734. - application/json
  735. description: 小程序应用-广告位新增
  736. parameters:
  737. - description: 验证参数Bearer和token空格拼接
  738. in: header
  739. name: Authorization
  740. required: true
  741. type: string
  742. - description: 请求参数
  743. in: body
  744. name: args
  745. required: true
  746. schema:
  747. $ref: '#/definitions/md.AppletApplicationAdSpaceSaveReq'
  748. produces:
  749. - application/json
  750. responses:
  751. "200":
  752. description: 具体看返回内容
  753. schema:
  754. type: string
  755. "400":
  756. description: 具体错误
  757. schema:
  758. $ref: '#/definitions/md.Response'
  759. summary: 广告位新增
  760. tags:
  761. - 小程序应用------嘉俊
  762. /api/application/applet/list:
  763. post:
  764. consumes:
  765. - application/json
  766. description: 小程序应用-列表数据
  767. parameters:
  768. - description: 验证参数Bearer和token空格拼接
  769. in: header
  770. name: Authorization
  771. required: true
  772. type: string
  773. - description: 请求参数
  774. in: body
  775. name: args
  776. required: true
  777. schema:
  778. $ref: '#/definitions/md.AppletApplicationListReq'
  779. produces:
  780. - application/json
  781. responses:
  782. "200":
  783. description: 具体看返回内容---这是data里面的数据
  784. schema:
  785. $ref: '#/definitions/md.AppletApplicationListRes'
  786. "400":
  787. description: 具体错误
  788. schema:
  789. $ref: '#/definitions/md.Response'
  790. summary: 列表数据
  791. tags:
  792. - 小程序应用------嘉俊
  793. /api/application/applet/save:
  794. post:
  795. consumes:
  796. - application/json
  797. description: 小程序应用-新增或保存
  798. parameters:
  799. - description: 验证参数Bearer和token空格拼接
  800. in: header
  801. name: Authorization
  802. required: true
  803. type: string
  804. - description: 请求参数
  805. in: body
  806. name: args
  807. required: true
  808. schema:
  809. $ref: '#/definitions/md.AppletApplicationSaveReq'
  810. produces:
  811. - application/json
  812. responses:
  813. "200":
  814. description: 具体看返回内容
  815. schema:
  816. type: string
  817. "400":
  818. description: 具体错误
  819. schema:
  820. $ref: '#/definitions/md.Response'
  821. summary: 新增或保存
  822. tags:
  823. - 小程序应用------嘉俊
  824. /api/login:
  825. post:
  826. consumes:
  827. - application/json
  828. description: 登入
  829. parameters:
  830. - description: 用户名、密码
  831. in: body
  832. name: req
  833. required: true
  834. schema:
  835. $ref: '#/definitions/md.LoginReq'
  836. produces:
  837. - application/json
  838. responses:
  839. "200":
  840. description: token
  841. schema:
  842. $ref: '#/definitions/md.LoginResponse'
  843. "400":
  844. description: 具体错误
  845. schema:
  846. $ref: '#/definitions/md.Response'
  847. summary: 登陆
  848. tags:
  849. - ADMIN
  850. /api/login/phone:
  851. post:
  852. consumes:
  853. - application/json
  854. description: 手机号登入
  855. parameters:
  856. - description: 用户名、验证码
  857. in: body
  858. name: req
  859. required: true
  860. schema:
  861. $ref: '#/definitions/md.LoginPhoneReq'
  862. produces:
  863. - application/json
  864. responses:
  865. "200":
  866. description: token
  867. schema:
  868. $ref: '#/definitions/md.LoginResponse'
  869. "400":
  870. description: 具体错误
  871. schema:
  872. $ref: '#/definitions/md.Response'
  873. summary: 手机号登陆
  874. tags:
  875. - ADMIN
  876. /api/qiniuyun/upload:
  877. post:
  878. consumes:
  879. - application/json
  880. description: 七牛云-七牛云上传
  881. parameters:
  882. - description: 验证参数Bearer和token空格拼接
  883. in: header
  884. name: Authorization
  885. type: string
  886. - description: 请求参数
  887. in: body
  888. name: args
  889. required: true
  890. schema:
  891. $ref: '#/definitions/md.ImgReqUpload'
  892. produces:
  893. - application/json
  894. responses:
  895. "200":
  896. description: success
  897. schema:
  898. type: string
  899. "400":
  900. description: 具体错误
  901. schema:
  902. $ref: '#/definitions/md.Response'
  903. summary: 七牛云上传
  904. tags:
  905. - 七牛云
  906. /api/register:
  907. post:
  908. consumes:
  909. - application/json
  910. description: 手机号注册
  911. parameters:
  912. - description: 用户名、验证码
  913. in: body
  914. name: req
  915. required: true
  916. schema:
  917. $ref: '#/definitions/md.LoginReq'
  918. produces:
  919. - application/json
  920. responses:
  921. "200":
  922. description: token
  923. schema:
  924. $ref: '#/definitions/md.LoginResponse'
  925. "400":
  926. description: 具体错误
  927. schema:
  928. $ref: '#/definitions/md.Response'
  929. summary: 手机号注册
  930. tags:
  931. - ADMIN
  932. /api/role/addAdmin:
  933. post:
  934. consumes:
  935. - application/json
  936. description: 新增管理员
  937. parameters:
  938. - description: 验证参数Bearer和token空格拼接
  939. in: header
  940. name: Authorization
  941. required: true
  942. type: string
  943. - description: 请求参数
  944. in: body
  945. name: args
  946. required: true
  947. schema:
  948. $ref: '#/definitions/md.AddAdminReq'
  949. produces:
  950. - application/json
  951. responses:
  952. "200":
  953. description: success
  954. schema:
  955. type: string
  956. "400":
  957. description: 具体错误
  958. schema:
  959. $ref: '#/definitions/md.Response'
  960. summary: 新增管理员
  961. tags:
  962. - ADMIN-权限管理
  963. /api/role/addRole:
  964. post:
  965. consumes:
  966. - application/json
  967. description: 添加角色
  968. parameters:
  969. - description: 验证参数Bearer和token空格拼接
  970. in: header
  971. name: Authorization
  972. required: true
  973. type: string
  974. - description: 请求参数
  975. in: body
  976. name: args
  977. required: true
  978. schema:
  979. $ref: '#/definitions/md.AddRoleReq'
  980. produces:
  981. - application/json
  982. responses:
  983. "200":
  984. description: success
  985. schema:
  986. type: string
  987. "400":
  988. description: 具体错误
  989. schema:
  990. $ref: '#/definitions/md.Response'
  991. summary: 添加角色
  992. tags:
  993. - ADMIN-权限管理
  994. /api/role/adminInfo:
  995. get:
  996. consumes:
  997. - application/json
  998. description: 管理员信息
  999. parameters:
  1000. - description: 验证参数Bearer和token空格拼接
  1001. in: header
  1002. name: Authorization
  1003. required: true
  1004. type: string
  1005. - description: 管理员id
  1006. in: query
  1007. name: adm_id
  1008. required: true
  1009. type: string
  1010. produces:
  1011. - application/json
  1012. responses:
  1013. "200":
  1014. description: 具体看返回内容
  1015. schema:
  1016. type: string
  1017. "400":
  1018. description: 具体错误
  1019. schema:
  1020. $ref: '#/definitions/md.Response'
  1021. summary: 管理员信息
  1022. tags:
  1023. - ADMIN-权限管理
  1024. /api/role/adminList:
  1025. post:
  1026. consumes:
  1027. - application/json
  1028. description: 管理员列表
  1029. parameters:
  1030. - description: 验证参数Bearer和token空格拼接
  1031. in: header
  1032. name: Authorization
  1033. required: true
  1034. type: string
  1035. - description: 请求参数
  1036. in: body
  1037. name: args
  1038. required: true
  1039. schema:
  1040. $ref: '#/definitions/md.AdminListReq'
  1041. produces:
  1042. - application/json
  1043. responses:
  1044. "200":
  1045. description: 具体看返回内容
  1046. schema:
  1047. type: string
  1048. "400":
  1049. description: 具体错误
  1050. schema:
  1051. $ref: '#/definitions/md.Response'
  1052. summary: 管理员列表
  1053. tags:
  1054. - ADMIN-权限管理
  1055. /api/role/bindAdminRole/:
  1056. post:
  1057. consumes:
  1058. - application/json
  1059. description: 管理员绑定角色
  1060. parameters:
  1061. - description: 验证参数Bearer和token空格拼接
  1062. in: header
  1063. name: Authorization
  1064. required: true
  1065. type: string
  1066. - description: 请求参数
  1067. in: body
  1068. name: args
  1069. required: true
  1070. schema:
  1071. $ref: '#/definitions/md.BindAdminRoleReq'
  1072. produces:
  1073. - application/json
  1074. responses:
  1075. "200":
  1076. description: success
  1077. schema:
  1078. type: string
  1079. "400":
  1080. description: 具体错误
  1081. schema:
  1082. $ref: '#/definitions/md.Response'
  1083. summary: 管理员绑定角色
  1084. tags:
  1085. - ADMIN-权限管理
  1086. /api/role/deleteAdmin/{$adm_id}:
  1087. delete:
  1088. consumes:
  1089. - application/json
  1090. description: 删除管理员
  1091. parameters:
  1092. - description: 验证参数Bearer和token空格拼接
  1093. in: header
  1094. name: Authorization
  1095. required: true
  1096. type: string
  1097. produces:
  1098. - application/json
  1099. responses:
  1100. "200":
  1101. description: success
  1102. schema:
  1103. type: string
  1104. "400":
  1105. description: 具体错误
  1106. schema:
  1107. $ref: '#/definitions/md.Response'
  1108. summary: 删除管理员
  1109. tags:
  1110. - ADMIN-权限管理
  1111. /api/role/deleteRole/{$id}:
  1112. delete:
  1113. consumes:
  1114. - application/json
  1115. description: 删除角色
  1116. parameters:
  1117. - description: 验证参数Bearer和token空格拼接
  1118. in: header
  1119. name: Authorization
  1120. required: true
  1121. type: string
  1122. - description: 请求参数
  1123. in: body
  1124. name: args
  1125. required: true
  1126. schema:
  1127. $ref: '#/definitions/md.UpdateRoleStateReq'
  1128. produces:
  1129. - application/json
  1130. responses:
  1131. "200":
  1132. description: success
  1133. schema:
  1134. type: string
  1135. "400":
  1136. description: 具体错误
  1137. schema:
  1138. $ref: '#/definitions/md.Response'
  1139. summary: 删除角色
  1140. tags:
  1141. - ADMIN-权限管理
  1142. /api/role/permissionGroupList:
  1143. get:
  1144. consumes:
  1145. - application/json
  1146. description: 权限组列表
  1147. parameters:
  1148. - description: 验证参数Bearer和token空格拼接
  1149. in: header
  1150. name: Authorization
  1151. required: true
  1152. type: string
  1153. - description: 管理员id
  1154. in: query
  1155. name: adm_id
  1156. required: true
  1157. type: string
  1158. produces:
  1159. - application/json
  1160. responses:
  1161. "200":
  1162. description: 具体看返回内容
  1163. schema:
  1164. type: string
  1165. "400":
  1166. description: 具体错误
  1167. schema:
  1168. $ref: '#/definitions/md.Response'
  1169. summary: 权限组列表
  1170. tags:
  1171. - ADMIN-权限管理
  1172. /api/role/roleBindPermissionGroup:
  1173. post:
  1174. consumes:
  1175. - application/json
  1176. description: 角色绑定权限组
  1177. parameters:
  1178. - description: 验证参数Bearer和token空格拼接
  1179. in: header
  1180. name: Authorization
  1181. required: true
  1182. type: string
  1183. - description: 请求参数
  1184. in: body
  1185. name: args
  1186. required: true
  1187. schema:
  1188. $ref: '#/definitions/md.RoleBindPermissionGroupReq'
  1189. produces:
  1190. - application/json
  1191. responses:
  1192. "200":
  1193. description: success
  1194. schema:
  1195. type: string
  1196. "400":
  1197. description: 具体错误
  1198. schema:
  1199. $ref: '#/definitions/md.Response'
  1200. summary: 角色绑定权限组
  1201. tags:
  1202. - ADMIN-权限管理
  1203. /api/role/roleList:
  1204. get:
  1205. consumes:
  1206. - application/json
  1207. description: 角色列表
  1208. parameters:
  1209. - description: 验证参数Bearer和token空格拼接
  1210. in: header
  1211. name: Authorization
  1212. required: true
  1213. type: string
  1214. produces:
  1215. - application/json
  1216. responses:
  1217. "200":
  1218. description: 具体看返回内容
  1219. schema:
  1220. type: string
  1221. "400":
  1222. description: 具体错误
  1223. schema:
  1224. $ref: '#/definitions/md.Response'
  1225. summary: 角色列表
  1226. tags:
  1227. - ADMIN-权限管理
  1228. /api/role/updateAdmin:
  1229. post:
  1230. consumes:
  1231. - application/json
  1232. description: 修改管理员信息
  1233. parameters:
  1234. - description: 验证参数Bearer和token空格拼接
  1235. in: header
  1236. name: Authorization
  1237. required: true
  1238. type: string
  1239. - description: 请求参数
  1240. in: body
  1241. name: args
  1242. required: true
  1243. schema:
  1244. $ref: '#/definitions/md.UpdateAdminReq'
  1245. produces:
  1246. - application/json
  1247. responses:
  1248. "200":
  1249. description: success
  1250. schema:
  1251. type: string
  1252. "400":
  1253. description: 具体错误
  1254. schema:
  1255. $ref: '#/definitions/md.Response'
  1256. summary: 修改管理员信息
  1257. tags:
  1258. - ADMIN-权限管理
  1259. /api/role/updateAdminState:
  1260. post:
  1261. consumes:
  1262. - application/json
  1263. description: 修改管理员状态
  1264. parameters:
  1265. - description: 验证参数Bearer和token空格拼接
  1266. in: header
  1267. name: Authorization
  1268. required: true
  1269. type: string
  1270. - description: 请求参数
  1271. in: body
  1272. name: args
  1273. required: true
  1274. schema:
  1275. $ref: '#/definitions/md.UpdateAdminStateReq'
  1276. produces:
  1277. - application/json
  1278. responses:
  1279. "200":
  1280. description: success
  1281. schema:
  1282. type: string
  1283. "400":
  1284. description: 具体错误
  1285. schema:
  1286. $ref: '#/definitions/md.Response'
  1287. summary: 修改管理员状态
  1288. tags:
  1289. - ADMIN-权限管理
  1290. /api/role/updateRole:
  1291. post:
  1292. consumes:
  1293. - application/json
  1294. description: 修改角色
  1295. parameters:
  1296. - description: 验证参数Bearer和token空格拼接
  1297. in: header
  1298. name: Authorization
  1299. required: true
  1300. type: string
  1301. - description: 请求参数
  1302. in: body
  1303. name: args
  1304. required: true
  1305. schema:
  1306. $ref: '#/definitions/md.UpdateRoleReq'
  1307. produces:
  1308. - application/json
  1309. responses:
  1310. "200":
  1311. description: success
  1312. schema:
  1313. type: string
  1314. "400":
  1315. description: 具体错误
  1316. schema:
  1317. $ref: '#/definitions/md.Response'
  1318. summary: 修改角色
  1319. tags:
  1320. - ADMIN-权限管理
  1321. /api/role/updateRoleState:
  1322. post:
  1323. consumes:
  1324. - application/json
  1325. description: 修改角色状态
  1326. parameters:
  1327. - description: 验证参数Bearer和token空格拼接
  1328. in: header
  1329. name: Authorization
  1330. required: true
  1331. type: string
  1332. - description: 请求参数
  1333. in: body
  1334. name: args
  1335. required: true
  1336. schema:
  1337. $ref: '#/definitions/md.UpdateRoleStateReq'
  1338. produces:
  1339. - application/json
  1340. responses:
  1341. "200":
  1342. description: success
  1343. schema:
  1344. type: string
  1345. "400":
  1346. description: 具体错误
  1347. schema:
  1348. $ref: '#/definitions/md.Response'
  1349. summary: 修改角色状态
  1350. tags:
  1351. - ADMIN-权限管理
  1352. /api/sms:
  1353. post:
  1354. consumes:
  1355. - application/json
  1356. description: 短信-短信发送
  1357. parameters:
  1358. - description: 验证参数Bearer和token空格拼接
  1359. in: header
  1360. name: Authorization
  1361. type: string
  1362. - description: 请求参数
  1363. in: body
  1364. name: args
  1365. required: true
  1366. schema:
  1367. $ref: '#/definitions/md.SmsReq'
  1368. produces:
  1369. - application/json
  1370. responses:
  1371. "200":
  1372. description: success
  1373. schema:
  1374. type: string
  1375. "400":
  1376. description: 具体错误
  1377. schema:
  1378. $ref: '#/definitions/md.Response'
  1379. summary: 短信发送
  1380. tags:
  1381. - 短信
  1382. securityDefinitions:
  1383. MasterID:
  1384. in: header
  1385. name: MasterID
  1386. type: apiKey
  1387. swagger: "2.0"