apidoc.php 60 KB

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