apidoc.php 62 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492
  1. <?php
  2. /**
  3. * @api {get} common.public 公共参数说明
  4. * @apiVersion 1.0.0
  5. * @apiName common.public
  6. * @apiGroup Common
  7. *
  8. * @apiDescription 介绍公共参数
  9. *
  10. * @apiParam {Number} json 是否返回json格式的数据1为返回2为不返回
  11. * @apiParam {Number} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  12. * @apiParam {Number} pg 分页数,第几页,列表页瀑布流使用该参数
  13. *
  14. * @apiSuccess {Number} status 状态,1为有效2为无效
  15. * @apiSuccess {String} msg 请求的数据是否成功的提示
  16. * @apiSuccess {String} data 如果status为1,data有值
  17. * @apiSuccess {Object[]} page 分页信息
  18. * @apiSuccess {Number} page.total 分页总数
  19. * @apiSuccess {Number} page.current_page 当前页
  20. * @apiSuccess {Number} page.total_page 总页数
  21. * @apiSuccess {Number} page.next_page 下一页
  22. * @apiSuccess {Number} page.prev_page 上一页
  23. * @apiSuccess {Number} page.status 是否有下一页数据,0为没有
  24. */
  25. /**
  26. * @api {get} common.type 类型设置说明
  27. * @apiVersion 1.0.0
  28. * @apiName common.type
  29. * @apiGroup Common
  30. *
  31. * @apiDescription 类型设置说明
  32. *
  33. * @apiParam {String} source_type 请在header中定义,ios:ios | android:android | 移动h5:h5 | 小程序:applet | 公众号:service | pc网站:pc
  34. * @apiParam {Number} type 图文:1 | 视频:2 | 直播:3 | 小刊:4 | 小刊音视频:5 | 专题:6 | 小程序:7 | 商品:8 | 链接:10 | 评论: 11 || 直播评论:12 | 小刊活动页:13
  35. * @apiParam {Number} push_ 所有带push_开头的返回参数,返回字典都是一样的,参考获取首页数据中的push_focus
  36. */
  37. /**
  38. * @api {post} upload/upload/?save.start 上传图片接口
  39. * @apiVersion 1.0.0
  40. * @apiName save.start
  41. * @apiGroup Common
  42. *
  43. * @apiParam {Number} key 值为6,写死即可
  44. * @apiParam {String} file 文件流 multipart/form-data形式
  45. *
  46. * @apiSuccess {String} url 图片地址
  47. */
  48. /**
  49. * @api {get} wonderful/passport/?l=applet.bind 用户登录
  50. * @apiVersion 1.0.0
  51. * @apiName applet.bind
  52. * @apiGroup AppletPassport
  53. *
  54. * @apiDescription 用户登录
  55. *
  56. * @apiParam {String} code 微信登录返回的code
  57. *
  58. * @apiSuccess {Number} vid 微信id,请保存在本地
  59. * @apiSuccess {Number} uid 用户id,请保存在本地
  60. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  61. */
  62. /**
  63. * @api {get} wonderful/passport/?l=applet.update 更新用户信息
  64. * @apiVersion 1.0.0
  65. * @apiName applet.update
  66. * @apiGroup AppletPassport
  67. *
  68. * @apiDescription 更新用户信息
  69. *
  70. * @apiParam {String} nickname 用户昵称
  71. * @apiParam {String} avatarurl 用户头像
  72. * @apiParam {String} gender 性别
  73. * @apiParam {String} city 城市
  74. * @apiParam {String} province 省份
  75. * @apiParam {String} country 县区
  76. * @apiParam {String} iv 微信的加密参数
  77. * @apiParam {String} encryptedData 微信的加密参数
  78. * @apiParam {Number} vid 微信id
  79. * @apiParam {Number} uid 用户id
  80. * @apiParam {String} signature signature
  81. *
  82. *
  83. * @apiSuccess {Number} vid 微信id,请保存在本地
  84. * @apiSuccess {Number} uid 用户id,请保存在本地
  85. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  86. */
  87. /**
  88. * @api {get} wonderful/passport/?l=applet.mobile 更新用户手机号-微信绑定
  89. * @apiVersion 1.0.0
  90. * @apiName applet.mobile
  91. * @apiGroup AppletPassport
  92. *
  93. * @apiDescription 更新用户手机号-微信绑定
  94. *
  95. * @apiParam {String} iv 微信的加密参数
  96. * @apiParam {String} encryptedData 微信的加密参数
  97. * @apiParam {Number} vid 微信id
  98. * @apiParam {Number} uid 用户id
  99. * @apiParam {String} signature signature
  100. *
  101. *
  102. * @apiSuccess {Number} vid 微信id,请保存在本地
  103. * @apiSuccess {Number} uid 用户id,请保存在本地
  104. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  105. */
  106. /**
  107. * @api {get} wonderful/passport/?l=applet.bind_mobile 更新用户手机号-验证码绑定
  108. * @apiVersion 1.0.0
  109. * @apiName applet.bind_mobile
  110. * @apiGroup AppletPassport
  111. *
  112. * @apiDescription 更新用户手机号-验证码绑定
  113. *
  114. * @apiParam {Number} uid 用户id
  115. * @apiParam {Number} mobile 手机号
  116. * @apiParam {String} mcode 验证码
  117. * @apiParam {String} signature signature
  118. *
  119. * @apiSuccess {Number} uid 用户id,请保存在本地
  120. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  121. */
  122. /**
  123. * @api {get} wonderful/passport/?l=reg.getMCode 获取手机验证码
  124. * @apiVersion 1.0.0
  125. * @apiName reg.getMCode
  126. * @apiGroup AppletPassport
  127. *
  128. * @apiDescription 获取手机验证码
  129. *
  130. * @apiParam {Number} mobile 手机号
  131. *
  132. * @apiSuccess {String} msg 验证码已发送至您的手机,请注意查收,十分钟之内有效
  133. */
  134. /**
  135. * @api {get} wonderful/passport/?l=reg.getMCode 获取手机验证码,未登录状态
  136. * @apiVersion 1.0.0
  137. * @apiName reg.getMCode
  138. * @apiGroup AppPassport
  139. *
  140. * @apiDescription 获取手机验证码,未登录状态
  141. *
  142. * @apiParam {Number} mobile 手机号
  143. *
  144. * @apiSuccess {String} msg 验证码已发送至您的手机,请注意查收,十分钟之内有效
  145. */
  146. /**
  147. * @api {get} wonderful/passport/?l=reg.getMCodeLogin 获取手机验证码,已登录状态
  148. * @apiVersion 1.0.0
  149. * @apiName reg.getMCode
  150. * @apiGroup AppPassport
  151. *
  152. * @apiDescription 获取手机验证码,已登录状态
  153. *
  154. * @apiParam {Number} mobile 手机号
  155. * @apiParam {String} signature signature
  156. *
  157. * @apiSuccess {String} msg 验证码已发送至您的手机,请注意查收,十分钟之内有效
  158. */
  159. /**
  160. * @api {get} wonderful/passport/?l=app.login 登录与注册
  161. * @apiVersion 1.0.0
  162. * @apiName app.login
  163. * @apiGroup AppPassport
  164. *
  165. * @apiDescription 登录与注册
  166. *
  167. * @apiParam {Number} mobile 手机号
  168. * @apiParam {String} mcode 验证码
  169. *
  170. * @apiSuccess {Number} uid 用户id,请保存在本地
  171. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  172. */
  173. /**
  174. * @api {get} wonderful/passport/?l=app.login_uuid UUID登录
  175. * @apiVersion 1.0.0
  176. * @apiName app.login_uuid
  177. * @apiGroup AppPassport
  178. *
  179. * @apiDescription UUID登录
  180. *
  181. * @apiParam {Number} uuid UUID
  182. *
  183. * @apiSuccess {Number} uid 用户id,请保存在本地
  184. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  185. */
  186. /**
  187. * @api {get} wonderful/passport/?l=app.bind_mobile 更新用户手机号-验证码绑定
  188. * @apiVersion 1.0.0
  189. * @apiName app.bind_mobile
  190. * @apiGroup AppPassport
  191. *
  192. * @apiDescription 更新用户手机号-验证码绑定
  193. *
  194. * @apiParam {Number} uid 用户id
  195. * @apiParam {Number} mobile 手机号
  196. * @apiParam {String} mcode 验证码
  197. * @apiParam {String} signature signature
  198. *
  199. * @apiSuccess {Number} uid 用户id,请保存在本地
  200. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  201. */
  202. /**
  203. * @api {get} wonderful/passport/?l=app.wechat_reg 第三方登录-已经拥有openid
  204. * @apiVersion 1.0.0
  205. * @apiName app.wechat_reg
  206. * @apiGroup AppPassport
  207. *
  208. * @apiDescription 第三方登录-已经拥有openid
  209. *
  210. * @apiParam {String} username 用户名
  211. * @apiParam {String} avatar 头像
  212. * @apiParam {String} sex 性别
  213. * @apiParam {String} city 城市
  214. * @apiParam {String} province 省份
  215. * @apiParam {String} country 县区
  216. * @apiParam {String} openid openid
  217. * @apiParam {String} unionid unionid
  218. * @apiParam {String} access_token access_token
  219. * @apiParam {String} refresh_token refresh_token
  220. * @apiParam {String} expires_in 失效时间
  221. *
  222. * @apiSuccess {Number} uid 用户id,请保存在本地
  223. * @apiSuccess {Number} mobile 手机号,判断手机号是否存在,不存在则需要进行绑定,请直接使用app.bind_mobile接口进行绑定即可
  224. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  225. */
  226. /**
  227. * @api {get} wonderful/oauth/?l=request.callback 第三方登录
  228. * @apiVersion 1.0.0
  229. * @apiName request.callback
  230. * @apiGroup AppPassport
  231. *
  232. * @apiDescription 第三方登录
  233. *
  234. * @apiParam {Number} account 第三方登录的账号,写死为2吧
  235. * @apiParam {Number} system 系统id,写死为1,后续做ok精彩和精品时再加
  236. * @apiParam {String} source 渠道来源,写死为1,默认1则为官网渠道
  237. * @apiParam {String} source_type 渠道类型,写死为ios或者android
  238. * @apiParam {String} code 用户授权后返回的code
  239. *
  240. * @apiSuccess {Number} uid 用户id,请保存在本地
  241. * @apiSuccess {Number} mobile 手机号,判断手机号是否存在,不存在则需要进行绑定,请直接使用app.bind_mobile接口进行绑定即可
  242. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  243. */
  244. /**
  245. * @api {get} wonderful/passport/?l=app.update 更新用户信息
  246. * @apiVersion 1.0.0
  247. * @apiName app.update
  248. * @apiGroup AppPassport
  249. *
  250. * @apiDescription 更新用户信息
  251. *
  252. * @apiParam {Number} signature 用户signature
  253. * @apiParam {String} username 用户昵称
  254. * @apiParam {String} avatar 用户头像
  255. * @apiParam {String} gender 性别
  256. * @apiParam {String} city 城市
  257. * @apiParam {String} province 省份
  258. * @apiParam {String} country 县区
  259. *
  260. * @apiSuccess {Number} uid 用户id,请保存在本地
  261. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  262. */
  263. /**
  264. * @api {get} wonderful/main/?l=view.getHtml 获取富文本内容
  265. * @apiVersion 1.0.0
  266. * @apiName view.getHtml
  267. * @apiGroup App
  268. *
  269. * @apiDescription 获取富文本内容
  270. *
  271. * @apiParam {Number} signature 用户signature
  272. * @apiParam {String} type 类型1为图文、2为视频、3为直播、4为小刊内容,6为专题
  273. * @apiParam {String} id 图文等内容id,如果为4,则为小刊的内容id,而非小刊id
  274. *
  275. * @apiSuccess {String} html 直接返回html的信息,请注意里面的协议:jstyle://live_note?id=0&live_id=1&file=test
  276. 其中有几个:
  277. jstyle://video?id=0&vod_id=1&file=test 播放视频 id=0为content_array里的数组索引,vod_id为视频id,file为视频文件地址
  278. jstyle://live?id=0&live_id=1&file=test 播放直播 id=0为content_array里的数组索引,live_id为直播id,file为直播文件地址
  279. jstyle://live_note?id=0&live_id=1&file=test&note=1 设置直播提醒 id=0为content_array里的数组索引,live_id为直播id,file为直播文件地址,note值为1是已设置提醒,2为未设置提醒
  280. jstyle://auido?id=0&file=test&note=1 播放视频 id=0为content_array里的数组索引,file为直播文件地址
  281. */
  282. /**
  283. * @api {get} wonderful/live/?l=api.get 获取直播推流信息
  284. * @apiVersion 1.0.0
  285. * @apiName api.get
  286. * @apiGroup Live
  287. *
  288. * @apiDescription 获取直播推流信息
  289. *
  290. * @apiParam {String} signature 请将字符串signature_dever_2018_jm经过md5加密
  291. *
  292. * @apiSuccess {Object[]} active 直播活动列表
  293. * @apiSuccess {String} active.id 活动id
  294. * @apiSuccess {String} acitve.name 活动名称
  295. * @apiSuccess {Object[]} active.stream 直播流列表
  296. * @apiSuccess {String} active.stream.id 推流id
  297. * @apiSuccess {String} active.stream.live 推流实际地址
  298. * @apiSuccess {String} active.stream.url_rtmp 播放地址
  299. * @apiSuccess {String} active.stream.url_hls 播放地址
  300. * @apiSuccess {String} active.stream.url_hdl 播放地址
  301. * @apiSuccess {String} active.stream.url_pic 实时截图地址
  302. */
  303. /**
  304. * @api {get} wonderful/live/?l=api.start 开始推流
  305. * @apiVersion 1.0.0
  306. * @apiName api.start
  307. * @apiGroup Live
  308. *
  309. * @apiDescription 开始推流
  310. *
  311. * @apiParam {String} signature 请将字符串signature_dever_2018_jm经过md5加密
  312. * @apiParam {Number} id 推流id
  313. *
  314. * @apiSuccess {Number} id 推流id
  315. * @apiSuccess {Number} log_id 本次推流日志id
  316. */
  317. /**
  318. * @api {get} wonderful/live/?l=api.stop 结束推流
  319. * @apiVersion 1.0.0
  320. * @apiName api.stop
  321. * @apiGroup Live
  322. *
  323. * @apiDescription 结束推流 一定要调用该接口,否则不会生成回放地址
  324. *
  325. * @apiParam {String} signature 请将字符串signature_dever_2018_jm经过md5加密
  326. * @apiParam {Number} id 推流id
  327. * @apiParam {Number} log_id 本次推流日志id
  328. */
  329. /**
  330. * @api {get} wonderful/main/?l=content.home 获取首页数据
  331. * @apiVersion 1.0.0
  332. * @apiName content.home
  333. * @apiGroup Content
  334. *
  335. * @apiDescription 获取首页数据
  336. *
  337. * @apiParam {String} signature signature
  338. *
  339. *
  340. * @apiSuccess {Number} uid 用户id 所有接口中都有该项
  341. * @apiSuccess {Object[]} config 基本配置 所有接口中都有该项
  342. * @apiSuccess {String} config.name 系统名称 请将小程序和app头部名称替换为该字段
  343. * @apiSuccess {String} config.info 系统介绍
  344. * @apiSuccess {String} config.logo 系统logo
  345. * @apiSuccess {String} config.article_share_name 图文详情页分享文字
  346. * @apiSuccess {String} config.vod_share_name 视频详情页分享文字
  347. * @apiSuccess {String} config.live_share_name 直播详情页分享文字
  348. * @apiSuccess {String} config.ios_pay ios支付设置 1为不开启小程序支付,将所有购买按钮都隐藏掉,2为开启公众号支付,3开始小程序支付
  349. * @apiSuccess {String} config.ios_pay_pic ios里公众号支付引导图
  350. * @apiSuccess {Object[]} menu 栏目
  351. * @apiSuccess {String} menu.name 名称
  352. * @apiSuccess {String} menu.id 栏目id,访问content.news时可以使用menu=menu.id
  353. * @apiSuccess {Object[]} push_focus 焦点图
  354. * @apiSuccess {String} push_focus.name 名称
  355. * @apiSuccess {String} push_focus.cate_name 栏目名称
  356. * @apiSuccess {String} push_focus.author_name 作者名称
  357. * @apiSuccess {String} push_focus.pic 图片
  358. * @apiSuccess {String} push_focus.type 类型,参考公共参数中的类型设置说明中的type说明
  359. * @apiSuccess {String} push_focus.id 源表id,根据type计算路径,然后把这个id加上就是最终的path,小程序和app同样。如果没有id,则进入type相对应的列表。请做好判断!!
  360. * @apiSuccess {String} push_focus.appid 当type==7时有效,小程序的appid
  361. * @apiSuccess {String} push_focus.link 当type==10或者type==7时有效,链接,如果type==7并且链接存在,则跳转到链接
  362. * @apiSuccess {String} push_focus.cdate 时间
  363. * @apiSuccess {Object[]} push_link 精选分类,字段同上
  364. * @apiSuccess {Object[]} push_ad 广告位,字段同上
  365. * @apiSuccess {Object[]} push_open_ad 弹窗广告位,字段同上
  366. * @apiSuccess {Object[]} push_up 精选推荐,字段同上
  367. * @apiSuccess {Object[]} news 更多图文等数据
  368. * @apiSuccess {String} news.id 图文id
  369. * @apiSuccess {String} news.name 名称
  370. * @apiSuccess {String} news.pic_cover 4:3图片
  371. * @apiSuccess {String} news.pic_cover_169 16:9图片
  372. * @apiSuccess {String} news.type 类型,参考公共参数中的类型设置说明中的type说明,根据它生成path
  373. * @apiSuccess {String} news.pdate 时间
  374. * @apiSuccess {String} news.num_view 浏览量
  375. * @apiSuccess {String} news.num_up 喜欢量
  376. * @apiSuccess {String} news.num_comment 评论量
  377. * @apiSuccess {String} news.num_ding 订阅量
  378. * @apiSuccess {String} news.num_user 在线人数
  379. * @apiSuccess {String} news.share_yes 是否显示分享按钮 1显示 2不显示
  380. * @apiSuccess {String} news.share_title 分享标题
  381. * @apiSuccess {String} news.share_pic 分享图片
  382. * @apiSuccess {String} news.share_content 分享内容
  383. */
  384. /**
  385. * @api {get} wonderful/main/?l=content.ad 开屏广告接口
  386. * @apiVersion 1.0.0
  387. * @apiName content.ad
  388. * @apiGroup Content
  389. *
  390. * @apiDescription 开屏广告接口
  391. *
  392. * @apiParam {String} signature signature
  393. *
  394. *
  395. * @apiSuccess {Number} uid 用户id 所有接口中都有该项
  396. * @apiSuccess {Object[]} config 基本配置 所有接口中都有该项
  397. * @apiSuccess {String} config.name 系统名称 请将小程序和app头部名称替换为该字段
  398. * @apiSuccess {String} config.info 系统介绍
  399. * @apiSuccess {String} config.logo 系统logo
  400. * @apiSuccess {String} config.article_share_name 图文详情页分享文字
  401. * @apiSuccess {String} config.vod_share_name 视频详情页分享文字
  402. * @apiSuccess {String} config.live_share_name 直播详情页分享文字
  403. * @apiSuccess {String} config.ios_pay ios支付设置 1为不开启小程序支付,将所有购买按钮都隐藏掉,2为开启公众号支付,3开始小程序支付
  404. * @apiSuccess {String} config.ios_pay_pic ios里公众号支付引导图
  405. * @apiSuccess {Object[]} push_screen_ad 广告
  406. * @apiSuccess {String} push_screen_ad.name 名称
  407. * @apiSuccess {String} push_screen_ad.pic 图片
  408. */
  409. /**
  410. * @api {get} wonderful/main/?l=content.up 精选推荐更多
  411. * @apiVersion 1.0.0
  412. * @apiName content.up
  413. * @apiGroup Content
  414. *
  415. * @apiDescription 精选推荐更多
  416. *
  417. * @apiParam {String} signature signature
  418. *
  419. *
  420. * @apiSuccess {Object[]} push_up 栏目,字段同上
  421. * @apiSuccess {String} push_up.name 名称
  422. * @apiSuccess {String} push_up.pic 图片
  423. * @apiSuccess {String} push_up.type 类型,参考公共参数中的类型设置说明中的type说明
  424. * @apiSuccess {String} push_up.id 源表id,根据type计算路径,然后把这个source_id加上就是最终的path,小程序和app同样。
  425. * @apiSuccess {String} push_up.link 当type==10时有效,链接
  426. * @apiSuccess {String} push_up.cdate 时间
  427. */
  428. /**
  429. * @api {get} wonderful/main/?l=content.news 精选页图文内容下拉更多
  430. * @apiVersion 1.0.0
  431. * @apiName content.news
  432. * @apiGroup Content
  433. *
  434. * @apiDescription 精选页图文内容下拉更多
  435. *
  436. * @apiParam {String} signature signature
  437. * @apiParam {Number} menu 可选参数,栏目id
  438. * @apiParam {Number} type 可选参数,类型1为图文、2为视频、3为直播,小刊请到专门的接口获取
  439. *
  440. * @apiSuccess {Object[]} news 更多图文等数据
  441. * @apiSuccess {String} news.id 图文id
  442. * @apiSuccess {String} news.name 名称
  443. * @apiSuccess {String} news.pic_cover 4:3图片
  444. * @apiSuccess {String} news.pic_cover_169 16:9图片
  445. * @apiSuccess {String} news.type 类型,参考公共参数中的类型设置说明中的type说明,根据它生成path
  446. * @apiSuccess {String} news.pdate 时间
  447. * @apiSuccess {String} news.num_view 浏览量
  448. * @apiSuccess {String} news.num_up 喜欢量
  449. * @apiSuccess {String} news.num_comment 评论量
  450. * @apiSuccess {String} news.num_ding 订阅量
  451. * @apiSuccess {String} news.num_user 在线人数
  452. * @apiSuccess {String} news.share_yes 是否显示分享按钮 1显示 2不显示
  453. * @apiSuccess {String} news.share_title 分享标题
  454. * @apiSuccess {String} news.share_pic 分享图片
  455. * @apiSuccess {String} news.share_content 分享内容
  456. */
  457. /**
  458. * @api {get} wonderful/main/?l=vip.config 查看会员配置信息
  459. * @apiVersion 1.0.0
  460. * @apiName vip.config
  461. * @apiGroup Vip
  462. *
  463. * @apiDescription 查看会员配置信息
  464. *
  465. * @apiParam {String} signature signature
  466. *
  467. * @apiSuccess {Object[]} vip_config 配置信息
  468. * @apiSuccess {String} vip_config.name 配置名
  469. * @apiSuccess {String} vip_config.logo logo图
  470. * @apiSuccess {String} vip_config.code 二维码图
  471. * @apiSuccess {String} vip_config.download 下载地址
  472. * @apiSuccess {String} vip_config.pic1 会员宣传页第一张图
  473. * @apiSuccess {String} vip_config.pic2 会员宣传页第二张图
  474. * @apiSuccess {String} vip_config.pic3 会员宣传页第三张图
  475. * @apiSuccess {String} vip_config.pic4 会员宣传页第四张图
  476. * @apiSuccess {Object[]} vip_time 时效配置
  477. * @apiSuccess {String} vip_time.id 时效名
  478. * @apiSuccess {String} vip_time.name 时效名
  479. * @apiSuccess {String} vip_time.cash 优惠价、支付价格
  480. * @apiSuccess {String} vip_time.price 原价
  481. * @apiSuccess {String} vip_time.type 1为普通售价、2为超值售价
  482. * @apiSuccess {String} mobile 当前登录用户的手机号
  483. */
  484. /**
  485. * @api {get} wonderful/main/?l=vip.buy_action 发起支付
  486. * @apiVersion 1.0.0
  487. * @apiName vip.buy_action
  488. * @apiGroup Vip
  489. *
  490. * @apiDescription 发起支付:请注意,如果是苹果支付,请在发起苹果支付之后,将苹果返回的验证数据,传入该接口
  491. *
  492. * @apiParam {String} signature signature
  493. * @apiParam {String} mobile 手机号
  494. * @apiParam {String} buy_id 时效id
  495. * @apiParam {String} type 支付类型 wechat微信、alipay支付宝
  496. * @apiParam {String} receipt 当header中的source_type为ios时,请传入该参数,参数的值为苹果支付后返回的参数,即可发起支付验证。
  497. *
  498. * @apiSuccess {Object[]} pay 微信支付返回的数据,支付宝后续添加
  499. * @apiSuccess {String} pay.time 服务器时间戳
  500. * @apiSuccess {String} pay.nonce_str 随机字符串
  501. * @apiSuccess {String} pay.prepay_id 统一下单接口返回的 prepay_id 参数值,通过'prepay_id=' + prepay_id 拼装成package
  502. * @apiSuccess {String} pay.sign_type 签名算法
  503. * @apiSuccess {String} pay.sign 签名
  504. * @apiSuccess {String} pay.yes 苹果支付时显示改参数,1为支付成功2为支付失败
  505. */
  506. /**
  507. * @api {get} wonderful/main/?l=view.comment 查看评论列表
  508. * @apiVersion 1.0.0
  509. * @apiName view.comment
  510. * @apiGroup Content
  511. *
  512. * @apiDescription 查看评论列表
  513. *
  514. * @apiParam {String} signature signature
  515. * @apiParam {Number} id 图文id
  516. * @apiParam {Number} type 类型,参考公共参数中的类型设置说明中的type说明
  517. *
  518. * @apiSuccess {Object[]} comment 评论列表
  519. * @apiSuccess {String} comment.id
  520. * @apiSuccess {String} comment.username 用户名
  521. * @apiSuccess {String} comment.avatar 头像
  522. * @apiSuccess {String} comment.content 内容
  523. * @apiSuccess {String} comment.num_up 点赞数
  524. * @apiSuccess {String} comment.time 时间,请用这个时间吧
  525. * @apiSuccess {String} comment.cdate 时间
  526. * @apiSuccess {String} comment.up 是否点赞 1为点赞 2为未点赞
  527. * @apiSuccess {String} live_status 当type=3时,有该字段,直播状态,1为直播中,2为已结束,请根据该状态判断当前观看直播的用户是否能观看直播
  528. */
  529. /**
  530. * @api {get} wonderful/main/?l=view.article 查看图文内容
  531. * @apiVersion 1.0.0
  532. * @apiName view.article
  533. * @apiGroup Content
  534. *
  535. * @apiDescription 查看图文内容
  536. *
  537. * @apiParam {String} signature signature
  538. * @apiParam {Number} id 图文id
  539. *
  540. * @apiSuccess {Object[]} info 图文数据
  541. * @apiSuccess {String} info.id
  542. * @apiSuccess {String} info.name 名称
  543. * @apiSuccess {String} info.pic_cover 4:3图片
  544. * @apiSuccess {String} info.pic_cover_169 16:9图片
  545. * @apiSuccess {String} info.type 类型,参考公共参数中的类型设置说明中的type说明,根据它生成path
  546. * @apiSuccess {String} info.pdate 时间
  547. * @apiSuccess {String} info.cate_id 栏目ID
  548. * @apiSuccess {String} info.cate_name 栏目名称
  549. * @apiSuccess {String} info.author_id 作者ID
  550. * @apiSuccess {String} info.author_name 作者名称
  551. * @apiSuccess {String} info.num_view 浏览量
  552. * @apiSuccess {String} info.num_up 喜欢量
  553. * @apiSuccess {String} info.num_comment 评论量
  554. * @apiSuccess {String} info.share_yes 是否显示分享按钮 1显示 2不显示
  555. * @apiSuccess {String} info.share_title 分享标题
  556. * @apiSuccess {String} info.share_pic 分享图片
  557. * @apiSuccess {String} info.share_content 分享内容
  558. * @apiSuccess {String} info.function 开启的功能,这是一个字符串,用逗号隔开的,1代表显示浏览量,2代表显示评论,3代表显示喜欢,如值为1,2,则显示浏览量、评论,不显示喜欢
  559. * @apiSuccess {String} info.content 内容
  560. * @apiSuccess {String} info.content_array 数组内容,请使用该字段循环,type为类型,请参考类型设置说明,content为内容,type为1时为图文内容,type为2时content为视频详情的字段,type为3时content为直播详情的字段,当type为5时content为音频地址,name为标题,cover为封面、type为6时是视频地址,name为标题,cover为封面
  561. *
  562. * @apiSuccess {Object[]} comment 评论列表
  563. * @apiSuccess {String} comment.id
  564. * @apiSuccess {String} comment.username 用户名
  565. * @apiSuccess {String} comment.avatar 头像
  566. * @apiSuccess {String} comment.content 内容
  567. * @apiSuccess {String} comment.num_up 点赞数
  568. * @apiSuccess {String} comment.time 时间,请用这个时间
  569. * @apiSuccess {String} comment.cdate 时间
  570. * @apiSuccess {String} comment.up 是否点赞 1为点赞 2为未点赞
  571. *
  572. * @apiSuccess {Object[]} user_act 用户行为 当用户登录时有效
  573. * @apiSuccess {String} user_act.share 用户分享数
  574. * @apiSuccess {String} user_act.up 是否喜欢1为喜欢,2为未喜欢
  575. */
  576. /**
  577. * @api {get} wonderful/main/?l=view.feature 查看专题内容
  578. * @apiVersion 1.0.0
  579. * @apiName view.feature
  580. * @apiGroup Content
  581. *
  582. * @apiDescription 查看专题内容
  583. *
  584. * @apiParam {String} signature signature
  585. * @apiParam {Number} id 图文id
  586. *
  587. * @apiSuccess {Object[]} info 专题数据
  588. * @apiSuccess {String} info.id
  589. * @apiSuccess {String} info.name 名称
  590. * @apiSuccess {String} info.pic_cover 4:3图片
  591. * @apiSuccess {String} info.pic_cover_169 16:9图片
  592. * @apiSuccess {String} info.type 类型,参考公共参数中的类型设置说明中的type说明,根据它生成path
  593. * @apiSuccess {String} info.pdate 时间
  594. * @apiSuccess {String} info.cate_id 栏目ID
  595. * @apiSuccess {String} info.cate_name 栏目名称
  596. * @apiSuccess {String} info.author_id 作者ID
  597. * @apiSuccess {String} info.author_name 作者名称
  598. * @apiSuccess {String} info.num_view 浏览量
  599. * @apiSuccess {String} info.num_up 喜欢量
  600. * @apiSuccess {String} info.num_comment 评论量
  601. * @apiSuccess {String} info.share_yes 是否显示分享按钮 1显示 2不显示
  602. * @apiSuccess {String} info.share_title 分享标题
  603. * @apiSuccess {String} info.share_pic 分享图片
  604. * @apiSuccess {String} info.share_content 分享内容
  605. * @apiSuccess {String} info.function 开启的功能,这是一个字符串,用逗号隔开的,1代表显示浏览量,2代表显示评论,3代表显示喜欢,如值为1,2,则显示浏览量、评论,不显示喜欢
  606. * @apiSuccess {String} info.content 内容
  607. * @apiSuccess {String} info.content_array 数组内容,请使用该字段循环,type为类型,请参考类型设置说明,content为内容,type为1时为图文内容,type为2时content为视频详情的字段,type为3时content为直播详情的字段,当type为5时content为音频地址,name为标题,cover为封面、type为6时是视频地址,name为标题,cover为封面
  608. *
  609. * @apiSuccess {Object[]} comment 评论列表
  610. * @apiSuccess {String} comment.id
  611. * @apiSuccess {String} comment.username 用户名
  612. * @apiSuccess {String} comment.avatar 头像
  613. * @apiSuccess {String} comment.content 内容
  614. * @apiSuccess {String} comment.num_up 点赞数
  615. * @apiSuccess {String} comment.time 时间,请用这个时间
  616. * @apiSuccess {String} comment.cdate 时间
  617. * @apiSuccess {String} comment.up 是否点赞 1为点赞 2为未点赞
  618. *
  619. * @apiSuccess {Object[]} user_act 用户行为 当用户登录时有效
  620. * @apiSuccess {String} user_act.share 用户分享数
  621. * @apiSuccess {String} user_act.up 是否喜欢1为喜欢,2为未喜欢
  622. */
  623. /**
  624. * @api {get} wonderful/main/?l=view.version 查看最新版本
  625. * @apiVersion 1.0.0
  626. * @apiName view.version
  627. * @apiGroup Content
  628. *
  629. * @apiDescription 查看最新版本
  630. *
  631. * @apiParam {String} signature signature
  632. *
  633. * @apiSuccess {Object[]} version 版本数据
  634. * @apiSuccess {String} version.name 版本名
  635. * @apiSuccess {String} version.code 版本号
  636. * @apiSuccess {String} version.desc 版本描述
  637. * @apiSuccess {String} version.up 1为强制更新 2为不强制
  638. * @apiSuccess {String} version.link 下载链接
  639. * @apiSuccess {String} version.login 1为强制登录 2为不强制
  640. * @apiSuccess {String} version.anonymous 1为允许匿名登录(uuid) 2为必须手机号登录
  641. * @apiSuccess {String} version.vip 1为显示会员信息,2不显示
  642. * @apiSuccess {String} version.button 1为显示兑换阅读按钮,2不显示
  643. */
  644. /**
  645. * @api {get} wonderful/main/?l=view.vod 查看视频内容
  646. * @apiVersion 1.0.0
  647. * @apiName view.vod
  648. * @apiGroup Content
  649. *
  650. * @apiDescription 查看视频内容
  651. *
  652. * @apiParam {String} signature signature
  653. * @apiParam {Number} id 视频id
  654. *
  655. * @apiSuccess {Object[]} info 视频数据
  656. * @apiSuccess {String} info.id
  657. * @apiSuccess {String} info.name 名称
  658. * @apiSuccess {String} info.pic_cover 4:3图片
  659. * @apiSuccess {String} info.pic_cover_169 16:9图片
  660. * @apiSuccess {String} info.type 类型,参考公共参数中的类型设置说明中的type说明,根据它生成path
  661. * @apiSuccess {String} info.pdate 时间
  662. * @apiSuccess {String} info.cate_id 栏目ID
  663. * @apiSuccess {String} info.cate_name 栏目名称
  664. * @apiSuccess {String} info.author_id 作者ID
  665. * @apiSuccess {String} info.author_name 作者名称
  666. * @apiSuccess {String} info.num_view 浏览量
  667. * @apiSuccess {String} info.num_up 喜欢量
  668. * @apiSuccess {String} info.num_comment 评论量
  669. * @apiSuccess {String} info.share_yes 是否显示分享按钮 1显示 2不显示
  670. * @apiSuccess {String} info.share_title 分享标题
  671. * @apiSuccess {String} info.share_pic 分享图片
  672. * @apiSuccess {String} info.share_content 分享内容
  673. * @apiSuccess {String} info.function 开启的功能,这是一个字符串,用逗号隔开的,1代表显示浏览量,2代表显示评论,3代表显示喜欢,4代表显示邀请阅读,如值为1,2,3,则显示浏览量、评论、喜欢,不显示邀请阅读
  674. * @apiSuccess {String} info.content 内容
  675. *
  676. *
  677. * @apiSuccess {Object[]} comment 评论列表
  678. * @apiSuccess {String} comment.id
  679. * @apiSuccess {String} comment.username 用户名
  680. * @apiSuccess {String} comment.avatar 头像
  681. * @apiSuccess {String} comment.content 内容
  682. * @apiSuccess {String} comment.num_up 点赞数
  683. * @apiSuccess {String} comment.cdate 时间
  684. * @apiSuccess {String} comment.up 是否点赞 1为点赞 2为未点赞
  685. *
  686. * @apiSuccess {Object[]} user_act 用户行为 当用户登录时有效
  687. * @apiSuccess {String} user_act.share 用户分享数
  688. * @apiSuccess {String} user_act.up 是否喜欢1为喜欢,2为未喜欢
  689. */
  690. /**
  691. * @api {get} wonderful/main/?l=view.live 查看直播内容
  692. * @apiVersion 1.0.0
  693. * @apiName view.live
  694. * @apiGroup Content
  695. *
  696. * @apiDescription 查看直播内容
  697. *
  698. * @apiParam {String} signature signature
  699. * @apiParam {Number} id 视频id
  700. *
  701. * @apiSuccess {Object[]} info 直播数据
  702. * @apiSuccess {String} info.id
  703. * @apiSuccess {String} info.name 名称
  704. * @apiSuccess {String} info.pic_cover 4:3封面图片
  705. * @apiSuccess {String} info.pic_cover_169 16:9图片
  706. * @apiSuccess {String} info.type 类型,参考公共参数中的类型设置说明中的type说明,根据它生成path
  707. * @apiSuccess {String} info.pdate 时间
  708. * @apiSuccess {String} info.cate_id 栏目ID
  709. * @apiSuccess {String} info.cate_name 栏目名称
  710. * @apiSuccess {String} info.author_id 作者ID
  711. * @apiSuccess {String} info.author_name 作者名称
  712. * @apiSuccess {String} info.sdate_time 开始时间
  713. * @apiSuccess {String} info.edate_time 结束时间
  714. * @apiSuccess {String} info.num_user 在线人数
  715. * @apiSuccess {String} info.num_view 浏览量
  716. * @apiSuccess {String} info.num_up 喜欢量
  717. * @apiSuccess {String} info.num_comment 评论量
  718. * @apiSuccess {String} info.share_yes 是否显示分享按钮 1显示 2不显示
  719. * @apiSuccess {String} info.share_title 分享标题
  720. * @apiSuccess {String} info.share_pic 分享图片
  721. * @apiSuccess {String} info.share_content 分享内容
  722. * @apiSuccess {String} info.function 开启的功能,这是一个字符串,用逗号隔开的,1代表显示浏览量,2代表显示评论,3代表显示喜欢,4代表显示邀请阅读,如值为1,2,3,则显示浏览量、评论、喜欢,不显示邀请阅读
  723. * @apiSuccess {String} info.content 直播介绍
  724. * @apiSuccess {String} info.stream 直播推流地址
  725. * @apiSuccess {String} info.stream_rtmp 直播高清播放地址
  726. * @apiSuccess {String} info.stream_hls 直播标清播放地址
  727. * @apiSuccess {String} info.stream_hdl 直播普清播放地址
  728. * @apiSuccess {String} info.stream_pic 直播截图地址,直播中时,可以用来替代pic_cover
  729. * @apiSuccess {String} info.url 回放播放地址
  730. * @apiSuccess {String} info.status 直播状态1为未开始2为直播中3为已结束
  731. *
  732. *
  733. * @apiSuccess {Object[]} comment 评论列表
  734. * @apiSuccess {String} comment.id
  735. * @apiSuccess {String} comment.username 用户名
  736. * @apiSuccess {String} comment.avatar 头像
  737. * @apiSuccess {String} comment.content 内容
  738. * @apiSuccess {String} comment.num_up 点赞数
  739. * @apiSuccess {String} comment.time 时间,请用这个时间
  740. * @apiSuccess {String} comment.cdate 时间
  741. * @apiSuccess {String} comment.up 是否点赞 1为点赞 2为未点赞
  742. *
  743. * @apiSuccess {Object[]} user_act 用户行为 当用户登录时有效
  744. * @apiSuccess {String} user_act.share 用户分享数
  745. * @apiSuccess {String} user_act.up 是否喜欢1为喜欢,2为未喜欢
  746. * @apiSuccess {String} user_act.note 是否预约提醒1为已预约,2为未预约
  747. */
  748. /**
  749. * @api {get} wonderful/main/?l=view.getPage 查看单页内容
  750. * @apiVersion 1.0.0
  751. * @apiName view.getPage
  752. * @apiGroup Content
  753. *
  754. * @apiDescription 查看单页内容
  755. *
  756. * @apiParam {String} signature signature
  757. * @apiParam {Number} key 单页key
  758. *
  759. * @apiSuccess {Object[]} info 单页数据
  760. * @apiSuccess {String} info.id
  761. * @apiSuccess {String} info.name 名称
  762. * @apiSuccess {String} info.content 内容
  763. */
  764. /**
  765. * @api {get} wonderful/main/?l=user.poster 获取海报
  766. * @apiVersion 1.0.0
  767. * @apiName user.poster
  768. * @apiGroup UserAction
  769. *
  770. * @apiDescription 获取海报
  771. *
  772. * @apiParam {String} signature signature
  773. * @apiParam {Number} type type类型
  774. * @apiParam {Number} id 当前的数据id
  775. * @apiParam {String} path 首页path路径
  776. *
  777. * @apiSuccess {String} img 海报图片
  778. */
  779. /**
  780. * @api {get} wonderful/main/?l=user.submit_up 喜欢
  781. * @apiVersion 1.0.0
  782. * @apiName user.submit_up
  783. * @apiGroup UserAction
  784. *
  785. * @apiDescription 喜欢
  786. *
  787. * @apiParam {String} signature signature
  788. * @apiParam {Number} type type类型 这里增加了一个评论点赞(喜欢),type的值为11就是 给评论点赞
  789. * @apiParam {Number} id 当前的数据id
  790. *
  791. * @apiSuccess {Number} id 当前的数据id
  792. */
  793. /**
  794. * @api {get} wonderful/main/?l=user.submit_note 直播预约提醒
  795. * @apiVersion 1.0.0
  796. * @apiName user.submit_note
  797. * @apiGroup UserAction
  798. *
  799. * @apiDescription 直播预约提醒
  800. *
  801. * @apiParam {String} signature signature
  802. * @apiParam {Number} type type类型
  803. * @apiParam {Number} id 当前的数据id
  804. *
  805. * @apiSuccess {Number} id 当前的数据id
  806. */
  807. /**
  808. * @api {get} wonderful/main/?l=user.submit_share 分享
  809. * @apiVersion 1.0.0
  810. * @apiName user.submit_share
  811. * @apiGroup UserAction
  812. *
  813. * @apiDescription 分享
  814. *
  815. * @apiParam {String} signature signature
  816. * @apiParam {Number} type type类型
  817. * @apiParam {Number} id 当前的数据id
  818. * @apiParam {String} desc 说明:这是分享的说明介绍,请不要传入该参数,底层页分享时,请把路径path设置为首页的path?scene=signature,type,id signature:当前邀请者的signature | type:当前分享的类型 图文等 | id:当前分享的图文的id,小程序中请判断,如果首页有scene参数,请在正常请求首页数据之后,将这几个数据保存到本地,(这里不要发起分享回流接口的请求,请在用户授权用户信息或者授权手机号之后再发起分享回流的接口请求,发起请求之后,请从本地删除这几个数据),然后根据scene参数中的type和id的值,跳转到type所对应的path的详情页即可。
  819. *
  820. * @apiSuccess {Number} id 当前的数据id
  821. */
  822. /**
  823. * @api {get} wonderful/main/?l=user.submit_share_reflux 分享回流
  824. * @apiVersion 1.0.0
  825. * @apiName user.submit_share_reflux
  826. * @apiGroup UserAction
  827. *
  828. * @apiDescription 分享回流
  829. *
  830. * @apiParam {String} signature signature
  831. * @apiParam {Number} type type类型 scene参数中的第二个值
  832. * @apiParam {Number} id 当前的数据id scene参数中的第三个值
  833. * @apiParam {String} source_signature 回流的源用户id,scene参数中的第一个值
  834. *
  835. * @apiSuccess {Number} id 当前的数据id
  836. */
  837. /**
  838. * @api {get} wonderful/main/?l=user.submit_comment 提交评论
  839. * @apiVersion 1.0.0
  840. * @apiName user.submit_comment
  841. * @apiGroup UserAction
  842. *
  843. * @apiDescription 提交评论
  844. *
  845. * @apiParam {String} signature signature
  846. * @apiParam {Number} type type类型
  847. * @apiParam {Number} id 当前的数据id
  848. * @apiParam {String} content 评论内容
  849. *
  850. * @apiSuccess {Number} id 当前的数据id
  851. */
  852. /**
  853. * @api {get} wonderful/main/?l=user.submit_feedback 提交反馈
  854. * @apiVersion 1.0.0
  855. * @apiName user.submit_feedback
  856. * @apiGroup UserAction
  857. *
  858. * @apiDescription 提交反馈
  859. *
  860. * @apiParam {String} signature signature
  861. * @apiParam {String} type_id 反馈类型 必填
  862. * @apiParam {String} contact 联系方式 必填
  863. * @apiParam {String} content 反馈内容 必填
  864. *
  865. * @apiSuccess {Number} id 当前的数据id
  866. */
  867. /**
  868. * @api {get} wonderful/main/?l=user.get_feedback_type 获取反馈类型
  869. * @apiVersion 1.0.0
  870. * @apiName user.get_feedback_type
  871. * @apiGroup UserAction
  872. *
  873. * @apiDescription 获取反馈类型
  874. *
  875. * @apiParam {String} signature signature
  876. *
  877. * @apiSuccess {Object} type 类型
  878. */
  879. /**
  880. * @api {get} wonderful/main/?l=journal.home 小刊首页
  881. * @apiVersion 1.0.0
  882. * @apiName journal.home
  883. * @apiGroup Journal
  884. *
  885. * @apiDescription 小刊首页
  886. *
  887. * @apiParam {String} signature signature
  888. * @apiParam {String} system 分类id
  889. *
  890. * @apiSuccess {Object[]} journal 小刊数据列表,每页显示10条,请在翻到第7或者第8条时,请求第2页
  891. * @apiSuccess {String} journal.id 小刊id
  892. * @apiSuccess {String} journal.name 名称
  893. * @apiSuccess {String} journal.subname 期号
  894. * @apiSuccess {String} journal.pic_cover 列表封面图片 暂时无效
  895. * @apiSuccess {String} journal.pic_view_cover 小刊封面图片 封面图都用这个
  896. * @apiSuccess {String} journal.pic_view_bg 全屏背景图,多张图片,这是一个数组
  897. * @apiSuccess {String} journal.pic_gd 小刊推广图
  898. * @apiSuccess {String} journal.pdate 时间
  899. * @apiSuccess {String} journal.num_ding 订阅数
  900. * @apiSuccess {String} journal.num_view 浏览量
  901. * @apiSuccess {String} journal.num_comment 评论量
  902. * @apiSuccess {String} journal.buy 小刊是否收费 1收费 2免费 3会员
  903. * @apiSuccess {String} journal.bgmusic 小刊背景音乐
  904. *
  905. * @apiSuccess {Object[]} subscribe 订阅列表
  906. * @apiSuccess {String} subscribe.id
  907. * @apiSuccess {String} subscribe.username 用户名
  908. * @apiSuccess {String} subscribe.avatar 头像
  909. * @apiSuccess {Object[]} push_jingxuan 精选推荐
  910. * @apiSuccess {String} push_jingxuan.name 名称
  911. * @apiSuccess {String} push_jingxuan.pic 图片
  912. * @apiSuccess {String} push_jingxuan.type 类型,这里为4
  913. * @apiSuccess {String} push_jingxuan.id 源表id,这里是小刊的id
  914. * @apiSuccess {String} push_jingxuan.cdate 时间
  915. * @apiSuccess {Number} push_jingxuan_more 是否显示更多按钮1显示2不显示
  916. */
  917. /**
  918. * @api {get} wonderful/main/?l=journal.getList 小刊列表
  919. * @apiVersion 1.0.0
  920. * @apiName journal.getList
  921. * @apiGroup Journal
  922. *
  923. * @apiDescription 小刊列表,按照分类读取
  924. *
  925. * @apiParam {String} signature signature
  926. * @apiParam {String} system 分类id,默认为1,传入-1就是获取全部
  927. *
  928. * @apiSuccess {Object[]} journal 小刊数据列表
  929. * @apiSuccess {String} journal.id 小刊id
  930. * @apiSuccess {String} journal.name 名称
  931. * @apiSuccess {String} journal.subname 期号
  932. * @apiSuccess {String} journal.pic_cover 列表封面图片 暂时无效
  933. * @apiSuccess {String} journal.pic_view_cover 小刊封面图片 封面图都用这个
  934. * @apiSuccess {String} journal.pic_view_bg 全屏背景图,多张图片,这是一个数组
  935. * @apiSuccess {String} journal.pic_gd 小刊推广图
  936. * @apiSuccess {String} journal.pdate 时间
  937. * @apiSuccess {String} journal.num_ding 订阅数
  938. * @apiSuccess {String} journal.num_view 浏览量
  939. * @apiSuccess {String} journal.num_comment 评论量
  940. * @apiSuccess {String} journal.buy 小刊是否收费 1收费 2免费 3会员
  941. * @apiSuccess {String} journal.bgmusic 小刊背景音乐
  942. *
  943. * @apiSuccess {Object[]} push 主推小刊
  944. * @apiSuccess {String} push.id 小刊id
  945. * @apiSuccess {String} push.name 名称
  946. * @apiSuccess {String} push.num_ding 订阅数
  947. * @apiSuccess {Object[]} cate 当前分类
  948. * @apiSuccess {String} cate.id 分类id
  949. * @apiSuccess {String} cate.name 名称
  950. * @apiSuccess {Object[]} cateList 分类列表
  951. * @apiSuccess {String} cateList.id 分类id
  952. * @apiSuccess {String} cateList.name 名称
  953. */
  954. /**
  955. * @api {get} wonderful/main/?l=journal.getMyList 我的小刊列表
  956. * @apiVersion 1.0.0
  957. * @apiName journal.getMyList
  958. * @apiGroup Journal
  959. *
  960. * @apiDescription 我的小刊列表,按照分类读取
  961. *
  962. * @apiParam {String} signature signature
  963. * @apiParam {String} system 分类id
  964. *
  965. * @apiSuccess {Object[]} user 用户基本信息
  966. * @apiSuccess {String} user.id 用户id
  967. * @apiSuccess {String} user.username 用户名
  968. * @apiSuccess {String} user.avatar 头像
  969. *
  970. * @apiSuccess {Object[]} journal 小刊数据列表
  971. * @apiSuccess {String} journal.id 小刊id
  972. * @apiSuccess {String} journal.name 名称
  973. * @apiSuccess {String} journal.subname 期号
  974. * @apiSuccess {String} journal.pic_cover 列表封面图片 暂时无效
  975. * @apiSuccess {String} journal.pic_view_cover 小刊封面图片 封面图都用这个
  976. * @apiSuccess {String} journal.pic_view_bg 全屏背景图,多张图片,这是一个数组
  977. * @apiSuccess {String} journal.pic_gd 小刊推广图
  978. * @apiSuccess {String} journal.pdate 时间
  979. * @apiSuccess {String} journal.num_ding 订阅数
  980. * @apiSuccess {String} journal.num_view 浏览量
  981. * @apiSuccess {String} journal.num_comment 评论量
  982. * @apiSuccess {String} journal.buy 小刊是否收费 1收费 2免费 3会员
  983. * @apiSuccess {String} journal.bgmusic 小刊背景音乐
  984. *
  985. * @apiSuccess {Object[]} push 主推小刊
  986. * @apiSuccess {String} push.id 小刊id
  987. * @apiSuccess {String} push.name 名称
  988. * @apiSuccess {String} push.num_ding 订阅数
  989. */
  990. /**
  991. * @api {get} wonderful/main/?l=journal.jingxuan 小刊精选更多
  992. * @apiVersion 1.0.0
  993. * @apiName journal.jingxuan
  994. * @apiGroup Journal
  995. *
  996. * @apiDescription 小刊精选更多
  997. *
  998. * @apiParam {String} signature signature
  999. * @apiSuccess {Object[]} push_jingxuan 精选推荐,这里可以按照page.next_page来获取下一页,无限循环
  1000. * @apiSuccess {String} push_jingxuan.name 名称
  1001. * @apiSuccess {String} push_jingxuan.pic 图片
  1002. * @apiSuccess {String} push_jingxuan.type 类型,这里为4
  1003. * @apiSuccess {String} push_jingxuan.id 源表id,这里是小刊的id
  1004. * @apiSuccess {String} push_jingxuan.cdate 时间
  1005. */
  1006. /**
  1007. * @api {get} wonderful/main/?l=journal.read 小刊阅读页
  1008. * @apiVersion 1.0.0
  1009. * @apiName journal.read
  1010. * @apiGroup Journal
  1011. *
  1012. * @apiDescription 小刊阅读页
  1013. *
  1014. * @apiParam {String} signature signature
  1015. * @apiParam {Number} id 小刊id
  1016. *
  1017. * @apiSuccess {Object[]} content 内容数据列表,每页显示10条,请在翻到第7或者第8条时,请求第2页
  1018. * @apiSuccess {String} content.id 内容id
  1019. * @apiSuccess {String} content.type 内容类型1全屏图、2长图、3图文内容、11关联图文、12关联视频、13关联直播、4全屏视频、5留言视频、6留言音频|||新增:7长屏图、8横屏图、9无边框图片、10四宫格图片、21对话模板
  1020. * @apiSuccess {String} content.name 标题。type=5,6时有效
  1021. * @apiSuccess {String} content.cover 音频或者视频的封面图,type=4,5,6时有效
  1022. * @apiSuccess {String} content.video 视频地址。type=4,5时有效
  1023. * @apiSuccess {String} content.music 音频地址。type=6时有效
  1024. * @apiSuccess {String} content.pic 全屏图或者长图,type=1,2,7,8,9时有效
  1025. * @apiSuccess {String} content.pic_info 全屏图或者长图的图片信息,type=1,2,7,8,9时有效,值如1024_768_548.12_35,请用_分隔成数组使用,1024为宽度,768为高度,548.12为图片大小,35为图片id
  1026. * @apiSuccess {String} content.is_button 全屏图上的保存按钮,1显示2不显示,type=1时有效
  1027. * @apiSuccess {String} content.button_name 全屏图上的保存按钮的文字,type=1时有效
  1028. * @apiSuccess {String} content.button_color 全屏图上的保存按钮的文字颜色,type=1时有效
  1029. * @apiSuccess {String} content.note 是否预约提醒1为已预约,2为未预约
  1030. * @apiSuccess {Object[]} content.text 全屏图上的九个文字位置,type=1时有效
  1031. * @apiSuccess {String} content.text.text 文字位置,1上左2上中3上右4中左5正中6中右7下左8下中9下右
  1032. * @apiSuccess {String} content.text.name 文字内容 换行用\n隔开
  1033. * @apiSuccess {String} content.text.color 文字颜色
  1034. * @apiSuccess {String} content.text.bgcolor 文字背景颜色
  1035. * @apiSuccess {String} content.text.bgcolor_type 是否设置文字背景颜色,1设置,2不设置,不设置则文字背景颜色为透明。
  1036. * @apiSuccess {String} content.text.size 文字像素大小
  1037. * @apiSuccess {Object[]} content.info type=3,11,12,13时有效,当等于11,12,13时,分别对应图文详情、视频详情、直播详情里的字段,等于3时,请查看以下字段
  1038. * @apiSuccess {String} content.info.name 标题
  1039. * @apiSuccess {String} content.info.focus 焦点图
  1040. * @apiSuccess {String} content.info.content 内容
  1041. * @apiSuccess {String} content.info.content_array 数组内容
  1042. * @apiSuccess {Object[]} content.info.author 作者
  1043. * @apiSuccess {Object[]} content.palaces 四宫格图片的四个图片,type=10时有效
  1044. * @apiSuccess {String} content.palaces.palaces 图片位置,1上左2上右3下左4下右
  1045. * @apiSuccess {String} content.palaces.pic 图片
  1046. * @apiSuccess {String} content.talk_pic 对话模板的置顶图片,为空则不显示,type=21时有效
  1047. * @apiSuccess {Object[]} content.talk 对话模板里的对话内容,type=21时有效
  1048. * @apiSuccess {String} content.talk.talk_location 对话位置,1左2右
  1049. * @apiSuccess {String} content.talk.talk_type 对话类型,1文字,2图片,3音频
  1050. * @apiSuccess {String} content.talk.avatar 头像
  1051. * @apiSuccess {String} content.talk.text 文字
  1052. * @apiSuccess {String} content.talk.pic 图片
  1053. * @apiSuccess {String} content.talk.audio 音频
  1054. */
  1055. /**
  1056. * @api {get} wonderful/main/?l=journal.view 小刊详情页(旧版本)
  1057. * @apiVersion 1.0.0
  1058. * @apiName journal.view
  1059. * @apiGroup Journal
  1060. *
  1061. * @apiDescription 小刊详情页
  1062. *
  1063. * @apiParam {String} signature signature
  1064. * @apiParam {Number} id 小刊id
  1065. *
  1066. * @apiSuccess {Object[]} info 小刊详情
  1067. * @apiSuccess {String} info.id 小刊id
  1068. * @apiSuccess {String} info.name 名称
  1069. * @apiSuccess {String} journal.subname 期号
  1070. * @apiSuccess {String} info.pic_cover 列表封面图片 暂时无效
  1071. * @apiSuccess {String} info.pic_view_cover 小刊封面图片 封面图都用这个
  1072. * @apiSuccess {String} info.pic_view_bg 全屏背景图,多张图片,这是一个数组
  1073. * @apiSuccess {String} info.pic_gd 小刊推广图
  1074. * @apiSuccess {String} info.pdate 时间
  1075. * @apiSuccess {String} info.num_ding 订阅数
  1076. * @apiSuccess {String} info.num_view 浏览量
  1077. * @apiSuccess {String} info.num_comment 评论量
  1078. * @apiSuccess {String} info.buy 小刊是否收费 1收费 2不收费
  1079. * @apiSuccess {String} info.subscribe 是否订阅,1为已订阅2为未订阅
  1080. * @apiSuccess {String} info.active 是否有活动,1为有2为没有,有则显示分享邀请按钮
  1081. * @apiSuccess {Object[]} button 按钮判断 如果不需要这个,可以不用
  1082. * @apiSuccess {Object[]} button.read 第一个按钮 一般为购买按钮
  1083. * @apiSuccess {String} button.read.status 状态 -1不显示 1为进入阅读 2为购买
  1084. * @apiSuccess {String} button.read.name 按钮上的名字
  1085. * @apiSuccess {Object[]} button.code 第二个按钮 一般为兑换码按钮
  1086. * @apiSuccess {String} button.code.status 状态 -1不显示 1为兑换码兑换 2为购买(再次购买)
  1087. * @apiSuccess {String} button.code.name 按钮上的名字
  1088. * @apiSuccess {Object[]} button.share 第三个按钮 一般为分享邀请按钮
  1089. * @apiSuccess {String} button.share.status 状态 -1不显示 1为免费阅读赢取大礼包
  1090. * @apiSuccess {String} button.share.name 按钮上的名字
  1091. */
  1092. /**
  1093. * @api {get} wonderful/main/?l=journal.view_v1 小刊详情页(新版本)
  1094. * @apiVersion 1.0.0
  1095. * @apiName journal.view_v1
  1096. * @apiGroup Journal
  1097. *
  1098. * @apiDescription 小刊详情页(新版本)
  1099. *
  1100. * @apiParam {String} signature signature
  1101. * @apiParam {Number} id 小刊id
  1102. *
  1103. * @apiSuccess {Object[]} info 小刊详情
  1104. * @apiSuccess {String} info.id 小刊id
  1105. * @apiSuccess {String} info.name 名称
  1106. * @apiSuccess {String} journal.subname 期号
  1107. * @apiSuccess {String} info.pic_cover 列表封面图片 暂时无效
  1108. * @apiSuccess {String} info.pic_view_cover 小刊封面图片 封面图都用这个
  1109. * @apiSuccess {String} info.pic_view_bg 全屏背景图,多张图片,这是一个数组
  1110. * @apiSuccess {String} info.pic_gd 小刊推广图
  1111. * @apiSuccess {String} info.pdate 时间
  1112. * @apiSuccess {String} info.num_ding 订阅数
  1113. * @apiSuccess {String} info.num_view 浏览量
  1114. * @apiSuccess {String} info.num_comment 评论量
  1115. * @apiSuccess {String} info.buy 小刊是否收费 1收费 2不收费
  1116. * @apiSuccess {String} info.subscribe 是否订阅,1为已订阅2为未订阅
  1117. * @apiSuccess {String} info.active 是否有活动,1为有2为没有,有则显示分享邀请按钮
  1118. * @apiSuccess {String} info.vip 是否是会员,1是会员2不是,有则显示阅读按钮
  1119. * @apiSuccess {Object[]} button 按钮判断 如果不需要这个,可以不用
  1120. * @apiSuccess {Object[]} button.read 第一个按钮 阅读按钮
  1121. * @apiSuccess {String} button.read.status 状态 -1不显示按钮 1显示按钮
  1122. * @apiSuccess {String} button.read.name 按钮上的名字
  1123. * @apiSuccess {Object[]} button.buy 第二个按钮 购买按钮
  1124. * @apiSuccess {String} button.buy.status 状态 -1不显示按钮 1显示按钮
  1125. * @apiSuccess {String} button.buy.name 按钮上的名字
  1126. * @apiSuccess {Object[]} button.code 第三个按钮 兑换码按钮
  1127. * @apiSuccess {String} button.code.status 状态 -1不显示按钮 1显示按钮
  1128. * @apiSuccess {String} button.code.name 按钮上的名字
  1129. * @apiSuccess {Object[]} button.share 第四个按钮 分享邀请按钮
  1130. * @apiSuccess {String} button.share.status 状态 -1不显示按钮 1显示按钮
  1131. * @apiSuccess {String} button.share.name 按钮上的名字
  1132. */
  1133. /**
  1134. * @api {get} wonderful/main/?l=journal.active 小刊活动页
  1135. * @apiVersion 1.0.0
  1136. * @apiName journal.active
  1137. * @apiGroup Journal
  1138. *
  1139. * @apiDescription 小刊活动页
  1140. *
  1141. * @apiParam {String} signature signature
  1142. * @apiParam {Number} id 小刊id
  1143. *
  1144. * @apiSuccess {Object[]} info 小刊详情
  1145. * @apiSuccess {String} info.id 小刊id
  1146. * @apiSuccess {String} info.name 名称
  1147. *
  1148. * @apiSuccess {Object[]} active 活动说明表
  1149. * @apiSuccess {String} active.name 名称
  1150. * @apiSuccess {String} active.status 活动状态 1活动进行中 2活动已结束
  1151. * @apiSuccess {String} active.desc 描述
  1152. * @apiSuccess {String} active.buy_title 购买标题
  1153. * @apiSuccess {String} active.buy_desc 购买描述
  1154. * @apiSuccess {String} active.invite_title 邀请好友标题
  1155. * @apiSuccess {String} active.invite_desc 邀请好友描述 换行用\n隔开
  1156. * @apiSuccess {String} active.content 活动说明,富文本
  1157. * @apiSuccess {Object[]} invite 我的邀请
  1158. * @apiSuccess {String} invite.uid 用户id
  1159. * @apiSuccess {String} invite.username 用户名
  1160. * @apiSuccess {String} invite.avatar 头像
  1161. * @apiSuccess {String} buy 是否显示购买按钮,1显示,2不显示
  1162. */
  1163. /**
  1164. * @api {get} wonderful/main/?l=journal.buy 小刊购买页
  1165. * @apiVersion 1.0.0
  1166. * @apiName journal.buy
  1167. * @apiGroup Journal
  1168. *
  1169. * @apiDescription 小刊购买页
  1170. *
  1171. * @apiParam {String} signature signature
  1172. * @apiParam {Number} id 小刊id
  1173. *
  1174. * @apiSuccess {Object[]} info 小刊详情
  1175. * @apiSuccess {String} info.id 小刊id
  1176. * @apiSuccess {String} info.name 名称
  1177. *
  1178. * @apiSuccess {String} buy_desc 购买说明
  1179. * @apiSuccess {Object[]} buy_list 购买列表
  1180. * @apiSuccess {String} buy_list.id 购买id 支付时使用
  1181. * @apiSuccess {String} buy_list.name 名称
  1182. * @apiSuccess {String} buy_list.price 标价
  1183. * @apiSuccess {String} buy_list.cash 实际支付价格
  1184. */
  1185. /**
  1186. * @api {get} wonderful/main/?l=journal.buy_action 发起支付
  1187. * @apiVersion 1.0.0
  1188. * @apiName journal.buy_action
  1189. * @apiGroup Journal
  1190. *
  1191. * @apiDescription 发起支付:请注意,如果是苹果支付,请在发起苹果支付之后,将苹果返回的验证数据,传入该接口
  1192. *
  1193. * @apiParam {String} signature signature
  1194. * @apiParam {String} journal_id 小刊id
  1195. * @apiParam {String} buy_id 购买本数id
  1196. * @apiParam {String} receipt 当header中的source_type为ios时,请传入该参数,参数的值为苹果支付后返回的参数,即可发起支付验证。
  1197. *
  1198. * @apiSuccess {Object[]} pay 微信支付返回的数据
  1199. * @apiSuccess {String} pay.time 服务器时间戳
  1200. * @apiSuccess {String} pay.nonce_str 随机字符串
  1201. * @apiSuccess {String} pay.prepay_id 统一下单接口返回的 prepay_id 参数值,通过'prepay_id=' + prepay_id 拼装成package
  1202. * @apiSuccess {String} pay.sign_type 签名算法
  1203. * @apiSuccess {String} pay.sign 签名
  1204. * @apiSuccess {String} pay.yes 苹果支付时显示改参数,1为支付成功2为支付失败
  1205. */
  1206. /**
  1207. * @api {get} wonderful/main/?l=journal.code 提交兑换码
  1208. * @apiVersion 1.0.0
  1209. * @apiName journal.code
  1210. * @apiGroup Journal
  1211. * @apiDescription 提交兑换码
  1212. *
  1213. * @apiParam {String} signature signature
  1214. * @apiParam {String} journal_id 小刊id
  1215. * @apiParam {String} code 兑换码
  1216. *
  1217. * @apiSuccess {String} order_id 兑换成功则返回订单id
  1218. */
  1219. /**
  1220. * @api {get} wonderful/main/?l=journal.checkCode 验证兑换码是否有效
  1221. * @apiVersion 1.0.0
  1222. * @apiName journal.checkCode
  1223. * @apiGroup Journal
  1224. *
  1225. * @apiDescription 验证兑换码是否有效
  1226. *
  1227. * @apiParam {String} signature signature
  1228. * @apiParam {String} code 兑换码
  1229. * @apiSuccess {Object[]} product 小刊信息
  1230. * @apiSuccess {String} product.id 小刊id
  1231. * @apiSuccess {String} product.name 小刊名称
  1232. */
  1233. /**
  1234. * @api {get} wonderful/main/?l=journal.score 小刊积分排行榜
  1235. * @apiVersion 1.0.0
  1236. * @apiName journal.score
  1237. * @apiGroup Journal
  1238. *
  1239. * @apiDescription 小刊积分排行榜
  1240. *
  1241. * @apiParam {String} signature signature
  1242. * @apiParam {Number} id 小刊id
  1243. *
  1244. * @apiSuccess {Object[]} info 小刊详情
  1245. * @apiSuccess {String} info.id 小刊id
  1246. * @apiSuccess {String} info.name 名称
  1247. *
  1248. * @apiSuccess {Object[]} score 积分排行
  1249. * @apiSuccess {String} score.uid 用户id
  1250. * @apiSuccess {String} score.score 积分数
  1251. * @apiSuccess {String} score.username 用户名
  1252. * @apiSuccess {String} score.avatar 头像
  1253. * @apiSuccess {Object[]} my 我的积分排行
  1254. * @apiSuccess {String} my.uid 用户id
  1255. * @apiSuccess {String} my.score 积分数
  1256. * @apiSuccess {String} my.username 用户名
  1257. * @apiSuccess {String} my.avatar 头像
  1258. * @apiSuccess {String} my.pai 我的排行
  1259. *
  1260. * @apiSuccess {Object[]} active 活动说明表
  1261. * @apiSuccess {String} active.name 名称
  1262. * @apiSuccess {String} active.status 活动状态 1活动进行中 2活动已结束
  1263. * @apiSuccess {String} active.desc 描述
  1264. * @apiSuccess {String} active.invite_title 邀请好友标题
  1265. * @apiSuccess {String} active.invite_desc 邀请好友描述 换行用\n隔开
  1266. * @apiSuccess {String} active.content 活动说明,富文本
  1267. */
  1268. /**
  1269. * @api {get} wonderful/main/?l=journal.invite 小刊我的邀请排行榜
  1270. * @apiVersion 1.0.0
  1271. * @apiName journal.invite
  1272. * @apiGroup Journal
  1273. *
  1274. * @apiDescription 小刊邀请排行榜
  1275. *
  1276. * @apiParam {String} signature signature
  1277. * @apiParam {Number} id 小刊id
  1278. *
  1279. * @apiSuccess {Object[]} info 小刊详情
  1280. * @apiSuccess {String} info.id 小刊id
  1281. * @apiSuccess {String} info.name 名称
  1282. *
  1283. * @apiSuccess {Object[]} invite 邀请排行
  1284. * @apiSuccess {String} invite.uid 用户id
  1285. * @apiSuccess {String} invite.username 用户名
  1286. * @apiSuccess {String} invite.avatar 头像
  1287. */
  1288. /**
  1289. * @api {get} wonderful/main/?l=user.my 获取用户信息
  1290. * @apiVersion 1.0.0
  1291. * @apiName user.my
  1292. * @apiGroup User
  1293. *
  1294. * @apiDescription 获取用户信息
  1295. *
  1296. * @apiParam {String} signature signature
  1297. *
  1298. * @apiSuccess {Object[]} user 用户基本信息
  1299. * @apiSuccess {String} user.id 用户id
  1300. * @apiSuccess {String} user.username 用户名
  1301. * @apiSuccess {String} user.mobile 手机号
  1302. * @apiSuccess {String} user.avatar 头像
  1303. * @apiSuccess {String} user.level 等级
  1304. * @apiSuccess {String} user.score 积分
  1305. * @apiSuccess {String} user.vip_type 会员状态,-1为未开通,-2为已过期,大于0则为正式会员的过期时间戳
  1306. * @apiSuccess {String} user.vip_end 当vip_type>0时存在,正式会员的过期时间
  1307. * @apiSuccess {String} user.vip_state vip_state=1则显示购买按钮,=2则不显示
  1308. * @apiSuccess {Number} user_msg 用户新消息数
  1309. */
  1310. /**
  1311. * @api {get} wonderful/main/?l=user.my_msg 获取我的消息
  1312. * @apiVersion 1.0.0
  1313. * @apiName user.my_msg
  1314. * @apiGroup User
  1315. *
  1316. * @apiDescription 获取我的消息
  1317. *
  1318. * @apiParam {String} signature signature
  1319. *
  1320. * @apiSuccess {Object[]} msg 消息列表
  1321. * @apiSuccess {String} msg.uid 用户id
  1322. * @apiSuccess {String} msg.from_uid 消息来源uid,暂时不用管
  1323. * @apiSuccess {String} msg.name 消息标题
  1324. * @apiSuccess {String} msg.content 消息内容
  1325. * @apiSuccess {String} msg.cdate 时间戳
  1326. * @apiSuccess {String} msg.cdate_time 转换成了Y-m-d H:i:s的时间
  1327. * @apiSuccess {String} msg.status 消息已读状态1未读2已读
  1328. * @apiSuccess {String} msg.type 消息类型,暂时不用管,目前都为11
  1329. * @apiSuccess {String} msg.param 消息传入参数,这是一个数组:name消息名称,type是上述公共参数所定义的类型,id是底层页id,link是链接地址,有则跳转到该地址
  1330. */
  1331. /**
  1332. * @api {get} wonderful/main/?l=user.my_up 获取我喜欢的信息
  1333. * @apiVersion 1.0.0
  1334. * @apiName user.my_up
  1335. * @apiGroup User
  1336. *
  1337. * @apiDescription 获取我喜欢的信息
  1338. *
  1339. * @apiParam {String} signature signature
  1340. *
  1341. * @apiSuccess {Object[]} like 用户基本信息
  1342. * @apiSuccess {String} like.uid 用户id
  1343. * @apiSuccess {String} like.data_id 数据id
  1344. * @apiSuccess {String} like.cdate 时间戳
  1345. * @apiSuccess {String} like.cdate_time 转换成了Y-m-d H:i:s的时间
  1346. * @apiSuccess {String} like.type 类型,参考公共参数中的类型设置说明中的type说明
  1347. * @apiSuccess {Object[]} like.info 基本信息 根据type不同,里面的字段有所不同
  1348. * @apiSuccess {String} like.info.id 数据id
  1349. * @apiSuccess {String} like.info.name 名称
  1350. * @apiSuccess {String} like.info.cate_id 栏目ID
  1351. * @apiSuccess {String} like.info.cate_name 栏目名称
  1352. * @apiSuccess {String} like.info.pic_cover 4:3图片
  1353. * @apiSuccess {String} like.info.pic_cover_169 16:9图片
  1354. * @apiSuccess {String} like.info.pdate 发布时间
  1355. */
  1356. /**
  1357. * @api {get} wonderful/main/?l=user.my_comment 获取我评论的信息
  1358. * @apiVersion 1.0.0
  1359. * @apiName user.my_comment
  1360. * @apiGroup User
  1361. *
  1362. * @apiDescription 获取我喜欢的信息
  1363. *
  1364. * @apiParam {String} signature signature
  1365. *
  1366. * @apiSuccess {Object[]} comment 用户基本信息
  1367. * @apiSuccess {String} comment.uid 用户id
  1368. * @apiSuccess {String} comment.data_id 数据id
  1369. * @apiSuccess {String} comment.content 评论内容
  1370. * @apiSuccess {String} comment.time 时间:x小时前
  1371. * @apiSuccess {String} comment.cdate 时间戳
  1372. * @apiSuccess {String} comment.cdate_time 转换成了Y-m-d H:i:s的时间
  1373. * @apiSuccess {String} comment.type 类型,参考公共参数中的类型设置说明中的type说明
  1374. * @apiSuccess {Object[]} comment.info 基本信息 根据type不同,里面的字段有所不同
  1375. * @apiSuccess {String} comment.info.id 数据id
  1376. * @apiSuccess {String} comment.info.name 名称
  1377. * @apiSuccess {String} comment.info.cate_id 栏目ID
  1378. * @apiSuccess {String} comment.info.cate_name 栏目名称
  1379. * @apiSuccess {String} comment.info.pic_cover 4:3图片
  1380. * @apiSuccess {String} comment.info.pic_cover_169 16:9图片
  1381. * @apiSuccess {String} comment.info.pdate 发布时间
  1382. */