swagger.yaml 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566
  1. definitions:
  2. http_model.CodeLoginData:
  3. properties:
  4. token:
  5. type: string
  6. type: object
  7. http_model.CodeLoginRequest:
  8. properties:
  9. code:
  10. type: string
  11. phone:
  12. type: string
  13. type: object
  14. http_model.CommonResponse:
  15. properties:
  16. data: {}
  17. message:
  18. type: string
  19. status:
  20. type: integer
  21. type: object
  22. http_model.CreateProductData:
  23. properties:
  24. product_id:
  25. description: 商品id
  26. type: integer
  27. type: object
  28. http_model.CreateProductPhoto:
  29. properties:
  30. photo_uid:
  31. type: string
  32. photo_url:
  33. description: 图片或视频url
  34. type: string
  35. symbol:
  36. description: 图片为主图或详情图标志位,1为主图,2为详情图,3为视频
  37. type: integer
  38. type: object
  39. http_model.CreateProductRequest:
  40. properties:
  41. brand_name:
  42. type: string
  43. product_detail:
  44. type: string
  45. product_id:
  46. type: integer
  47. product_name:
  48. description: 商品名称
  49. type: string
  50. product_photos:
  51. description: 商品图片列表
  52. items:
  53. $ref: '#/definitions/http_model.CreateProductPhoto'
  54. type: array
  55. product_price:
  56. description: 商品价值
  57. type: integer
  58. product_type:
  59. description: 商品类型
  60. type: integer
  61. product_url:
  62. description: 商品链接,可为电商网址、公司官网、大众点评的店铺地址等可以说明商品信息或者品牌信息的线上地址;
  63. type: string
  64. shop_address:
  65. description: 店铺地址,商品类型为线下品牌时需填写
  66. type: string
  67. type: object
  68. http_model.FindProductData:
  69. properties:
  70. brand_name:
  71. description: 品牌名称
  72. type: string
  73. enterprise_id:
  74. description: 所属企业id
  75. type: integer
  76. product_detail:
  77. type: string
  78. product_id:
  79. type: integer
  80. product_name:
  81. description: 商品名称
  82. type: string
  83. product_photos:
  84. description: 商品图片列表
  85. items:
  86. $ref: '#/definitions/http_model.ProductPhoto'
  87. type: array
  88. product_price:
  89. description: 商品价值
  90. type: integer
  91. product_type:
  92. description: 商品类型
  93. type: integer
  94. product_url:
  95. description: 商品链接,可为电商网址、公司官网、大众点评的店铺地址等可以说明商品信息或者品牌信息的线上地址;
  96. type: string
  97. shop_address:
  98. description: 店铺地址,商品类型为线下品牌时需填写
  99. type: string
  100. type: object
  101. http_model.FindProductRequest:
  102. properties:
  103. product_id:
  104. type: integer
  105. type: object
  106. http_model.FullProjectListData:
  107. properties:
  108. full_project_pre_view:
  109. items:
  110. $ref: '#/definitions/http_model.FullProjectPreview'
  111. type: array
  112. total:
  113. type: string
  114. type: object
  115. http_model.FullProjectListRequest:
  116. properties:
  117. page_num:
  118. type: integer
  119. page_size:
  120. type: integer
  121. project_content_type:
  122. description: 内容形式
  123. type: string
  124. project_form:
  125. description: 项目形式
  126. type: string
  127. project_id:
  128. description: 项目ID
  129. type: string
  130. project_name:
  131. description: 项目名
  132. type: string
  133. project_platform:
  134. description: 项目平台
  135. type: string
  136. project_status:
  137. description: 项目状态
  138. type: string
  139. project_updated:
  140. description: 最后操作时间
  141. type: string
  142. type: object
  143. http_model.FullProjectPreview:
  144. properties:
  145. project_content_type:
  146. description: ProjectFeeForms []string `json:"project_fee_forms"` //
  147. 稿费形式
  148. type: string
  149. project_form:
  150. description: 项目形式
  151. type: string
  152. project_id:
  153. description: 项目ID
  154. type: string
  155. project_name:
  156. description: 项目名
  157. type: string
  158. project_platform:
  159. description: 项目平台
  160. type: string
  161. project_status:
  162. description: 项目状态
  163. type: string
  164. project_updated:
  165. description: 最后操作时间
  166. type: string
  167. type: object
  168. http_model.ProductPhoto:
  169. properties:
  170. photo_uid:
  171. type: string
  172. photo_url:
  173. description: 图片或视频url
  174. type: string
  175. symbol:
  176. description: 图片为主图或详情图标志位,1为主图,2为详情图,3为视频
  177. type: integer
  178. type: object
  179. http_model.ProjectChangeTaskStatusRequest:
  180. properties:
  181. task_status:
  182. type: string
  183. taskIds:
  184. items:
  185. type: string
  186. type: array
  187. type: object
  188. http_model.ProjectTaskListData:
  189. properties:
  190. project_task_pre_view:
  191. items:
  192. $ref: '#/definitions/http_model.ProjectTaskPreview'
  193. type: array
  194. total:
  195. type: string
  196. type: object
  197. http_model.ProjectTaskListRequest:
  198. properties:
  199. page_num:
  200. type: integer
  201. page_size:
  202. type: integer
  203. platform_nickname:
  204. description: 账号昵称
  205. type: string
  206. project_id:
  207. description: 项目ID
  208. type: string
  209. strategy_id:
  210. description: 策略ID
  211. type: string
  212. task_id:
  213. description: 任务ID
  214. type: string
  215. task_status:
  216. description: 任务状态
  217. type: string
  218. type: object
  219. http_model.ProjectTaskPreview:
  220. properties:
  221. create_date:
  222. description: 创建时间
  223. type: string
  224. fans_count:
  225. description: 粉丝数
  226. type: string
  227. home_page_capture_url:
  228. description: 主页链接
  229. type: string
  230. platform_nickname:
  231. description: 账号昵称
  232. type: string
  233. strategy_id:
  234. description: 报名选择的招募策略id
  235. type: string
  236. talent_personal_info_snap:
  237. description: 达人个人信息快照
  238. type: string
  239. task_id:
  240. description: 任务ID
  241. type: string
  242. task_reward:
  243. description: 任务奖励金额
  244. type: string
  245. task_status:
  246. description: 任务状态
  247. type: string
  248. type: object
  249. http_model.SendCodeData:
  250. type: object
  251. http_model.SendCodeRequest:
  252. properties:
  253. email:
  254. type: string
  255. phone:
  256. type: string
  257. type: object
  258. http_model.ShowProjectData:
  259. properties:
  260. content_type:
  261. description: 内容形式,1代表图文,2代表视频
  262. type: string
  263. create_at:
  264. description: 创建时间
  265. type: string
  266. enterprise_id:
  267. description: 企业id
  268. type: string
  269. phone:
  270. description: 联系方式
  271. type: string
  272. product_id:
  273. description: 关联商品id
  274. type: string
  275. project_detail:
  276. description: 项目详情
  277. type: string
  278. project_form:
  279. description: 项目形式,1-4分别代表实体商品寄拍、虚拟产品测评、线下探店打卡、素材微原创
  280. type: string
  281. project_id:
  282. description: 项目id
  283. type: string
  284. project_name:
  285. description: 项目名称
  286. type: string
  287. project_photos:
  288. description: 项目图片
  289. items:
  290. $ref: '#/definitions/http_model.ShowProjectPhoto'
  291. type: array
  292. project_platform:
  293. description: 项目平台,1-7分别代表红book、抖音、微博、快手、b站、大众点评、知乎
  294. type: string
  295. project_status:
  296. description: 项目状态,1-7分别代表创建中、待审核、招募中、待支付、失效、执行中、已结案
  297. type: string
  298. project_type:
  299. description: 项目类型,1代表全流程项目,2代表专项项目
  300. type: string
  301. recruit_ddl:
  302. description: 招募截止时间
  303. type: string
  304. recruit_strategys:
  305. description: 定价策略
  306. items:
  307. $ref: '#/definitions/http_model.ShowRecruitStrategy'
  308. type: array
  309. talent_type:
  310. description: 达人类型
  311. type: string
  312. type: object
  313. http_model.ShowProjectPhoto:
  314. properties:
  315. photo_uid:
  316. type: string
  317. photo_url:
  318. description: 图片url
  319. type: string
  320. type: object
  321. http_model.ShowProjectRequest:
  322. properties:
  323. Project_id:
  324. description: 项目id
  325. type: integer
  326. type: object
  327. http_model.ShowRecruitStrategy:
  328. properties:
  329. fee_form:
  330. description: 稿费形式,1-3分别代表自报价、固定稿费、产品置换
  331. type: string
  332. followers_low:
  333. description: 达人粉丝数下限
  334. type: string
  335. followers_up:
  336. description: 达人粉丝数上限
  337. type: string
  338. offer:
  339. description: 报价
  340. type: string
  341. recruit_number:
  342. description: 招募数量
  343. type: string
  344. strategy_id:
  345. description: 策略id
  346. type: string
  347. type: object
  348. info:
  349. contact: {}
  350. paths:
  351. /login:
  352. post:
  353. consumes:
  354. - application/json
  355. description: 输入手机号和验证码,并登录
  356. parameters:
  357. - description: 登录输入内容请求参数结构体
  358. in: body
  359. name: req
  360. required: true
  361. schema:
  362. $ref: '#/definitions/http_model.CodeLoginRequest'
  363. produces:
  364. - application/json
  365. responses:
  366. "200":
  367. description: 登录返回相应结构体
  368. schema:
  369. allOf:
  370. - $ref: '#/definitions/http_model.CommonResponse'
  371. - properties:
  372. data:
  373. $ref: '#/definitions/http_model.CodeLoginData'
  374. type: object
  375. summary: login 登录
  376. /product/changeTaskStatus:
  377. post:
  378. consumes:
  379. - application/json
  380. description: 更改项目任务的状态
  381. parameters:
  382. - description: 更改项目任务状态的请求结构体
  383. in: body
  384. name: req
  385. required: true
  386. schema:
  387. $ref: '#/definitions/http_model.ProjectChangeTaskStatusRequest'
  388. produces:
  389. - application/json
  390. responses:
  391. "200":
  392. description: 更改项目任务状态相应结构体
  393. schema:
  394. $ref: '#/definitions/http_model.CommonResponse'
  395. summary: ProjectChangeTaskStatus 更改项目任务状态
  396. /product/create:
  397. post:
  398. consumes:
  399. - application/json
  400. description: 企业创建商品,添加到商品库
  401. parameters:
  402. - description: 登录TOKEN信息
  403. in: header
  404. name: Authorization
  405. required: true
  406. type: string
  407. - description: 创建商品请求结构体
  408. in: body
  409. name: req
  410. required: true
  411. schema:
  412. $ref: '#/definitions/http_model.CreateProductRequest'
  413. produces:
  414. - application/json
  415. responses:
  416. "200":
  417. description: 创建商品相应结构体
  418. schema:
  419. allOf:
  420. - $ref: '#/definitions/http_model.CommonResponse'
  421. - properties:
  422. data:
  423. $ref: '#/definitions/http_model.CreateProductData'
  424. type: object
  425. summary: CreateProduct 创建商品
  426. /product/find:
  427. post:
  428. consumes:
  429. - application/json
  430. description: 根据产品名称查询产品信息
  431. parameters:
  432. - description: 登录TOKEN信息
  433. in: header
  434. name: Authorization
  435. required: true
  436. type: string
  437. - description: 发送产品id请求参数结构体
  438. in: body
  439. name: req
  440. required: true
  441. schema:
  442. $ref: '#/definitions/http_model.FindProductRequest'
  443. produces:
  444. - application/json
  445. responses:
  446. "200":
  447. description: 查询对应产品返回相应结构体
  448. schema:
  449. allOf:
  450. - $ref: '#/definitions/http_model.CommonResponse'
  451. - properties:
  452. data:
  453. $ref: '#/definitions/http_model.FindProductData'
  454. type: object
  455. summary: findProduct 根据产品名称查询产品信息
  456. /product/list:
  457. post:
  458. consumes:
  459. - application/json
  460. description: 展示企业的商品列表
  461. parameters:
  462. - description: 登录TOKEN信息
  463. in: header
  464. name: Authorization
  465. required: true
  466. type: string
  467. - description: 创建全部商品请求结构体
  468. in: body
  469. name: req
  470. required: true
  471. schema:
  472. $ref: '#/definitions/http_model.FullProjectListRequest'
  473. produces:
  474. - application/json
  475. responses:
  476. "200":
  477. description: 创建全部商品列表相应结构体
  478. schema:
  479. allOf:
  480. - $ref: '#/definitions/http_model.CommonResponse'
  481. - properties:
  482. data:
  483. $ref: '#/definitions/http_model.FullProjectListData'
  484. type: object
  485. summary: ProjectList 商品列表
  486. /product/taskList:
  487. post:
  488. consumes:
  489. - application/json
  490. description: 展示某个项目的任务列表
  491. parameters:
  492. - description: 查询项目的任务列表的请求结构体
  493. in: body
  494. name: req
  495. required: true
  496. schema:
  497. $ref: '#/definitions/http_model.ProjectTaskListRequest'
  498. produces:
  499. - application/json
  500. responses:
  501. "200":
  502. description: 查询项目的任务列表相应结构体
  503. schema:
  504. allOf:
  505. - $ref: '#/definitions/http_model.CommonResponse'
  506. - properties:
  507. data:
  508. $ref: '#/definitions/http_model.ProjectTaskListData'
  509. type: object
  510. summary: ProjectTaskList 项目任务列表
  511. /project/show:
  512. post:
  513. consumes:
  514. - application/json
  515. description: 企业查看执行中项目
  516. parameters:
  517. - description: 登录TOKEN信息
  518. in: header
  519. name: Authorization
  520. required: true
  521. type: string
  522. - description: 查看项目请求结构体
  523. in: body
  524. name: req
  525. required: true
  526. schema:
  527. $ref: '#/definitions/http_model.ShowProjectRequest'
  528. produces:
  529. - application/json
  530. responses:
  531. "200":
  532. description: 查看项目相应结构体
  533. schema:
  534. allOf:
  535. - $ref: '#/definitions/http_model.CommonResponse'
  536. - properties:
  537. data:
  538. $ref: '#/definitions/http_model.ShowProjectData'
  539. type: object
  540. summary: CreateProduct 创建商品
  541. /sendCode:
  542. post:
  543. consumes:
  544. - application/json
  545. description: 发送验证码,每次发送到邮箱
  546. parameters:
  547. - description: 发送验证码请求参数结构体
  548. in: body
  549. name: req
  550. required: true
  551. schema:
  552. $ref: '#/definitions/http_model.SendCodeRequest'
  553. produces:
  554. - application/json
  555. responses:
  556. "200":
  557. description: 发送验证码请求相应结构体
  558. schema:
  559. allOf:
  560. - $ref: '#/definitions/http_model.CommonResponse'
  561. - properties:
  562. data:
  563. $ref: '#/definitions/http_model.SendCodeData'
  564. type: object
  565. summary: sendCode 发送验证码
  566. swagger: "2.0"