swagger.yaml 9.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370
  1. basePath: /
  2. definitions:
  3. models.GetBlackListReq:
  4. properties:
  5. type:
  6. description: 类型
  7. type: integer
  8. user_id:
  9. description: 用户ID
  10. type: string
  11. type: object
  12. models.QuickLoginReq:
  13. properties:
  14. mobile_phone:
  15. type: string
  16. valid_code:
  17. type: string
  18. type: object
  19. models.SendSmsReq:
  20. properties:
  21. content:
  22. type: string
  23. mobile:
  24. type: string
  25. type: object
  26. models.UpdateProfileReq:
  27. properties:
  28. area:
  29. description: 地区
  30. type: string
  31. birthday:
  32. description: 生日
  33. type: string
  34. gender:
  35. description: 性别
  36. type: integer
  37. height:
  38. description: 用户身高
  39. type: integer
  40. user_avatar:
  41. description: 地区
  42. type: string
  43. user_id:
  44. description: 用户代码
  45. type: string
  46. username:
  47. description: 会员昵称
  48. type: string
  49. weight:
  50. description: 用户体重
  51. type: integer
  52. type: object
  53. models.UploadBaseReq:
  54. properties:
  55. base64:
  56. description: base64字符串
  57. type: string
  58. map_base:
  59. description: mapBase64
  60. type: string
  61. task_id:
  62. description: 任务id
  63. type: string
  64. user_id:
  65. description: 用户id
  66. type: string
  67. type: object
  68. info:
  69. contact: {}
  70. description: This is a gin blog example
  71. title: gin-blog API
  72. version: 0.0.1
  73. paths:
  74. /area/getArea:
  75. get:
  76. description: 获取省市区
  77. parameters:
  78. - description: 地区code
  79. in: query
  80. name: p_code
  81. type: string
  82. produces:
  83. - application/json
  84. responses:
  85. "200":
  86. description: '{"code":200,"message":"success","data":{"token":"","customer":{"id":"","code":"","name":""}}}'
  87. schema:
  88. type: string
  89. summary: 获取省市区
  90. tags:
  91. - area
  92. /cert/list:
  93. get:
  94. description: 获取证书列表
  95. parameters:
  96. - description: 类型:传1
  97. in: query
  98. name: type
  99. type: string
  100. produces:
  101. - application/json
  102. responses:
  103. "200":
  104. description: '{"code":200,"message":"success","data":{"token":"","customer":{"id":"","code":"","name":""}}}'
  105. schema:
  106. type: string
  107. summary: 获取证书列表
  108. tags:
  109. - cert
  110. /cert/userList:
  111. get:
  112. description: 获取用户获得证书列表
  113. parameters:
  114. - description: 用户id
  115. in: query
  116. name: userId
  117. type: string
  118. produces:
  119. - application/json
  120. responses:
  121. "200":
  122. description: '{"code":200,"message":"success","data":{"token":"","customer":{"id":"","code":"","name":""}}}'
  123. schema:
  124. type: string
  125. summary: 获取用户获得证书列表
  126. tags:
  127. - cert
  128. /customer/getBlacklist:
  129. post:
  130. description: 获取用户黑白名单列表
  131. parameters:
  132. - description: 获取黑白名单列表
  133. in: body
  134. name: body
  135. required: true
  136. schema:
  137. $ref: '#/definitions/models.GetBlackListReq'
  138. produces:
  139. - application/json
  140. responses:
  141. "200":
  142. description: '{"code":200,"message":"success","data":{"token":"","customer":{"user_id":"","username":"","user_avatar":"https://"}}}'
  143. schema:
  144. type: string
  145. summary: 获取用户黑白名单列表
  146. tags:
  147. - Customer
  148. /customer/getInfo:
  149. get:
  150. description: 获取用户详细信息
  151. parameters:
  152. - description: 用户ID
  153. in: query
  154. name: user_id
  155. required: true
  156. type: string
  157. - description: 另一个用户id
  158. in: query
  159. name: other_id
  160. type: string
  161. produces:
  162. - application/json
  163. responses:
  164. "200":
  165. description: '{"code":200,"message":"success","data":{"token":"","customer":{"user_id":"","mobile_phone":"","user_name":"","avatar":"https://","gender":2,"birthday":"","area":"江苏省-南京市-鼓楼区","email":"","customer_level":0,"user_point":0,"user_money":0.00,"register_time":""}}}'
  166. schema:
  167. type: string
  168. summary: 获取用户详细信息
  169. tags:
  170. - Customer
  171. /customer/order:
  172. get:
  173. description: 获取赛事订单
  174. parameters:
  175. - description: 用户ID
  176. in: query
  177. name: user_id
  178. required: true
  179. type: string
  180. produces:
  181. - application/json
  182. responses:
  183. "200":
  184. description: '{"code":200,"message":"success","data":{"token":"","customer":{"user_id":"","mobile_phone":"","user_name":"","avatar":"https://","gender":2,"birthday":"","area":"江苏省-南京市-鼓楼区","email":"","customer_level":0,"user_point":0,"user_money":0.00,"register_time":""}}}'
  185. schema:
  186. type: string
  187. summary: 获取赛事订单
  188. tags:
  189. - Customer
  190. /customer/qualifying:
  191. get:
  192. description: 获取排位赛列表
  193. parameters:
  194. - description: 用户ID
  195. in: query
  196. name: user_id
  197. required: true
  198. type: string
  199. produces:
  200. - application/json
  201. responses:
  202. "200":
  203. description: '{"code":200,"message":"success","data":{"token":"","customer":{"user_id":"","mobile_phone":"","user_name":"","avatar":"https://","gender":2,"birthday":"","area":"江苏省-南京市-鼓楼区","email":"","customer_level":0,"user_point":0,"user_money":0.00,"register_time":""}}}'
  204. schema:
  205. type: string
  206. summary: 获取排位赛列表
  207. tags:
  208. - Customer
  209. /customer/updateProfile:
  210. post:
  211. description: 修改用户资料
  212. parameters:
  213. - description: 修改用户资料请求内容
  214. in: body
  215. name: body
  216. required: true
  217. schema:
  218. $ref: '#/definitions/models.UpdateProfileReq'
  219. produces:
  220. - application/json
  221. responses:
  222. "200":
  223. description: '{"code":200,"message":"success","data":{}}'
  224. schema:
  225. type: string
  226. summary: 修改用户资料
  227. tags:
  228. - Customer
  229. /customer/uploadBase64:
  230. post:
  231. description: 上传base64图片
  232. parameters:
  233. - description: 修改用户资料请求内容
  234. in: body
  235. name: body
  236. required: true
  237. schema:
  238. $ref: '#/definitions/models.UploadBaseReq'
  239. produces:
  240. - application/json
  241. responses:
  242. "200":
  243. description: '{"code":200,"message":"success","data":{}}'
  244. schema:
  245. type: string
  246. summary: 上传base64图片
  247. tags:
  248. - Customer
  249. /medal/list:
  250. get:
  251. description: 获取勋章列表
  252. parameters:
  253. - description: 类型:传1
  254. in: query
  255. name: type
  256. type: string
  257. produces:
  258. - application/json
  259. responses:
  260. "200":
  261. description: '{"code":200,"message":"success","data":{"token":"","customer":{"id":"","code":"","name":""}}}'
  262. schema:
  263. type: string
  264. summary: 获取勋章列表
  265. tags:
  266. - medal
  267. /medal/userList:
  268. get:
  269. description: 获取用户获得勋章列表
  270. parameters:
  271. - description: 用户id
  272. in: query
  273. name: userId
  274. type: string
  275. produces:
  276. - application/json
  277. responses:
  278. "200":
  279. description: '{"code":200,"message":"success","data":{"token":"","customer":{"id":"","code":"","name":""}}}'
  280. schema:
  281. type: string
  282. summary: 获取用户获得勋章列表
  283. tags:
  284. - medal
  285. /passport/quickLogin:
  286. post:
  287. consumes:
  288. - application/json
  289. description: 登录注册
  290. parameters:
  291. - description: 快捷登录请求内容
  292. in: body
  293. name: body
  294. required: true
  295. schema:
  296. $ref: '#/definitions/models.QuickLoginReq'
  297. produces:
  298. - application/json
  299. responses:
  300. "200":
  301. description: '{"code":200,"message":"success","data":{"token":"","user":{}}}'
  302. schema:
  303. type: string
  304. security:
  305. - ApiKeyAuth: []
  306. summary: 登录注册
  307. tags:
  308. - Passport
  309. /sms/get:
  310. get:
  311. description: 获取短信验证码
  312. parameters:
  313. - description: 手机号码
  314. in: query
  315. name: mobile
  316. required: true
  317. type: string
  318. - default: 1
  319. description: 短信验证码类型(1=注册登录)
  320. enum:
  321. - 1
  322. - 2
  323. - 3
  324. - 4
  325. in: query
  326. name: type
  327. required: true
  328. type: integer
  329. produces:
  330. - application/json
  331. responses:
  332. "200":
  333. description: '{"code":200, "message":"success"}'
  334. schema:
  335. type: string
  336. security:
  337. - ApiKeyAuth: []
  338. summary: 获取短信验证码
  339. tags:
  340. - Sms
  341. /sms/remind:
  342. post:
  343. consumes:
  344. - application/json
  345. description: 发送提醒短信
  346. parameters:
  347. - description: 短信请求内容
  348. in: body
  349. name: body
  350. required: true
  351. schema:
  352. $ref: '#/definitions/models.SendSmsReq'
  353. produces:
  354. - application/json
  355. responses:
  356. "200":
  357. description: '{"code":200, "message":"success"}'
  358. schema:
  359. type: string
  360. security:
  361. - ApiKeyAuth: []
  362. summary: 发送提醒短信
  363. tags:
  364. - Sms
  365. securityDefinitions:
  366. ApiKeyAuth:
  367. in: header
  368. name: x-app-id
  369. type: apiKey
  370. swagger: "2.0"