api.yaml 50 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023
  1. openapi: 3.0.0
  2. info:
  3. title: POS系统api
  4. description: "\n * 所有接口请求请使用json形式(get除外)\n * pad后台管理请使用管理员登入获取token 把token放在协议头(head)来请求其他接口"
  5. version: '0.1'
  6. paths:
  7. /api/Admin/index:
  8. get:
  9. tags:
  10. - 管理员管理
  11. summary: 管理员列表
  12. operationId: 'app\api\controller\Admin::index'
  13. parameters:
  14. -
  15. name: token
  16. in: header
  17. description: token
  18. schema:
  19. type: string
  20. -
  21. name: page
  22. in: query
  23. description: 页码
  24. schema:
  25. type: ineger
  26. default: '1'
  27. -
  28. name: pageSize
  29. in: query
  30. description: 页尺寸
  31. schema:
  32. type: integer
  33. default: '10'
  34. -
  35. name: status
  36. in: query
  37. description: '状态 1正常 2删除'
  38. schema:
  39. type: integer
  40. default: '1'
  41. -
  42. name: name
  43. in: query
  44. description: 名称
  45. schema:
  46. type: string
  47. -
  48. name: mobile
  49. in: query
  50. description: 手机号
  51. schema:
  52. type: string
  53. -
  54. name: roleId
  55. in: query
  56. description: 角色id
  57. schema:
  58. type: ineger
  59. requestBody: { }
  60. responses:
  61. '200':
  62. description: 请求成功
  63. /api/Admin/save:
  64. post:
  65. tags:
  66. - 管理员管理
  67. summary: 保存管理员信息
  68. operationId: 'app\api\controller\Admin::save'
  69. parameters:
  70. -
  71. name: token
  72. in: header
  73. description: token
  74. schema:
  75. type: string
  76. requestBody:
  77. content:
  78. multipart/form-data:
  79. schema:
  80. required:
  81. - name
  82. - account
  83. - mobile
  84. - roleId
  85. - groupIds
  86. - storeIds
  87. properties:
  88. name:
  89. description: 管理员名称
  90. type: string
  91. default: jack
  92. account:
  93. description: 登入账号
  94. type: string
  95. default: admin01
  96. password:
  97. description: 登入密码
  98. type: string
  99. default: '123465'
  100. mobile:
  101. description: 手机号
  102. type: string
  103. default: '12367897654'
  104. roleId:
  105. description: 角色id-单选
  106. type: integer
  107. default: '1'
  108. groupIds:
  109. description: 集团id-多选
  110. type: string
  111. default: '1,2'
  112. storeIds:
  113. description: 门店id-多选
  114. type: string
  115. default: '1,2'
  116. macAdress:
  117. description: mac地址
  118. type: string
  119. default: '1,2'
  120. id:
  121. description: 管理员id
  122. type: string
  123. default: '0'
  124. type: object
  125. responses:
  126. '200':
  127. description: 请求成功
  128. /api/Admin/login:
  129. post:
  130. tags:
  131. - 管理员管理
  132. summary: 管理员登入
  133. operationId: 'app\api\controller\Admin::login'
  134. parameters:
  135. -
  136. name: token
  137. in: header
  138. description: token
  139. schema:
  140. type: string
  141. requestBody:
  142. content:
  143. multipart/form-data:
  144. schema:
  145. required:
  146. - account
  147. - password
  148. - code
  149. properties:
  150. account:
  151. description: 登入账号
  152. type: string
  153. default: admin
  154. password:
  155. description: 登入密码
  156. type: string
  157. default: '123456'
  158. code:
  159. description: 验证码
  160. type: string
  161. default: '9999'
  162. uniqueKey:
  163. description: 生成验证码时的唯一码
  164. type: string
  165. default: sdafsdfsd
  166. type: object
  167. responses:
  168. '200':
  169. description: 请求成功
  170. /api/Admin/read:
  171. get:
  172. tags:
  173. - 管理员管理
  174. summary: 查看管理员个人信息
  175. operationId: 'app\api\controller\Admin::read'
  176. parameters:
  177. -
  178. name: token
  179. in: header
  180. description: token
  181. schema:
  182. type: string
  183. -
  184. name: id
  185. in: query
  186. description: 管理员id
  187. schema:
  188. type: ineger
  189. requestBody: { }
  190. responses:
  191. '200':
  192. description: 请求成功
  193. /api/Admin/delete:
  194. get:
  195. tags:
  196. - 管理员管理
  197. summary: 删除管理员信息
  198. operationId: 'app\api\controller\Admin::delete'
  199. parameters:
  200. -
  201. name: token
  202. in: header
  203. description: token
  204. schema:
  205. type: string
  206. -
  207. name: id
  208. in: query
  209. description: 管理员id
  210. schema:
  211. type: ineger
  212. default: '1'
  213. -
  214. name: status
  215. in: query
  216. description: '1正常 2删除'
  217. schema:
  218. type: ineger
  219. default: '1'
  220. requestBody: { }
  221. responses:
  222. '200':
  223. description: 请求成功
  224. /api/Admin/verifyImg:
  225. get:
  226. tags:
  227. - 管理员管理
  228. summary: 生成验证码
  229. operationId: 'app\api\controller\Admin::verifyImg'
  230. parameters:
  231. -
  232. name: uniqueKey
  233. in: query
  234. description: 唯一id
  235. schema:
  236. type: string
  237. default: '1121212'
  238. requestBody: { }
  239. responses:
  240. '200':
  241. description: 请求成功
  242. /api/Admin/menu:
  243. get:
  244. tags:
  245. - 管理员管理
  246. summary: 菜单权限
  247. operationId: 'app\api\controller\Admin::menu'
  248. parameters:
  249. -
  250. name: token
  251. in: header
  252. description: token
  253. schema:
  254. type: string
  255. requestBody: { }
  256. responses:
  257. '200':
  258. description: 请求成功
  259. /api/Brand/index:
  260. get:
  261. tags:
  262. - 品牌管理
  263. summary: 品牌列表
  264. operationId: 'app\api\controller\Brand::index'
  265. parameters:
  266. -
  267. name: token
  268. in: header
  269. description: token
  270. schema:
  271. type: string
  272. -
  273. name: page
  274. in: query
  275. description: 页码
  276. schema:
  277. type: ineger
  278. default: '1'
  279. -
  280. name: pageSize
  281. in: query
  282. description: 页尺寸
  283. schema:
  284. type: integer
  285. default: '10'
  286. -
  287. name: status
  288. in: query
  289. description: '状态 1正常 2删除'
  290. schema:
  291. type: integer
  292. default: '1'
  293. -
  294. name: name
  295. in: query
  296. description: 品牌名
  297. schema:
  298. type: string
  299. -
  300. name: groupId
  301. in: query
  302. description: 集团id
  303. schema:
  304. type: integer
  305. requestBody: { }
  306. responses:
  307. '200':
  308. description: 请求成功
  309. /api/Brand/save:
  310. post:
  311. tags:
  312. - 品牌管理
  313. summary: 保存品牌信息
  314. operationId: 'app\api\controller\Brand::save'
  315. parameters:
  316. -
  317. name: token
  318. in: header
  319. description: token
  320. schema:
  321. type: string
  322. requestBody:
  323. content:
  324. multipart/form-data:
  325. schema:
  326. required:
  327. - name
  328. - groupId
  329. properties:
  330. name:
  331. description: 品牌名称
  332. type: string
  333. default: 大大品牌
  334. groupId:
  335. description: 集团id
  336. type: string
  337. default: '1'
  338. type: object
  339. responses:
  340. '200':
  341. description: 请求成功
  342. /api/Brand/delete:
  343. get:
  344. tags:
  345. - 品牌管理
  346. summary: 删除品牌信息
  347. operationId: 'app\api\controller\Brand::delete'
  348. parameters:
  349. -
  350. name: token
  351. in: header
  352. description: token
  353. schema:
  354. type: string
  355. -
  356. name: id
  357. in: query
  358. description: 品牌id
  359. schema:
  360. type: ineger
  361. default: '1'
  362. -
  363. name: status
  364. in: query
  365. description: '1正常 2删除'
  366. schema:
  367. type: ineger
  368. default: '1'
  369. requestBody: { }
  370. responses:
  371. '200':
  372. description: 请求成功
  373. /api/Common/upload:
  374. post:
  375. tags:
  376. - 通用
  377. summary: 上传图片
  378. operationId: 'app\api\controller\Common::upload'
  379. parameters:
  380. -
  381. name: token
  382. in: header
  383. description: token
  384. schema:
  385. type: string
  386. requestBody:
  387. content:
  388. multipart/form-data:
  389. schema:
  390. required:
  391. - image
  392. properties:
  393. image:
  394. description: '图片(最大5m,支持的后缀jpg,png,gif,jpeg)'
  395. type: file
  396. type: object
  397. responses:
  398. '200':
  399. description: 请求成功
  400. /api/Company/index:
  401. get:
  402. tags:
  403. - 公司管理
  404. summary: 公司列表
  405. operationId: 'app\api\controller\Company::index'
  406. parameters:
  407. -
  408. name: token
  409. in: header
  410. description: token
  411. schema:
  412. type: string
  413. -
  414. name: page
  415. in: query
  416. description: 页码
  417. schema:
  418. type: ineger
  419. default: '1'
  420. -
  421. name: pageSize
  422. in: query
  423. description: 页尺寸
  424. schema:
  425. type: integer
  426. default: '10'
  427. -
  428. name: status
  429. in: query
  430. description: '状态 1正常 2删除'
  431. schema:
  432. type: integer
  433. default: '1'
  434. -
  435. name: name
  436. in: query
  437. description: 公司名
  438. schema:
  439. type: string
  440. -
  441. name: groupId
  442. in: query
  443. description: 集团id
  444. schema:
  445. type: integer
  446. requestBody: { }
  447. responses:
  448. '200':
  449. description: 请求成功
  450. /api/Company/save:
  451. post:
  452. tags:
  453. - 公司管理
  454. summary: 保存公司信息
  455. operationId: 'app\api\controller\Company::save'
  456. parameters:
  457. -
  458. name: token
  459. in: header
  460. description: token
  461. schema:
  462. type: string
  463. requestBody:
  464. content:
  465. multipart/form-data:
  466. schema:
  467. required:
  468. - name
  469. - groupId
  470. - code
  471. - payId
  472. properties:
  473. name:
  474. description: 公司名称
  475. type: string
  476. default: jj公司
  477. groupId:
  478. description: 集团id
  479. type: integer
  480. default: '1'
  481. code:
  482. description: 公司code
  483. type: string
  484. default: a01
  485. payId:
  486. description: 支付id
  487. type: integer
  488. default: '1'
  489. status:
  490. description: '状态 1正常 2删除'
  491. type: integer
  492. default: '1'
  493. type: object
  494. responses:
  495. '200':
  496. description: 请求成功
  497. /api/Company/read:
  498. get:
  499. tags:
  500. - 公司管理
  501. summary: 查看公司信息
  502. operationId: 'app\api\controller\Company::read'
  503. parameters:
  504. -
  505. name: token
  506. in: header
  507. description: token
  508. schema:
  509. type: string
  510. -
  511. name: id
  512. in: query
  513. description: 公司id
  514. schema:
  515. type: ineger
  516. default: '1'
  517. requestBody: { }
  518. responses:
  519. '200':
  520. description: 请求成功
  521. /api/Company/delete:
  522. get:
  523. tags:
  524. - 公司管理
  525. summary: 删除公司信息
  526. operationId: 'app\api\controller\Company::delete'
  527. parameters:
  528. -
  529. name: token
  530. in: header
  531. description: token
  532. schema:
  533. type: string
  534. -
  535. name: id
  536. in: query
  537. description: 公司id
  538. schema:
  539. type: ineger
  540. default: '1'
  541. -
  542. name: status
  543. in: query
  544. description: '1正常 2删除'
  545. schema:
  546. type: ineger
  547. default: '1'
  548. requestBody: { }
  549. responses:
  550. '200':
  551. description: 请求成功
  552. /api/Discuss/index:
  553. get:
  554. tags:
  555. - 评论管理
  556. summary: 评论列表
  557. operationId: 'app\api\controller\Discuss::index'
  558. parameters:
  559. -
  560. name: token
  561. in: header
  562. description: token
  563. schema:
  564. type: string
  565. -
  566. name: page
  567. in: query
  568. description: 页码
  569. schema:
  570. type: ineger
  571. default: '1'
  572. -
  573. name: pageSize
  574. in: query
  575. description: 页尺寸
  576. schema:
  577. type: integer
  578. default: '10'
  579. -
  580. name: storeId
  581. in: query
  582. description: 门店id
  583. schema:
  584. type: integer
  585. default: '1'
  586. -
  587. name: productId
  588. in: query
  589. description: 产品id
  590. schema:
  591. type: integer
  592. default: '1'
  593. -
  594. name: myDiscuss
  595. in: query
  596. description: '用户的评论 1获取我的评论'
  597. schema:
  598. type: integer
  599. default: '1'
  600. requestBody: { }
  601. responses:
  602. '200':
  603. description: 请求成功
  604. /api/Discuss/save:
  605. post:
  606. tags:
  607. - 评论管理
  608. summary: 保存评论信息
  609. operationId: 'app\api\controller\Discuss::save'
  610. parameters:
  611. -
  612. name: token
  613. in: header
  614. description: token
  615. schema:
  616. type: string
  617. requestBody:
  618. content:
  619. multipart/form-data:
  620. schema:
  621. required:
  622. - productId
  623. - orderId
  624. - storeId
  625. - productScore
  626. - storeScore
  627. - content
  628. properties:
  629. productId:
  630. description: 产品id
  631. type: integer
  632. default: '1'
  633. orderId:
  634. description: 订单id
  635. type: integer
  636. default: '1'
  637. storeId:
  638. description: 门店id
  639. type: integer
  640. default: '1'
  641. productScore:
  642. description: 产品得分
  643. type: integer
  644. default: '5'
  645. storeScore:
  646. description: 门店得分
  647. type: integer
  648. default: '5'
  649. content:
  650. description: 评论详情
  651. type: string
  652. default: 妹子真好看
  653. imgUrls:
  654. description: 评论图片(多个用逗号分隔)
  655. type: integer
  656. default: 'https://ss1.bdstatic.com/70cFvXSh_Q1YnxGkpoWK1HF6hhy/it/u=3363295869,2467511306&fm=26&gp=0.jpg,https://ss1.bdstatic.com/70cFvXSh_Q1YnxGkpoWK1HF6hhy/it/u=3363295869,2467511306&fm=26&gp=0.jpg'
  657. type: object
  658. responses:
  659. '200':
  660. description: 请求成功
  661. /api/Group/index:
  662. get:
  663. tags:
  664. - 集团管理
  665. summary: 集团列表
  666. operationId: 'app\api\controller\Group::index'
  667. parameters:
  668. -
  669. name: token
  670. in: header
  671. description: token
  672. schema:
  673. type: string
  674. -
  675. name: page
  676. in: query
  677. description: 页码
  678. schema:
  679. type: ineger
  680. default: '1'
  681. -
  682. name: pageSize
  683. in: query
  684. description: 页尺寸
  685. schema:
  686. type: integer
  687. default: '10'
  688. requestBody: { }
  689. responses:
  690. '200':
  691. description: 请求成功
  692. /api/Group/save:
  693. post:
  694. tags:
  695. - 集团管理
  696. summary: 保存集团信息
  697. operationId: 'app\api\controller\Group::save'
  698. parameters:
  699. -
  700. name: token
  701. in: header
  702. description: token
  703. schema:
  704. type: string
  705. requestBody:
  706. content:
  707. multipart/form-data:
  708. schema:
  709. required:
  710. - name
  711. properties:
  712. name:
  713. description: 集团名称
  714. type: string
  715. default: 四海集团
  716. type: object
  717. responses:
  718. '200':
  719. description: 请求成功
  720. /api/Order/index:
  721. get:
  722. tags:
  723. - 订单管理
  724. summary: 订单列表
  725. operationId: 'app\api\controller\Order::index'
  726. parameters:
  727. -
  728. name: token
  729. in: header
  730. description: token
  731. schema:
  732. type: string
  733. -
  734. name: page
  735. in: query
  736. description: 页码
  737. schema:
  738. type: ineger
  739. default: '1'
  740. -
  741. name: pageSize
  742. in: query
  743. description: 页尺寸
  744. schema:
  745. type: integer
  746. default: '10'
  747. -
  748. name: orderStatus
  749. in: query
  750. description: '订单状态 1未支付 2已支付 '
  751. schema:
  752. type: integer
  753. -
  754. name: writeOffStatus
  755. in: query
  756. description: '核销状态 1未核销 2已核销 '
  757. schema:
  758. type: integer
  759. -
  760. name: discussStatus
  761. in: query
  762. description: '评价状态 1未评价 2已评价 '
  763. schema:
  764. type: integer
  765. -
  766. name: orderSn
  767. in: query
  768. description: 订单号
  769. schema:
  770. type: string
  771. -
  772. name: mobile
  773. in: query
  774. description: 手机号
  775. schema:
  776. type: string
  777. -
  778. name: storeId
  779. in: query
  780. description: 门店id
  781. schema:
  782. type: integer
  783. -
  784. name: appointmentTime
  785. in: query
  786. description: 预约时间
  787. schema:
  788. type: '2020-01-02,2021-12-30'
  789. -
  790. name: createTime
  791. in: query
  792. description: 订单时间
  793. schema:
  794. type: '2020-01-02,2021-12-30'
  795. -
  796. name: orderType
  797. in: query
  798. description: '订单类型 1小程序下单 2后台增加'
  799. schema:
  800. type: string
  801. requestBody: { }
  802. responses:
  803. '200':
  804. description: 请求成功
  805. /api/Order/read:
  806. get:
  807. tags:
  808. - 订单管理
  809. summary: 查看订单信息
  810. operationId: 'app\api\controller\Order::read'
  811. parameters:
  812. -
  813. name: token
  814. in: header
  815. description: token
  816. schema:
  817. type: string
  818. -
  819. name: id
  820. in: query
  821. description: 订单id
  822. schema:
  823. type: ineger
  824. default: '1'
  825. requestBody: { }
  826. responses:
  827. '200':
  828. description: 请求成功
  829. /api/Order/delete:
  830. get:
  831. tags:
  832. - 订单管理
  833. summary: 删除品牌信息
  834. operationId: 'app\api\controller\Order::delete'
  835. parameters:
  836. -
  837. name: token
  838. in: header
  839. description: token
  840. schema:
  841. type: string
  842. -
  843. name: id
  844. in: query
  845. description: 品牌id
  846. schema:
  847. type: ineger
  848. default: '1'
  849. -
  850. name: status
  851. in: query
  852. description: '1正常 2删除'
  853. schema:
  854. type: ineger
  855. default: '1'
  856. requestBody: { }
  857. responses:
  858. '200':
  859. description: 请求成功
  860. /api/Order/createOrder:
  861. post:
  862. tags:
  863. - 订单管理
  864. summary: 创建订单信息
  865. operationId: 'app\api\controller\Order::createOrder'
  866. parameters:
  867. -
  868. name: token
  869. in: header
  870. description: token
  871. schema:
  872. type: string
  873. requestBody:
  874. content:
  875. multipart/form-data:
  876. schema:
  877. required:
  878. - productId
  879. - storeId
  880. - appointmentTime
  881. - num
  882. - mobile
  883. properties:
  884. productId:
  885. description: 商品id
  886. type: integer
  887. default: '1'
  888. storeId:
  889. description: 门店id
  890. type: integer
  891. default: '1'
  892. appointmentTime:
  893. description: 预约时间
  894. type: string
  895. default: '2020-12-12 16:30'
  896. endTime:
  897. description: 预约结束时间
  898. type: string
  899. default: '2020-12-12 16:30'
  900. num:
  901. description: 商品数量
  902. type: integer
  903. default: '1'
  904. mobile:
  905. description: 手机号
  906. type: string
  907. default: '15623655623'
  908. type: object
  909. responses:
  910. '200':
  911. description: 请求成功
  912. /api/Order/assignStaff:
  913. post:
  914. tags:
  915. - 订单管理
  916. summary: 分配职员
  917. operationId: 'app\api\controller\Order::assignStaff'
  918. parameters:
  919. -
  920. name: token
  921. in: header
  922. description: token
  923. schema:
  924. type: string
  925. requestBody:
  926. content:
  927. multipart/form-data:
  928. schema:
  929. required:
  930. - orderId
  931. - staffId
  932. properties:
  933. orderId:
  934. description: 订单id
  935. type: integer
  936. default: '1'
  937. staffId:
  938. description: 职员id
  939. type: integer
  940. default: '1'
  941. type: object
  942. responses:
  943. '200':
  944. description: 请求成功
  945. /api/Order/payOrder:
  946. post:
  947. tags:
  948. - 订单管理
  949. summary: 手动支付
  950. operationId: 'app\api\controller\Order::payOrder'
  951. parameters:
  952. -
  953. name: token
  954. in: header
  955. description: token
  956. schema:
  957. type: string
  958. requestBody:
  959. content:
  960. multipart/form-data:
  961. schema:
  962. required:
  963. - orderId
  964. properties:
  965. orderId:
  966. description: 订单id
  967. type: integer
  968. default: '1'
  969. type: object
  970. responses:
  971. '200':
  972. description: 请求成功
  973. /api/Order/writeOffOrder:
  974. get:
  975. tags:
  976. - 订单管理
  977. summary: 核销订单
  978. operationId: 'app\api\controller\Order::writeOffOrder'
  979. parameters:
  980. -
  981. name: token
  982. in: header
  983. description: token
  984. schema:
  985. type: string
  986. requestBody:
  987. content:
  988. multipart/form-data:
  989. schema:
  990. required:
  991. - orderId
  992. - code
  993. properties:
  994. orderId:
  995. description: 订单id
  996. type: integer
  997. default: '1'
  998. code:
  999. description: 核销code
  1000. type: string
  1001. default: '1'
  1002. type: object
  1003. responses:
  1004. '200':
  1005. description: 请求成功
  1006. /api/Order/closeOrder:
  1007. post:
  1008. tags:
  1009. - 订单管理
  1010. summary: 订单关闭
  1011. operationId: 'app\api\controller\Order::closeOrder'
  1012. parameters:
  1013. -
  1014. name: token
  1015. in: header
  1016. description: token
  1017. schema:
  1018. type: string
  1019. -
  1020. name: orderId
  1021. in: query
  1022. description: 订单id
  1023. schema:
  1024. type: ineger
  1025. default: '1'
  1026. requestBody: { }
  1027. responses:
  1028. '200':
  1029. description: 请求成功
  1030. /api/Order/deleteOrder:
  1031. post:
  1032. tags:
  1033. - 订单管理
  1034. summary: 订单删除
  1035. operationId: 'app\api\controller\Order::deleteOrder'
  1036. parameters:
  1037. -
  1038. name: token
  1039. in: header
  1040. description: token
  1041. schema:
  1042. type: string
  1043. -
  1044. name: orderId
  1045. in: query
  1046. description: 订单id
  1047. schema:
  1048. type: ineger
  1049. default: '1'
  1050. requestBody: { }
  1051. responses:
  1052. '200':
  1053. description: 请求成功
  1054. /api/Pay/index:
  1055. get:
  1056. tags:
  1057. - 支付管理
  1058. summary: 支付配置列表
  1059. operationId: 'app\api\controller\Pay::index'
  1060. parameters:
  1061. -
  1062. name: token
  1063. in: header
  1064. description: token
  1065. schema:
  1066. type: string
  1067. -
  1068. name: page
  1069. in: query
  1070. description: 页码
  1071. schema:
  1072. type: ineger
  1073. default: '1'
  1074. -
  1075. name: pageSize
  1076. in: query
  1077. description: 页尺寸
  1078. schema:
  1079. type: integer
  1080. default: '10'
  1081. -
  1082. name: status
  1083. in: query
  1084. description: '状态 1正常 2删除'
  1085. schema:
  1086. type: integer
  1087. default: '1'
  1088. -
  1089. name: code
  1090. in: query
  1091. description: 支付code
  1092. schema:
  1093. type: string
  1094. -
  1095. name: groupId
  1096. in: query
  1097. description: 公司id
  1098. schema:
  1099. type: integer
  1100. requestBody: { }
  1101. responses:
  1102. '200':
  1103. description: 请求成功
  1104. /api/Pay/save:
  1105. post:
  1106. tags:
  1107. - 支付管理
  1108. summary: 保存支付配置信息
  1109. operationId: 'app\api\controller\Pay::save'
  1110. parameters:
  1111. -
  1112. name: token
  1113. in: header
  1114. description: token
  1115. schema:
  1116. type: string
  1117. requestBody:
  1118. content:
  1119. multipart/form-data:
  1120. schema:
  1121. required:
  1122. - code
  1123. - groupId
  1124. - masterPayId
  1125. - masterAppId
  1126. - xcxSecret
  1127. properties:
  1128. code:
  1129. description: 支付code
  1130. type: string
  1131. default: jj公司
  1132. groupId:
  1133. description: 集团id
  1134. type: integer
  1135. default: '1'
  1136. masterPayId:
  1137. description: 主商户号
  1138. type: string
  1139. default: a01
  1140. subPayId:
  1141. description: 子商户号
  1142. type: string
  1143. default: '1'
  1144. masterAppId:
  1145. description: 主appId
  1146. type: string
  1147. default: '1'
  1148. subAppId:
  1149. description: 子appId
  1150. type: string
  1151. default: '1'
  1152. xcxSecret:
  1153. description: 秘钥
  1154. type: string
  1155. default: '1'
  1156. status:
  1157. description: '状态 1正常 2删除'
  1158. type: integer
  1159. default: '1'
  1160. remark:
  1161. description: 备注
  1162. type: dtring
  1163. default: xx支付
  1164. type: object
  1165. responses:
  1166. '200':
  1167. description: 请求成功
  1168. /api/Pay/read:
  1169. get:
  1170. tags:
  1171. - 支付管理
  1172. summary: 查看支付信息
  1173. operationId: 'app\api\controller\Pay::read'
  1174. parameters:
  1175. -
  1176. name: token
  1177. in: header
  1178. description: token
  1179. schema:
  1180. type: string
  1181. -
  1182. name: id
  1183. in: query
  1184. description: 支付id
  1185. schema:
  1186. type: ineger
  1187. default: '1'
  1188. requestBody: { }
  1189. responses:
  1190. '200':
  1191. description: 请求成功
  1192. /api/Pay/delete:
  1193. get:
  1194. tags:
  1195. - 支付管理
  1196. summary: 删除支付配置信息
  1197. operationId: 'app\api\controller\Pay::delete'
  1198. parameters:
  1199. -
  1200. name: token
  1201. in: header
  1202. description: token
  1203. schema:
  1204. type: string
  1205. -
  1206. name: id
  1207. in: query
  1208. description: 支付id
  1209. schema:
  1210. type: ineger
  1211. default: '1'
  1212. -
  1213. name: status
  1214. in: query
  1215. description: '1正常 2删除'
  1216. schema:
  1217. type: ineger
  1218. default: '1'
  1219. requestBody: { }
  1220. responses:
  1221. '200':
  1222. description: 请求成功
  1223. /api/Product/index:
  1224. get:
  1225. tags:
  1226. - 产品管理
  1227. summary: 产品列表
  1228. operationId: 'app\api\controller\Product::index'
  1229. parameters:
  1230. -
  1231. name: token
  1232. in: header
  1233. description: token
  1234. schema:
  1235. type: string
  1236. -
  1237. name: page
  1238. in: query
  1239. description: 页码
  1240. schema:
  1241. type: ineger
  1242. default: '1'
  1243. -
  1244. name: pageSize
  1245. in: query
  1246. description: 页尺寸
  1247. schema:
  1248. type: integer
  1249. default: '10'
  1250. -
  1251. name: status
  1252. in: query
  1253. description: '状态 1正常 2删除'
  1254. schema:
  1255. type: integer
  1256. default: '1'
  1257. -
  1258. name: name
  1259. in: query
  1260. description: 产品名称
  1261. schema:
  1262. type: string
  1263. -
  1264. name: brandId
  1265. in: query
  1266. description: 品牌id
  1267. schema:
  1268. type: integer
  1269. -
  1270. name: companyId
  1271. in: query
  1272. description: 公司id
  1273. schema:
  1274. type: integer
  1275. requestBody: { }
  1276. responses:
  1277. '200':
  1278. description: 请求成功
  1279. /api/Product/typeList:
  1280. get:
  1281. tags:
  1282. - 产品管理
  1283. summary: 产品类型列表(暂时不用)
  1284. operationId: 'app\api\controller\Product::typeList'
  1285. parameters:
  1286. -
  1287. name: token
  1288. in: header
  1289. description: token
  1290. schema:
  1291. type: string
  1292. -
  1293. name: page
  1294. in: query
  1295. description: 页码
  1296. schema:
  1297. type: ineger
  1298. default: '1'
  1299. -
  1300. name: pageSize
  1301. in: query
  1302. description: 页尺寸
  1303. schema:
  1304. type: integer
  1305. default: '10'
  1306. requestBody: { }
  1307. responses:
  1308. '200':
  1309. description: 请求成功
  1310. /api/Product/save:
  1311. post:
  1312. tags:
  1313. - 产品管理
  1314. summary: 保存产品信息
  1315. operationId: 'app\api\controller\Product::save'
  1316. parameters:
  1317. -
  1318. name: token
  1319. in: header
  1320. description: token
  1321. schema:
  1322. type: string
  1323. requestBody:
  1324. content:
  1325. multipart/form-data:
  1326. schema:
  1327. required:
  1328. - name
  1329. - imgUrl
  1330. - oldPrice
  1331. - currentPrice
  1332. - companyId
  1333. - brandId
  1334. - productContent
  1335. properties:
  1336. name:
  1337. description: 产品名称
  1338. type: string
  1339. default: 精油推背
  1340. imgUrl:
  1341. description: 产品图片
  1342. type: integer
  1343. default: 'http://xxx.com'
  1344. oldPrice:
  1345. description: 原价
  1346. type: string
  1347. default: '88.00'
  1348. currentPrice:
  1349. description: 现价
  1350. type: string
  1351. default: '66.00'
  1352. productContent:
  1353. description: 产品介绍(富文本编辑)
  1354. type: string
  1355. default: 本产品由xxx精油。。
  1356. companyId:
  1357. description: 公司id
  1358. type: string
  1359. default: '1'
  1360. brandId:
  1361. description: 品牌id
  1362. type: string
  1363. default: '1'
  1364. status:
  1365. description: '状态 1正常 2下架'
  1366. type: integer
  1367. default: '1'
  1368. type: object
  1369. responses:
  1370. '200':
  1371. description: 请求成功
  1372. /api/Product/read:
  1373. get:
  1374. tags:
  1375. - 产品管理
  1376. summary: 查看产品信息
  1377. operationId: 'app\api\controller\Product::read'
  1378. parameters:
  1379. -
  1380. name: token
  1381. in: header
  1382. description: token
  1383. schema:
  1384. type: string
  1385. -
  1386. name: id
  1387. in: query
  1388. description: 产品id
  1389. schema:
  1390. type: ineger
  1391. default: '1'
  1392. requestBody: { }
  1393. responses:
  1394. '200':
  1395. description: 请求成功
  1396. /api/Product/delete:
  1397. get:
  1398. tags:
  1399. - 产品管理
  1400. summary: 删除产品信息
  1401. operationId: 'app\api\controller\Product::delete'
  1402. parameters:
  1403. -
  1404. name: token
  1405. in: header
  1406. description: token
  1407. schema:
  1408. type: string
  1409. -
  1410. name: id
  1411. in: query
  1412. description: 产品id
  1413. schema:
  1414. type: ineger
  1415. default: '1'
  1416. -
  1417. name: status
  1418. in: query
  1419. description: '1正常 2下架 3删除'
  1420. schema:
  1421. type: ineger
  1422. default: '1'
  1423. requestBody: { }
  1424. responses:
  1425. '200':
  1426. description: 请求成功
  1427. /api/Staff/index:
  1428. get:
  1429. tags:
  1430. - 职员管理
  1431. summary: 职员列表
  1432. operationId: 'app\api\controller\Staff::index'
  1433. parameters:
  1434. -
  1435. name: token
  1436. in: header
  1437. description: token
  1438. schema:
  1439. type: string
  1440. -
  1441. name: page
  1442. in: query
  1443. description: 页码
  1444. schema:
  1445. type: ineger
  1446. default: '1'
  1447. -
  1448. name: pageSize
  1449. in: query
  1450. description: 页尺寸
  1451. schema:
  1452. type: integer
  1453. default: '10'
  1454. -
  1455. name: status
  1456. in: query
  1457. description: '状态 1正常 2删除'
  1458. schema:
  1459. type: integer
  1460. default: '1'
  1461. -
  1462. name: name
  1463. in: query
  1464. description: 职员名
  1465. schema:
  1466. type: string
  1467. -
  1468. name: mobile
  1469. in: query
  1470. description: 手机号
  1471. schema:
  1472. type: string
  1473. requestBody: { }
  1474. responses:
  1475. '200':
  1476. description: 请求成功
  1477. /api/Staff/save:
  1478. post:
  1479. tags:
  1480. - 职员管理
  1481. summary: 保存职员信息
  1482. operationId: 'app\api\controller\Staff::save'
  1483. parameters:
  1484. -
  1485. name: token
  1486. in: header
  1487. description: token
  1488. schema:
  1489. type: string
  1490. requestBody:
  1491. content:
  1492. multipart/form-data:
  1493. schema:
  1494. required:
  1495. - name
  1496. - code
  1497. - mobile
  1498. - joinTime
  1499. - staffTitleId
  1500. - storeId
  1501. properties:
  1502. name:
  1503. description: 职员名称
  1504. type: string
  1505. default: tony
  1506. code:
  1507. description: 职员工号
  1508. type: string
  1509. default: A9527
  1510. mobile:
  1511. description: 职员手机号
  1512. type: string
  1513. default: '12367897654'
  1514. joinTime:
  1515. description: 入职日期
  1516. type: string
  1517. default: '2020-01-04'
  1518. staffTitleId:
  1519. description: 职称id
  1520. type: integer
  1521. default: '1'
  1522. storeId:
  1523. description: storeId
  1524. type: integer
  1525. default: '1'
  1526. type: object
  1527. responses:
  1528. '200':
  1529. description: 请求成功
  1530. /api/Staff/read:
  1531. get:
  1532. tags:
  1533. - 职员管理
  1534. summary: 查看职员信息
  1535. operationId: 'app\api\controller\Staff::read'
  1536. parameters:
  1537. -
  1538. name: token
  1539. in: header
  1540. description: token
  1541. schema:
  1542. type: string
  1543. -
  1544. name: id
  1545. in: query
  1546. description: 职员id
  1547. schema:
  1548. type: ineger
  1549. default: '1'
  1550. requestBody: { }
  1551. responses:
  1552. '200':
  1553. description: 请求成功
  1554. /api/Staff/delete:
  1555. get:
  1556. tags:
  1557. - 职员管理
  1558. summary: 删除职员信息
  1559. operationId: 'app\api\controller\Staff::delete'
  1560. parameters:
  1561. -
  1562. name: token
  1563. in: header
  1564. description: token
  1565. schema:
  1566. type: string
  1567. -
  1568. name: id
  1569. in: query
  1570. description: 职员id
  1571. schema:
  1572. type: ineger
  1573. default: '1'
  1574. -
  1575. name: status
  1576. in: query
  1577. description: '1正常 2删除'
  1578. schema:
  1579. type: ineger
  1580. default: '1'
  1581. requestBody: { }
  1582. responses:
  1583. '200':
  1584. description: 请求成功
  1585. /api/Store/index:
  1586. get:
  1587. tags:
  1588. - 门店管理
  1589. summary: 门店列表
  1590. operationId: 'app\api\controller\Store::index'
  1591. parameters:
  1592. -
  1593. name: token
  1594. in: header
  1595. description: token
  1596. schema:
  1597. type: string
  1598. -
  1599. name: page
  1600. in: query
  1601. description: 页码
  1602. schema:
  1603. type: ineger
  1604. default: '1'
  1605. -
  1606. name: pageSize
  1607. in: query
  1608. description: 页尺寸
  1609. schema:
  1610. type: integer
  1611. default: '10'
  1612. -
  1613. name: status
  1614. in: query
  1615. description: '状态 1正常 2闭店 3歇业'
  1616. schema:
  1617. type: integer
  1618. default: '1'
  1619. -
  1620. name: name
  1621. in: query
  1622. description: 门店名称
  1623. schema:
  1624. type: string
  1625. -
  1626. name: lat
  1627. in: query
  1628. description: 经度
  1629. schema:
  1630. type: string
  1631. -
  1632. name: lon
  1633. in: query
  1634. description: 纬度
  1635. schema:
  1636. type: string
  1637. -
  1638. name: groupId
  1639. in: query
  1640. description: 集团id
  1641. schema:
  1642. type: string
  1643. -
  1644. name: type
  1645. in: query
  1646. description: '类型 1为当前管理人员的门店'
  1647. schema:
  1648. type: integer
  1649. requestBody: { }
  1650. responses:
  1651. '200':
  1652. description: 请求成功
  1653. /api/Store/save:
  1654. post:
  1655. tags:
  1656. - 门店管理
  1657. summary: 保存门店信息
  1658. operationId: 'app\api\controller\Store::save'
  1659. parameters:
  1660. -
  1661. name: token
  1662. in: header
  1663. description: token
  1664. schema:
  1665. type: string
  1666. requestBody:
  1667. content:
  1668. multipart/form-data:
  1669. schema:
  1670. required:
  1671. - name
  1672. - code
  1673. - openTime
  1674. - closeTime
  1675. - groupId
  1676. - companyId
  1677. - brandId
  1678. - logo
  1679. - latitude
  1680. - longitude
  1681. - address
  1682. - mobile
  1683. - storeContent
  1684. properties:
  1685. name:
  1686. description: 门店名称
  1687. type: string
  1688. default: 测试门店1
  1689. code:
  1690. description: 门店code
  1691. type: string
  1692. default: A001
  1693. openTime:
  1694. description: 营业时间
  1695. type: string
  1696. default: '06:00'
  1697. closeTime:
  1698. description: 闭店时间
  1699. type: string
  1700. default: '22:00'
  1701. payCode:
  1702. description: 支付标识
  1703. type: string
  1704. default: paycode1
  1705. groupId:
  1706. description: 所属集团id
  1707. type: integer
  1708. default: '1'
  1709. companyId:
  1710. description: 所属公司id
  1711. type: integer
  1712. default: '1'
  1713. brandId:
  1714. description: 所属品牌id
  1715. type: integer
  1716. default: '1'
  1717. logo:
  1718. description: logo的url
  1719. type: string
  1720. default: 'https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1608146390523&di=02b955a1fa80d1c43c6289f846ddc42c&imgtype=0&src=http%3A%2F%2Fimg.sccnn.com%2Fbimg%2F338%2F38706.jpg'
  1721. latitude:
  1722. description: 纬度
  1723. type: string
  1724. default: '31.241510099342623'
  1725. longitude:
  1726. description: 经度
  1727. type: string
  1728. default: '121.32174958203123'
  1729. address:
  1730. description: 地址
  1731. type: string
  1732. default: 上海市普陀区真北路
  1733. mobile:
  1734. description: 联系电话
  1735. type: string
  1736. default: '15656789876'
  1737. storeContent:
  1738. description: 门店介绍
  1739. type: string
  1740. default: 本店所有商品照片为专业摄影师拍摄,后期起精心修制及色彩调整,尽量与实际商品保持一致。
  1741. id:
  1742. description: 门店id
  1743. type: string
  1744. default: ''
  1745. status:
  1746. description: '门店状态 1正常 2闭店 3暂歇'
  1747. type: '0'
  1748. type: object
  1749. responses:
  1750. '200':
  1751. description: 请求成功
  1752. /api/Store/read:
  1753. get:
  1754. tags:
  1755. - 门店管理
  1756. summary: 查看门店信息
  1757. operationId: 'app\api\controller\Store::read'
  1758. parameters:
  1759. -
  1760. name: token
  1761. in: header
  1762. description: token
  1763. schema:
  1764. type: string
  1765. -
  1766. name: id
  1767. in: query
  1768. description: 门店id
  1769. schema:
  1770. type: ineger
  1771. default: '1'
  1772. requestBody: { }
  1773. responses:
  1774. '200':
  1775. description: 请求成功
  1776. /api/Store/delete:
  1777. get:
  1778. tags:
  1779. - 门店管理
  1780. summary: 删除门店信息
  1781. operationId: 'app\api\controller\Store::delete'
  1782. parameters:
  1783. -
  1784. name: token
  1785. in: header
  1786. description: token
  1787. schema:
  1788. type: string
  1789. -
  1790. name: id
  1791. in: query
  1792. description: 门店id
  1793. schema:
  1794. type: ineger
  1795. default: '1'
  1796. -
  1797. name: status
  1798. in: query
  1799. description: '1正常 2闭店 3暂歇'
  1800. schema:
  1801. type: ineger
  1802. default: '1'
  1803. requestBody: { }
  1804. responses:
  1805. '200':
  1806. description: 请求成功
  1807. /api/Store/getStore:
  1808. post:
  1809. tags:
  1810. - 门店管理
  1811. summary: 距离最近的一家门店
  1812. operationId: 'app\api\controller\Store::getStore'
  1813. parameters:
  1814. -
  1815. name: token
  1816. in: header
  1817. description: token
  1818. schema:
  1819. type: string
  1820. requestBody:
  1821. content:
  1822. multipart/form-data:
  1823. schema:
  1824. required:
  1825. - lat
  1826. - lon
  1827. properties:
  1828. lat:
  1829. description: 纬度
  1830. type: string
  1831. default: ''
  1832. lon:
  1833. description: 经度
  1834. type: string
  1835. default: ''
  1836. type: object
  1837. responses:
  1838. '200':
  1839. description: 请求成功
  1840. /api/Store/appointmentTime:
  1841. get:
  1842. tags:
  1843. - 门店管理
  1844. summary: 可预约时间
  1845. operationId: 'app\api\controller\Store::appointmentTime'
  1846. parameters:
  1847. -
  1848. name: token
  1849. in: header
  1850. description: token
  1851. schema:
  1852. type: string
  1853. -
  1854. name: storeId
  1855. in: query
  1856. description: 门店id
  1857. schema:
  1858. type: ineger
  1859. default: '1'
  1860. requestBody: { }
  1861. responses:
  1862. '200':
  1863. description: 请求成功
  1864. /api/User:
  1865. get:
  1866. tags:
  1867. - 用户管理
  1868. summary: 用户列表
  1869. operationId: 'app\api\controller\User::index'
  1870. parameters:
  1871. -
  1872. name: token
  1873. in: header
  1874. description: token
  1875. schema:
  1876. type: string
  1877. -
  1878. name: page
  1879. in: query
  1880. description: 页码
  1881. schema:
  1882. type: string
  1883. default: '1'
  1884. -
  1885. name: pageSize
  1886. in: query
  1887. description: 页尺寸
  1888. schema:
  1889. type: string
  1890. default: '10'
  1891. -
  1892. name: status
  1893. in: query
  1894. description: '状态 1正常 2删除'
  1895. schema:
  1896. type: string
  1897. -
  1898. name: mobile
  1899. in: query
  1900. description: 手机号
  1901. schema:
  1902. type: string
  1903. -
  1904. name: name
  1905. in: query
  1906. description: 昵称
  1907. schema:
  1908. type: string
  1909. -
  1910. name: cardLevel
  1911. in: query
  1912. description: '会员等级 1非会员,2金卡会员,3铂金会员'
  1913. schema:
  1914. type: string
  1915. -
  1916. name: joinType
  1917. in: query
  1918. description: '加入方式 1小程序 2后台预约'
  1919. schema:
  1920. type: string
  1921. requestBody: { }
  1922. responses:
  1923. '200':
  1924. description: 请求成功
  1925. /api/user/save:
  1926. post:
  1927. tags:
  1928. - 用户管理
  1929. summary: 保存用户(有id就更新,没id就新增)
  1930. operationId: 'app\api\controller\User::save'
  1931. parameters:
  1932. -
  1933. name: token
  1934. in: header
  1935. description: token
  1936. schema:
  1937. type: string
  1938. requestBody:
  1939. content:
  1940. application/json:
  1941. schema:
  1942. required:
  1943. - title
  1944. - content
  1945. properties:
  1946. code:
  1947. description: 微信小程序
  1948. type: string
  1949. default: dd
  1950. type: object
  1951. responses:
  1952. '200':
  1953. description: 请求成功
  1954. /api/User/editUser:
  1955. post:
  1956. tags:
  1957. - 用户管理
  1958. summary: 修改用户信息
  1959. operationId: 'app\api\controller\User::editUser'
  1960. parameters:
  1961. -
  1962. name: token
  1963. in: header
  1964. description: token
  1965. schema:
  1966. type: string
  1967. requestBody:
  1968. content:
  1969. multipart/form-data:
  1970. schema:
  1971. required:
  1972. - name
  1973. - birthday
  1974. - avatar
  1975. properties:
  1976. name:
  1977. description: 用户姓名
  1978. type: string
  1979. default: 小明
  1980. birthday:
  1981. description: 生日
  1982. type: string
  1983. default: '1889-02-03'
  1984. avatar:
  1985. description: 头像
  1986. type: string
  1987. default: 'http://xxx.com'
  1988. sex:
  1989. description: '性别 0未知 1男 2女'
  1990. type: string
  1991. default: 'http://xxx.com'
  1992. type: object
  1993. responses:
  1994. '200':
  1995. description: 请求成功
  1996. /api/User/read:
  1997. get:
  1998. tags:
  1999. - 用户管理
  2000. summary: 读取单个用户信息
  2001. operationId: 'app\api\controller\User::read'
  2002. parameters:
  2003. -
  2004. name: token
  2005. in: header
  2006. description: token
  2007. schema:
  2008. type: string
  2009. requestBody:
  2010. content:
  2011. multipart/form-data:
  2012. schema:
  2013. required:
  2014. - id
  2015. properties:
  2016. id:
  2017. description: 用户id
  2018. type: int
  2019. type: object
  2020. responses:
  2021. '200':
  2022. description: 请求成功