api.yaml 50 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069
  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. properties:
  1124. code:
  1125. description: 支付code
  1126. type: string
  1127. default: jj公司
  1128. status:
  1129. description: '状态 1正常 2删除'
  1130. type: integer
  1131. default: '1'
  1132. remark:
  1133. description: 备注
  1134. type: dtring
  1135. default: xx支付
  1136. type: object
  1137. responses:
  1138. '200':
  1139. description: 请求成功
  1140. /api/Pay/read:
  1141. get:
  1142. tags:
  1143. - 支付管理
  1144. summary: 查看支付信息
  1145. operationId: 'app\api\controller\Pay::read'
  1146. parameters:
  1147. -
  1148. name: token
  1149. in: header
  1150. description: token
  1151. schema:
  1152. type: string
  1153. -
  1154. name: id
  1155. in: query
  1156. description: 支付id
  1157. schema:
  1158. type: ineger
  1159. default: '1'
  1160. requestBody: { }
  1161. responses:
  1162. '200':
  1163. description: 请求成功
  1164. /api/Pay/delete:
  1165. get:
  1166. tags:
  1167. - 支付管理
  1168. summary: 删除支付配置信息
  1169. operationId: 'app\api\controller\Pay::delete'
  1170. parameters:
  1171. -
  1172. name: token
  1173. in: header
  1174. description: token
  1175. schema:
  1176. type: string
  1177. -
  1178. name: id
  1179. in: query
  1180. description: 支付id
  1181. schema:
  1182. type: ineger
  1183. default: '1'
  1184. -
  1185. name: status
  1186. in: query
  1187. description: '1正常 2删除'
  1188. schema:
  1189. type: ineger
  1190. default: '1'
  1191. requestBody: { }
  1192. responses:
  1193. '200':
  1194. description: 请求成功
  1195. /api/Product/index:
  1196. get:
  1197. tags:
  1198. - 产品管理
  1199. summary: 产品列表
  1200. operationId: 'app\api\controller\Product::index'
  1201. parameters:
  1202. -
  1203. name: token
  1204. in: header
  1205. description: token
  1206. schema:
  1207. type: string
  1208. -
  1209. name: page
  1210. in: query
  1211. description: 页码
  1212. schema:
  1213. type: ineger
  1214. default: '1'
  1215. -
  1216. name: pageSize
  1217. in: query
  1218. description: 页尺寸
  1219. schema:
  1220. type: integer
  1221. default: '10'
  1222. -
  1223. name: status
  1224. in: query
  1225. description: '状态 1正常 2删除'
  1226. schema:
  1227. type: integer
  1228. default: '1'
  1229. -
  1230. name: name
  1231. in: query
  1232. description: 产品名称
  1233. schema:
  1234. type: string
  1235. -
  1236. name: brandId
  1237. in: query
  1238. description: 品牌id
  1239. schema:
  1240. type: integer
  1241. -
  1242. name: companyId
  1243. in: query
  1244. description: 公司id
  1245. schema:
  1246. type: integer
  1247. -
  1248. name: productTypeId
  1249. in: query
  1250. description: 产品类型id
  1251. schema:
  1252. type: integer
  1253. requestBody: { }
  1254. responses:
  1255. '200':
  1256. description: 请求成功
  1257. /api/Product/typeList:
  1258. get:
  1259. tags:
  1260. - 产品管理
  1261. summary: 产品类型列表
  1262. operationId: 'app\api\controller\Product::typeList'
  1263. parameters:
  1264. -
  1265. name: token
  1266. in: header
  1267. description: token
  1268. schema:
  1269. type: string
  1270. -
  1271. name: page
  1272. in: query
  1273. description: 页码
  1274. schema:
  1275. type: ineger
  1276. default: '1'
  1277. -
  1278. name: pageSize
  1279. in: query
  1280. description: 页尺寸
  1281. schema:
  1282. type: integer
  1283. default: '10'
  1284. requestBody: { }
  1285. responses:
  1286. '200':
  1287. description: 请求成功
  1288. /api/Product/saveType:
  1289. post:
  1290. tags:
  1291. - 产品管理
  1292. summary: 保存产品类型信息
  1293. operationId: 'app\api\controller\Product::saveType'
  1294. parameters:
  1295. -
  1296. name: token
  1297. in: header
  1298. description: token
  1299. schema:
  1300. type: string
  1301. requestBody:
  1302. content:
  1303. multipart/form-data:
  1304. schema:
  1305. required:
  1306. - name
  1307. - imgUrl
  1308. properties:
  1309. name:
  1310. description: 产品类型名称
  1311. type: string
  1312. default: 精油推背
  1313. imgUrl:
  1314. description: 产品类型图片
  1315. type: integer
  1316. default: 'http://xxx.com'
  1317. type: object
  1318. responses:
  1319. '200':
  1320. description: 请求成功
  1321. /api/Product/deleteType:
  1322. get:
  1323. tags:
  1324. - 产品管理
  1325. summary: 删除(屏蔽)产品类型信息
  1326. operationId: 'app\api\controller\Product::deleteType'
  1327. parameters:
  1328. -
  1329. name: token
  1330. in: header
  1331. description: token
  1332. schema:
  1333. type: string
  1334. -
  1335. name: id
  1336. in: query
  1337. description: 产品id
  1338. schema:
  1339. type: ineger
  1340. default: '1'
  1341. -
  1342. name: status
  1343. in: query
  1344. description: '1正常 0禁用'
  1345. schema:
  1346. type: ineger
  1347. default: '1'
  1348. requestBody: { }
  1349. responses:
  1350. '200':
  1351. description: 请求成功
  1352. /api/Product/save:
  1353. post:
  1354. tags:
  1355. - 产品管理
  1356. summary: 保存产品信息
  1357. operationId: 'app\api\controller\Product::save'
  1358. parameters:
  1359. -
  1360. name: token
  1361. in: header
  1362. description: token
  1363. schema:
  1364. type: string
  1365. requestBody:
  1366. content:
  1367. multipart/form-data:
  1368. schema:
  1369. required:
  1370. - name
  1371. - imgUrl
  1372. - oldPrice
  1373. - currentPrice
  1374. - companyId
  1375. - brandId
  1376. - productContent
  1377. properties:
  1378. name:
  1379. description: 产品名称
  1380. type: string
  1381. default: 精油推背
  1382. imgUrl:
  1383. description: 产品图片
  1384. type: integer
  1385. default: 'http://xxx.com'
  1386. oldPrice:
  1387. description: 原价
  1388. type: string
  1389. default: '88.00'
  1390. currentPrice:
  1391. description: 现价
  1392. type: string
  1393. default: '66.00'
  1394. productContent:
  1395. description: 产品介绍(富文本编辑)
  1396. type: string
  1397. default: 本产品由xxx精油。。
  1398. companyId:
  1399. description: 公司id
  1400. type: string
  1401. default: '1'
  1402. brandId:
  1403. description: 品牌id
  1404. type: string
  1405. default: '1'
  1406. status:
  1407. description: '状态 1正常 2下架'
  1408. type: integer
  1409. default: '1'
  1410. productTypeId:
  1411. description: 产品类型id
  1412. type: integer
  1413. default: '1'
  1414. type: object
  1415. responses:
  1416. '200':
  1417. description: 请求成功
  1418. /api/Product/read:
  1419. get:
  1420. tags:
  1421. - 产品管理
  1422. summary: 查看产品信息
  1423. operationId: 'app\api\controller\Product::read'
  1424. parameters:
  1425. -
  1426. name: token
  1427. in: header
  1428. description: token
  1429. schema:
  1430. type: string
  1431. -
  1432. name: id
  1433. in: query
  1434. description: 产品id
  1435. schema:
  1436. type: ineger
  1437. default: '1'
  1438. requestBody: { }
  1439. responses:
  1440. '200':
  1441. description: 请求成功
  1442. /api/Product/delete:
  1443. get:
  1444. tags:
  1445. - 产品管理
  1446. summary: 删除产品信息
  1447. operationId: 'app\api\controller\Product::delete'
  1448. parameters:
  1449. -
  1450. name: token
  1451. in: header
  1452. description: token
  1453. schema:
  1454. type: string
  1455. -
  1456. name: id
  1457. in: query
  1458. description: 产品id
  1459. schema:
  1460. type: ineger
  1461. default: '1'
  1462. -
  1463. name: status
  1464. in: query
  1465. description: '1正常 2下架 3删除'
  1466. schema:
  1467. type: ineger
  1468. default: '1'
  1469. requestBody: { }
  1470. responses:
  1471. '200':
  1472. description: 请求成功
  1473. /api/Staff/index:
  1474. get:
  1475. tags:
  1476. - 职员管理
  1477. summary: 职员列表
  1478. operationId: 'app\api\controller\Staff::index'
  1479. parameters:
  1480. -
  1481. name: token
  1482. in: header
  1483. description: token
  1484. schema:
  1485. type: string
  1486. -
  1487. name: page
  1488. in: query
  1489. description: 页码
  1490. schema:
  1491. type: ineger
  1492. default: '1'
  1493. -
  1494. name: pageSize
  1495. in: query
  1496. description: 页尺寸
  1497. schema:
  1498. type: integer
  1499. default: '10'
  1500. -
  1501. name: status
  1502. in: query
  1503. description: '状态 1正常 2删除'
  1504. schema:
  1505. type: integer
  1506. default: '1'
  1507. -
  1508. name: name
  1509. in: query
  1510. description: 职员名
  1511. schema:
  1512. type: string
  1513. -
  1514. name: mobile
  1515. in: query
  1516. description: 手机号
  1517. schema:
  1518. type: string
  1519. requestBody: { }
  1520. responses:
  1521. '200':
  1522. description: 请求成功
  1523. /api/Staff/save:
  1524. post:
  1525. tags:
  1526. - 职员管理
  1527. summary: 保存职员信息
  1528. operationId: 'app\api\controller\Staff::save'
  1529. parameters:
  1530. -
  1531. name: token
  1532. in: header
  1533. description: token
  1534. schema:
  1535. type: string
  1536. requestBody:
  1537. content:
  1538. multipart/form-data:
  1539. schema:
  1540. required:
  1541. - name
  1542. - code
  1543. - mobile
  1544. - joinTime
  1545. - staffTitleId
  1546. - storeId
  1547. properties:
  1548. name:
  1549. description: 职员名称
  1550. type: string
  1551. default: tony
  1552. code:
  1553. description: 职员工号
  1554. type: string
  1555. default: A9527
  1556. mobile:
  1557. description: 职员手机号
  1558. type: string
  1559. default: '12367897654'
  1560. joinTime:
  1561. description: 入职日期
  1562. type: string
  1563. default: '2020-01-04'
  1564. staffTitleId:
  1565. description: 职称id
  1566. type: integer
  1567. default: '1'
  1568. storeId:
  1569. description: storeId
  1570. type: integer
  1571. default: '1'
  1572. type: object
  1573. responses:
  1574. '200':
  1575. description: 请求成功
  1576. /api/Staff/read:
  1577. get:
  1578. tags:
  1579. - 职员管理
  1580. summary: 查看职员信息
  1581. operationId: 'app\api\controller\Staff::read'
  1582. parameters:
  1583. -
  1584. name: token
  1585. in: header
  1586. description: token
  1587. schema:
  1588. type: string
  1589. -
  1590. name: id
  1591. in: query
  1592. description: 职员id
  1593. schema:
  1594. type: ineger
  1595. default: '1'
  1596. requestBody: { }
  1597. responses:
  1598. '200':
  1599. description: 请求成功
  1600. /api/Staff/delete:
  1601. get:
  1602. tags:
  1603. - 职员管理
  1604. summary: 删除职员信息
  1605. operationId: 'app\api\controller\Staff::delete'
  1606. parameters:
  1607. -
  1608. name: token
  1609. in: header
  1610. description: token
  1611. schema:
  1612. type: string
  1613. -
  1614. name: id
  1615. in: query
  1616. description: 职员id
  1617. schema:
  1618. type: ineger
  1619. default: '1'
  1620. -
  1621. name: status
  1622. in: query
  1623. description: '1正常 2删除'
  1624. schema:
  1625. type: ineger
  1626. default: '1'
  1627. requestBody: { }
  1628. responses:
  1629. '200':
  1630. description: 请求成功
  1631. /api/Store/index:
  1632. get:
  1633. tags:
  1634. - 门店管理
  1635. summary: 门店列表
  1636. operationId: 'app\api\controller\Store::index'
  1637. parameters:
  1638. -
  1639. name: token
  1640. in: header
  1641. description: token
  1642. schema:
  1643. type: string
  1644. -
  1645. name: page
  1646. in: query
  1647. description: 页码
  1648. schema:
  1649. type: ineger
  1650. default: '1'
  1651. -
  1652. name: pageSize
  1653. in: query
  1654. description: 页尺寸
  1655. schema:
  1656. type: integer
  1657. default: '10'
  1658. -
  1659. name: status
  1660. in: query
  1661. description: '状态 1正常 2闭店 3歇业'
  1662. schema:
  1663. type: integer
  1664. default: '1'
  1665. -
  1666. name: name
  1667. in: query
  1668. description: 门店名称
  1669. schema:
  1670. type: string
  1671. -
  1672. name: lat
  1673. in: query
  1674. description: 经度
  1675. schema:
  1676. type: string
  1677. -
  1678. name: lon
  1679. in: query
  1680. description: 纬度
  1681. schema:
  1682. type: string
  1683. -
  1684. name: groupId
  1685. in: query
  1686. description: 集团id
  1687. schema:
  1688. type: string
  1689. -
  1690. name: type
  1691. in: query
  1692. description: '类型 1为当前管理人员的门店'
  1693. schema:
  1694. type: integer
  1695. requestBody: { }
  1696. responses:
  1697. '200':
  1698. description: 请求成功
  1699. /api/Store/save:
  1700. post:
  1701. tags:
  1702. - 门店管理
  1703. summary: 保存门店信息
  1704. operationId: 'app\api\controller\Store::save'
  1705. parameters:
  1706. -
  1707. name: token
  1708. in: header
  1709. description: token
  1710. schema:
  1711. type: string
  1712. requestBody:
  1713. content:
  1714. multipart/form-data:
  1715. schema:
  1716. required:
  1717. - name
  1718. - code
  1719. - openTime
  1720. - closeTime
  1721. - groupId
  1722. - companyId
  1723. - brandId
  1724. - logo
  1725. - latitude
  1726. - longitude
  1727. - address
  1728. - mobile
  1729. - storeContent
  1730. properties:
  1731. name:
  1732. description: 门店名称
  1733. type: string
  1734. default: 测试门店1
  1735. code:
  1736. description: 门店code
  1737. type: string
  1738. default: A001
  1739. openTime:
  1740. description: 营业时间
  1741. type: string
  1742. default: '06:00'
  1743. closeTime:
  1744. description: 闭店时间
  1745. type: string
  1746. default: '22:00'
  1747. payCode:
  1748. description: 支付标识
  1749. type: string
  1750. default: paycode1
  1751. groupId:
  1752. description: 所属集团id
  1753. type: integer
  1754. default: '1'
  1755. companyId:
  1756. description: 所属公司id
  1757. type: integer
  1758. default: '1'
  1759. brandId:
  1760. description: 所属品牌id
  1761. type: integer
  1762. default: '1'
  1763. logo:
  1764. description: logo的url
  1765. type: string
  1766. 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'
  1767. latitude:
  1768. description: 纬度
  1769. type: string
  1770. default: '31.241510099342623'
  1771. longitude:
  1772. description: 经度
  1773. type: string
  1774. default: '121.32174958203123'
  1775. address:
  1776. description: 地址
  1777. type: string
  1778. default: 上海市普陀区真北路
  1779. mobile:
  1780. description: 联系电话
  1781. type: string
  1782. default: '15656789876'
  1783. storeContent:
  1784. description: 门店介绍
  1785. type: string
  1786. default: 本店所有商品照片为专业摄影师拍摄,后期起精心修制及色彩调整,尽量与实际商品保持一致。
  1787. id:
  1788. description: 门店id
  1789. type: string
  1790. default: ''
  1791. status:
  1792. description: '门店状态 1正常 2闭店 3暂歇'
  1793. type: '0'
  1794. type: object
  1795. responses:
  1796. '200':
  1797. description: 请求成功
  1798. /api/Store/read:
  1799. get:
  1800. tags:
  1801. - 门店管理
  1802. summary: 查看门店信息
  1803. operationId: 'app\api\controller\Store::read'
  1804. parameters:
  1805. -
  1806. name: token
  1807. in: header
  1808. description: token
  1809. schema:
  1810. type: string
  1811. -
  1812. name: id
  1813. in: query
  1814. description: 门店id
  1815. schema:
  1816. type: ineger
  1817. default: '1'
  1818. requestBody: { }
  1819. responses:
  1820. '200':
  1821. description: 请求成功
  1822. /api/Store/delete:
  1823. get:
  1824. tags:
  1825. - 门店管理
  1826. summary: 删除门店信息
  1827. operationId: 'app\api\controller\Store::delete'
  1828. parameters:
  1829. -
  1830. name: token
  1831. in: header
  1832. description: token
  1833. schema:
  1834. type: string
  1835. -
  1836. name: id
  1837. in: query
  1838. description: 门店id
  1839. schema:
  1840. type: ineger
  1841. default: '1'
  1842. -
  1843. name: status
  1844. in: query
  1845. description: '1正常 2闭店 3暂歇'
  1846. schema:
  1847. type: ineger
  1848. default: '1'
  1849. requestBody: { }
  1850. responses:
  1851. '200':
  1852. description: 请求成功
  1853. /api/Store/getStore:
  1854. post:
  1855. tags:
  1856. - 门店管理
  1857. summary: 距离最近的一家门店
  1858. operationId: 'app\api\controller\Store::getStore'
  1859. parameters:
  1860. -
  1861. name: token
  1862. in: header
  1863. description: token
  1864. schema:
  1865. type: string
  1866. requestBody:
  1867. content:
  1868. multipart/form-data:
  1869. schema:
  1870. required:
  1871. - lat
  1872. - lon
  1873. properties:
  1874. lat:
  1875. description: 纬度
  1876. type: string
  1877. default: ''
  1878. lon:
  1879. description: 经度
  1880. type: string
  1881. default: ''
  1882. type: object
  1883. responses:
  1884. '200':
  1885. description: 请求成功
  1886. /api/Store/appointmentTime:
  1887. get:
  1888. tags:
  1889. - 门店管理
  1890. summary: 可预约时间
  1891. operationId: 'app\api\controller\Store::appointmentTime'
  1892. parameters:
  1893. -
  1894. name: token
  1895. in: header
  1896. description: token
  1897. schema:
  1898. type: string
  1899. -
  1900. name: storeId
  1901. in: query
  1902. description: 门店id
  1903. schema:
  1904. type: ineger
  1905. default: '1'
  1906. requestBody: { }
  1907. responses:
  1908. '200':
  1909. description: 请求成功
  1910. /api/User:
  1911. get:
  1912. tags:
  1913. - 用户管理
  1914. summary: 用户列表
  1915. operationId: 'app\api\controller\User::index'
  1916. parameters:
  1917. -
  1918. name: token
  1919. in: header
  1920. description: token
  1921. schema:
  1922. type: string
  1923. -
  1924. name: page
  1925. in: query
  1926. description: 页码
  1927. schema:
  1928. type: string
  1929. default: '1'
  1930. -
  1931. name: pageSize
  1932. in: query
  1933. description: 页尺寸
  1934. schema:
  1935. type: string
  1936. default: '10'
  1937. -
  1938. name: status
  1939. in: query
  1940. description: '状态 1正常 2删除'
  1941. schema:
  1942. type: string
  1943. -
  1944. name: mobile
  1945. in: query
  1946. description: 手机号
  1947. schema:
  1948. type: string
  1949. -
  1950. name: name
  1951. in: query
  1952. description: 昵称
  1953. schema:
  1954. type: string
  1955. -
  1956. name: cardLevel
  1957. in: query
  1958. description: '会员等级 1非会员,2金卡会员,3铂金会员'
  1959. schema:
  1960. type: string
  1961. -
  1962. name: joinType
  1963. in: query
  1964. description: '加入方式 1小程序 2后台预约'
  1965. schema:
  1966. type: string
  1967. requestBody: { }
  1968. responses:
  1969. '200':
  1970. description: 请求成功
  1971. /api/user/save:
  1972. post:
  1973. tags:
  1974. - 用户管理
  1975. summary: 保存用户(有id就更新,没id就新增)
  1976. operationId: 'app\api\controller\User::save'
  1977. parameters:
  1978. -
  1979. name: token
  1980. in: header
  1981. description: token
  1982. schema:
  1983. type: string
  1984. requestBody:
  1985. content:
  1986. application/json:
  1987. schema:
  1988. required:
  1989. - title
  1990. - content
  1991. properties:
  1992. code:
  1993. description: 微信小程序
  1994. type: string
  1995. default: dd
  1996. type: object
  1997. responses:
  1998. '200':
  1999. description: 请求成功
  2000. /api/User/editUser:
  2001. post:
  2002. tags:
  2003. - 用户管理
  2004. summary: 修改用户信息
  2005. operationId: 'app\api\controller\User::editUser'
  2006. parameters:
  2007. -
  2008. name: token
  2009. in: header
  2010. description: token
  2011. schema:
  2012. type: string
  2013. requestBody:
  2014. content:
  2015. multipart/form-data:
  2016. schema:
  2017. required:
  2018. - name
  2019. - birthday
  2020. - avatar
  2021. properties:
  2022. name:
  2023. description: 用户姓名
  2024. type: string
  2025. default: 小明
  2026. birthday:
  2027. description: 生日
  2028. type: string
  2029. default: '1889-02-03'
  2030. avatar:
  2031. description: 头像
  2032. type: string
  2033. default: 'http://xxx.com'
  2034. sex:
  2035. description: '性别 0未知 1男 2女'
  2036. type: string
  2037. default: 'http://xxx.com'
  2038. type: object
  2039. responses:
  2040. '200':
  2041. description: 请求成功
  2042. /api/User/read:
  2043. get:
  2044. tags:
  2045. - 用户管理
  2046. summary: 读取单个用户信息
  2047. operationId: 'app\api\controller\User::read'
  2048. parameters:
  2049. -
  2050. name: token
  2051. in: header
  2052. description: token
  2053. schema:
  2054. type: string
  2055. requestBody:
  2056. content:
  2057. multipart/form-data:
  2058. schema:
  2059. required:
  2060. - id
  2061. properties:
  2062. id:
  2063. description: 用户id
  2064. type: int
  2065. type: object
  2066. responses:
  2067. '200':
  2068. description: 请求成功