apidoc_v1.php 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478
  1. <?php
  2. /**
  3. * @api {get} wonderful/passport/?l=applet.login 用户登录
  4. * @apiVersion 2.0.0
  5. * @apiName applet.login
  6. * @apiGroup AppletPassportV1
  7. *
  8. * @apiDescription 用户登录
  9. *
  10. * @apiParam {String} code 微信登录返回的code
  11. * @apiParam {String} nickname 用户昵称
  12. * @apiParam {String} avatarurl 用户头像
  13. * @apiParam {String} gender 性别
  14. * @apiParam {String} city 城市
  15. * @apiParam {String} province 省份
  16. * @apiParam {String} country 县区
  17. * @apiParam {String} iv 微信的加密参数
  18. * @apiParam {String} encryptedData 微信的加密参数
  19. *
  20. * @apiSuccess {Number} vid 微信id,请保存在本地
  21. * @apiSuccess {Number} uid 用户id,请保存在本地
  22. * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地
  23. */
  24. /**
  25. * @api {get} wonderful/main/?l=journal_v1.getList 小程序小刊列表
  26. * @apiVersion 2.0.0
  27. * @apiName journal.getList
  28. * @apiGroup JournalV1
  29. *
  30. * @apiDescription 小刊列表,按照分类读取,根据获取的信息,可以直接进入到小刊详情页,无需再次请求接口。
  31. *
  32. * @apiParam {String} signature signature
  33. * @apiParam {String} system 分类id,默认为1,传入-1就是获取全部
  34. *
  35. * @apiSuccess {Object[]} journal 小刊数据列表
  36. * @apiSuccess {String} journal.id 小刊id
  37. * @apiSuccess {String} journal.name 名称
  38. * @apiSuccess {String} journal.subname 期号
  39. * @apiSuccess {String} journal.pic_cover 列表封面图片 暂时无效
  40. * @apiSuccess {String} journal.pic_view_cover 小刊封面图片 封面图都用这个
  41. * @apiSuccess {String} journal.pic_view_bg 全屏背景图,多张图片,这是一个数组
  42. * @apiSuccess {String} journal.pic_gd 小刊推广图
  43. * @apiSuccess {String} journal.pdate 时间
  44. * @apiSuccess {String} journal.num_ding 订阅数
  45. * @apiSuccess {String} journal.buy 小刊是否收费 1收费 2免费 3会员
  46. * @apiSuccess {String} journal.h5 h5地址
  47. * @apiSuccess {String} journal.buy_type 购买类型,1是普通支付,2是按照明星支付
  48. * @apiSuccess {String} journal.bgmusic 小刊背景音乐
  49. * @apiSuccess {Object[]} journal.button 按钮判断 如果不需要这个,可以不用
  50. * @apiSuccess {Object[]} journal.button.read 第一个按钮 阅读按钮
  51. * @apiSuccess {String} journal.button.read.status 状态 -1不显示 1为进入阅读 2为兑换 3为预售,注意,当值为2时,必须在阅读按钮上,当用户点击按钮时,绑定一个事件,该事件的接口为journal_v1.subscribe
  52. * @apiSuccess {String} journal.button.read.name 按钮上的名字
  53. * @apiSuccess {Object[]} journal.button.buy 第二个按钮 购买按钮
  54. * @apiSuccess {String} journal.button.buy.status 状态 -1不显示 1为购买
  55. * @apiSuccess {String} journal.button.buy.name 按钮上的名字
  56. * @apiSuccess {Object[]} journal.button.share 第三个按钮 排行榜按钮
  57. * @apiSuccess {String} journal.button.share.status 状态 -1不显示 1为排行榜
  58. * @apiSuccess {String} journal.button.share.name 按钮上的名字
  59. *
  60. * @apiSuccess {Object[]} push 主推小刊
  61. * @apiSuccess {String} push.id 小刊id
  62. * @apiSuccess {String} push.name 名称
  63. * @apiSuccess {String} push.num_ding 订阅数
  64. * @apiSuccess {Object[]} cate 当前分类
  65. * @apiSuccess {String} cate.id 分类id
  66. * @apiSuccess {String} cate.name 名称
  67. */
  68. /**
  69. * @api {get} wonderful/main/?l=journal_v1.getAppList APP小刊列表
  70. * @apiVersion 2.0.0
  71. * @apiName journal.getAppList
  72. * @apiGroup JournalV1
  73. *
  74. * @apiDescription 小刊列表,按照分类读取,根据获取的信息,可以直接进入到小刊详情页,无需再次请求接口。
  75. *
  76. * @apiParam {String} signature signature
  77. * @apiParam {String} system 分类id,默认为1,传入-1就是获取全部
  78. *
  79. * @apiSuccess {Object[]} journal 小刊数据列表
  80. * @apiSuccess {String} journal.id 小刊id
  81. * @apiSuccess {String} journal.name 名称
  82. * @apiSuccess {String} journal.subname 期号
  83. * @apiSuccess {String} journal.pic_cover 列表封面图片 暂时无效
  84. * @apiSuccess {String} journal.pic_view_cover 小刊封面图片 封面图都用这个
  85. * @apiSuccess {String} journal.pic_view_bg 全屏背景图,多张图片,这是一个数组
  86. * @apiSuccess {String} journal.pic_gd 小刊推广图
  87. * @apiSuccess {String} journal.pdate 时间
  88. * @apiSuccess {String} journal.num_ding 订阅数
  89. * @apiSuccess {String} journal.buy 小刊是否收费 1收费 2免费 3会员
  90. * @apiSuccess {String} journal.bgmusic 小刊背景音乐
  91. * @apiSuccess {Object[]} journal.button 按钮判断 如果不需要这个,可以不用
  92. * @apiSuccess {Object[]} journal.button.read 第一个按钮 阅读按钮
  93. * @apiSuccess {String} journal.button.read.status 状态 -1不显示 1为进入阅读 2为兑换 3为预售,注意,当值为2时,必须在阅读按钮上,当用户点击按钮时,绑定一个事件,该事件的接口为journal_v1.subscribe
  94. * @apiSuccess {String} journal.button.read.name 按钮上的名字
  95. * @apiSuccess {Object[]} journal.button.buy 第二个按钮 购买按钮
  96. * @apiSuccess {String} journal.button.buy.status 状态 -1不显示 1为购买
  97. * @apiSuccess {String} journal.button.buy.name 按钮上的名字
  98. * @apiSuccess {Object[]} journal.button.share 第三个按钮 排行榜按钮
  99. * @apiSuccess {String} journal.button.share.status 状态 -1不显示 1为排行榜
  100. * @apiSuccess {String} journal.button.share.name 按钮上的名字
  101. *
  102. * @apiSuccess {Object[]} push 主推小刊
  103. * @apiSuccess {String} push.id 小刊id
  104. * @apiSuccess {String} push.name 名称
  105. * @apiSuccess {String} push.num_ding 订阅数
  106. * @apiSuccess {Object[]} cate 当前分类
  107. * @apiSuccess {String} cate.id 分类id
  108. * @apiSuccess {String} cate.name 名称
  109. * @apiSuccess {Object[]} cateList 分类列表
  110. * @apiSuccess {String} cateList.id 分类id
  111. * @apiSuccess {String} cateList.name 名称
  112. */
  113. /**
  114. * @api {get} wonderful/act/?l=order.getMyList 我的订单列表
  115. * @apiVersion 2.0.0
  116. * @apiName order.getMyList
  117. * @apiGroup UserActionV1
  118. *
  119. * @apiDescription 我的订单列表
  120. *
  121. * @apiParam {String} signature signature
  122. * @apiParam {String} system 分类id
  123. *
  124. * @apiSuccess {Object[]} order 订单信息
  125. * @apiSuccess {String} order.name 名称
  126. * @apiSuccess {String} order.order_id 订单id
  127. * @apiSuccess {String} order.buy_num 购买本数
  128. * @apiSuccess {String} order.cdate 购买时间
  129. */
  130. /**
  131. * @api {get} wonderful/act/?l=order.getMyCodeList 我的兑换码列表
  132. * @apiVersion 2.0.0
  133. * @apiName order.getMyCodeList
  134. * @apiGroup UserActionV1
  135. *
  136. * @apiDescription 我的兑换码列表
  137. *
  138. * @apiParam {String} signature signature
  139. * @apiParam {String} order_id 订单id
  140. *
  141. * @apiSuccess {Object[]} code 兑换码列表
  142. * @apiSuccess {String} code.code 兑换码
  143. * @apiSuccess {String} code.type 类型 1为未使用 3为已使用 4为已作废
  144. */
  145. /**
  146. * @api {get} wonderful/main/?l=journal_v1.read 电子刊阅读页
  147. * @apiVersion 1.0.0
  148. * @apiName journal_v1.read
  149. * @apiGroup JournalV1
  150. *
  151. * @apiDescription 电子刊阅读页
  152. *
  153. * @apiParam {String} signature signature
  154. * @apiParam {Number} id 电子刊id
  155. *
  156. * @apiSuccess {Object[]} content 内容数据列表,每页显示10条,请在翻到第7或者第8条时,请求第2页
  157. * @apiSuccess {String} content.id 内容id
  158. * @apiSuccess {String} content.type 内容类型1全屏图、2长图、3图文内容、11关联图文、12关联视频、13关联直播、4全屏视频、5留言视频、6留言音频|||新增:7长屏图、8横屏图、9无边框图片、10四宫格图片、21对话模板、31试用产品、32是h5的url地址(独立h5)
  159. * @apiSuccess {String} content.name 标题。type=5,6时有效
  160. * @apiSuccess {String} content.cover 音频或者视频的封面图,type=4,5,6时有效
  161. * @apiSuccess {String} content.video 视频地址。type=4,5时有效
  162. * @apiSuccess {String} content.music 音频地址。type=6时有效
  163. * @apiSuccess {String} content.pic 全屏图或者长图,type=1,2,7,8,9时有效
  164. * @apiSuccess {String} content.pic_info 全屏图或者长图的图片信息,type=1,2,7,8,9时有效,值如1024_768_548.12_35,请用_分隔成数组使用,1024为宽度,768为高度,548.12为图片大小,35为图片id
  165. * @apiSuccess {String} content.is_button 全屏图上的保存按钮,1显示2不显示,type=1时有效
  166. * @apiSuccess {String} content.button_name 全屏图上的保存按钮的文字,type=1时有效
  167. * @apiSuccess {String} content.button_color 全屏图上的保存按钮的文字颜色,type=1时有效
  168. * @apiSuccess {String} content.note 是否预约提醒1为已预约,2为未预约
  169. * @apiSuccess {Object[]} content.text 全屏图上的九个文字位置,type=1时有效
  170. * @apiSuccess {String} content.text.text 文字位置,1上左2上中3上右4中左5正中6中右7下左8下中9下右
  171. * @apiSuccess {String} content.text.name 文字内容 换行用\n隔开
  172. * @apiSuccess {String} content.text.color 文字颜色
  173. * @apiSuccess {String} content.text.bgcolor 文字背景颜色
  174. * @apiSuccess {String} content.text.bgcolor_type 是否设置文字背景颜色,1设置,2不设置,不设置则文字背景颜色为透明。
  175. * @apiSuccess {String} content.text.size 文字像素大小
  176. * @apiSuccess {Object[]} content.info type=3,11,12,13时有效,当等于11,12,13时,分别对应图文详情、视频详情、直播详情里的字段,等于3时,请查看以下字段
  177. * @apiSuccess {String} content.info.name 标题
  178. * @apiSuccess {String} content.info.focus 焦点图
  179. * @apiSuccess {String} content.info.content 内容
  180. * @apiSuccess {String} content.info.content_array 数组内容
  181. * @apiSuccess {Object[]} content.info.author 作者
  182. * @apiSuccess {Object[]} content.product type=31时有效
  183. * @apiSuccess {String} content.product.name 产品标题
  184. * @apiSuccess {String} content.product.pic 产品图片
  185. * @apiSuccess {String} content.product.content 内容
  186. * @apiSuccess {String} content.product.cate 产品分类信息
  187. * @apiSuccess {Object[]} content.product.price 产品价格
  188. * @apiSuccess {Object[]} content.palaces 四宫格图片的四个图片,type=10时有效
  189. * @apiSuccess {String} content.palaces.palaces 图片位置,1上左2上右3下左4下右
  190. * @apiSuccess {String} content.palaces.pic 图片
  191. * @apiSuccess {String} content.talk_pic 对话模板的置顶图片,为空则不显示,type=21时有效
  192. * @apiSuccess {Object[]} content.talk 对话模板里的对话内容,type=21时有效
  193. * @apiSuccess {String} content.talk.talk_location 对话位置,1左2右
  194. * @apiSuccess {String} content.talk.talk_type 对话类型,1文字,2图片,3音频
  195. * @apiSuccess {String} content.talk.avatar 头像
  196. * @apiSuccess {String} content.talk.text 文字
  197. * @apiSuccess {String} content.talk.pic 图片
  198. * @apiSuccess {String} content.talk.audio 音频
  199. */
  200. /**
  201. * @api {get} wonderful/main/?l=journal_v1.view 小刊详情页[废弃]
  202. * @apiVersion 2.0.0
  203. * @apiName journal.view
  204. * @apiGroup JournalV1
  205. *
  206. * @apiDescription 小刊详情页[废弃,请从journal_v1.getList或者journal_v1.getAppList中获取这些信息]
  207. *
  208. * @apiParam {String} signature signature
  209. * @apiParam {Number} id 小刊id
  210. *
  211. * @apiSuccess {Object[]} info 小刊详情
  212. * @apiSuccess {String} info.id 小刊id
  213. * @apiSuccess {String} info.name 名称
  214. * @apiSuccess {String} journal.subname 期号
  215. * @apiSuccess {String} info.pic_cover 列表封面图片 暂时无效
  216. * @apiSuccess {String} info.pic_view_cover 小刊封面图片 封面图都用这个
  217. * @apiSuccess {String} info.pic_view_bg 全屏背景图,多张图片,这是一个数组
  218. * @apiSuccess {String} info.pic_gd 小刊推广图
  219. * @apiSuccess {String} info.pdate 时间
  220. * @apiSuccess {String} info.ydate 预售时间
  221. * @apiSuccess {String} info.ytype 预售状态,1为可以阅读2显示预售弹窗,如果用button就不用判断该字段了
  222. * @apiSuccess {String} info.num_ding 订阅数
  223. * @apiSuccess {String} info.buy 小刊是否收费 1收费 2不收费
  224. * @apiSuccess {String} info.subscribe 是否订阅,1为已订阅2为未订阅
  225. * @apiSuccess {String} info.active 是否有活动,1为有2为没有,有则显示排行榜按钮
  226. * @apiSuccess {Object[]} button 按钮判断 如果不需要这个,可以不用
  227. * @apiSuccess {Object[]} button.read 第一个按钮 阅读按钮
  228. * @apiSuccess {String} button.read.status 状态 -1不显示 1为进入阅读 2为兑换 3为预售
  229. * @apiSuccess {String} button.read.name 按钮上的名字
  230. * @apiSuccess {Object[]} button.buy 第二个按钮 购买按钮
  231. * @apiSuccess {String} button.buy.status 状态 -1不显示 1为购买
  232. * @apiSuccess {String} button.buy.name 按钮上的名字
  233. * @apiSuccess {Object[]} button.share 第三个按钮 排行榜按钮
  234. * @apiSuccess {String} button.share.status 状态 -1不显示 1为排行榜
  235. * @apiSuccess {String} button.share.name 按钮上的名字
  236. */
  237. /**
  238. * @api {get} wonderful/main/?l=journal_v1.getView 小刊详情页
  239. * @apiVersion 2.0.0
  240. * @apiName journal.getView
  241. * @apiGroup JournalV1
  242. *
  243. * @apiDescription 小刊详情页,如果是分享进来的,请求这个接口来获取按钮
  244. *
  245. * @apiParam {String} signature signature
  246. * @apiParam {Number} id 小刊id
  247. *
  248. * @apiSuccess {Object[]} info 小刊详情
  249. * @apiSuccess {String} info.id 小刊id
  250. * @apiSuccess {String} info.name 名称
  251. * @apiSuccess {String} journal.subname 期号
  252. * @apiSuccess {String} info.pic_cover 列表封面图片 暂时无效
  253. * @apiSuccess {String} info.pic_view_cover 小刊封面图片 封面图都用这个
  254. * @apiSuccess {String} info.pic_view_bg 全屏背景图,多张图片,这是一个数组
  255. * @apiSuccess {String} info.pic_gd 小刊推广图
  256. * @apiSuccess {String} info.pdate 时间
  257. * @apiSuccess {String} info.ydate 预售时间
  258. * @apiSuccess {String} info.ytype 预售状态,1为可以阅读2显示预售弹窗,如果用button就不用判断该字段了
  259. * @apiSuccess {String} info.num_ding 订阅数
  260. * @apiSuccess {String} info.buy 小刊是否收费 1收费 2不收费
  261. * @apiSuccess {String} info.buy_type 电子刊支付类型,1为普通支付,2为明星支付(读取明星列表)
  262. * @apiSuccess {String} info.subscribe 是否订阅,1为已订阅2为未订阅
  263. * @apiSuccess {String} info.active 是否有活动,1为有2为没有,有则显示排行榜按钮
  264. * @apiSuccess {Object[]} button 按钮判断 如果不需要这个,可以不用
  265. * @apiSuccess {Object[]} button.read 第一个按钮 阅读按钮
  266. * @apiSuccess {String} button.read.status 状态 -1不显示 1为进入阅读 2为兑换 3为预售,注意,当值为2时,必须在阅读按钮上,当用户点击按钮时,绑定一个事件,该事件的接口为journal_v1.subscribe
  267. * @apiSuccess {String} button.read.name 按钮上的名字
  268. * @apiSuccess {Object[]} button.buy 第二个按钮 购买按钮
  269. * @apiSuccess {String} button.buy.status 状态 -1不显示 1为购买
  270. * @apiSuccess {String} button.buy.name 按钮上的名字
  271. * @apiSuccess {Object[]} button.share 第三个按钮 排行榜按钮
  272. * @apiSuccess {String} button.share.status 状态 -1不显示 1为排行榜
  273. * @apiSuccess {String} button.share.name 按钮上的名字
  274. */
  275. /**
  276. * @api {get} wonderful/main/?l=journal_v1.getAppView APP小刊详情页
  277. * @apiVersion 2.0.0
  278. * @apiName journal.getAppView
  279. * @apiGroup JournalV1
  280. *
  281. * @apiDescription APP小刊详情页,如果是分享进来的,请求这个接口来获取按钮
  282. *
  283. * @apiParam {String} signature signature
  284. * @apiParam {Number} id 小刊id
  285. *
  286. * @apiSuccess {Object[]} info 小刊详情
  287. * @apiSuccess {String} info.id 小刊id
  288. * @apiSuccess {String} info.name 名称
  289. * @apiSuccess {String} journal.subname 期号
  290. * @apiSuccess {String} info.pic_cover 列表封面图片 暂时无效
  291. * @apiSuccess {String} info.pic_view_cover 小刊封面图片 封面图都用这个
  292. * @apiSuccess {String} info.pic_view_bg 全屏背景图,多张图片,这是一个数组
  293. * @apiSuccess {String} info.pic_gd 小刊推广图
  294. * @apiSuccess {String} info.pdate 时间
  295. * @apiSuccess {String} info.ydate 预售时间
  296. * @apiSuccess {String} info.ytype 预售状态,1为可以阅读2显示预售弹窗,如果用button就不用判断该字段了
  297. * @apiSuccess {String} info.num_ding 订阅数
  298. * @apiSuccess {String} info.buy 小刊是否收费 1收费 2不收费
  299. * @apiSuccess {String} info.subscribe 是否订阅,1为已订阅2为未订阅
  300. * @apiSuccess {String} info.active 是否有活动,1为有2为没有,有则显示排行榜按钮
  301. * @apiSuccess {Object[]} button 按钮判断 如果不需要这个,可以不用
  302. * @apiSuccess {Object[]} button.read 第一个按钮 阅读按钮
  303. * @apiSuccess {String} button.read.status 状态 -1不显示 1为进入阅读 2为兑换 3为预售,注意,当值为2时,必须在阅读按钮上,当用户点击按钮时,绑定一个事件,该事件的接口为journal_v1.subscribe
  304. * @apiSuccess {String} button.read.name 按钮上的名字
  305. * @apiSuccess {Object[]} button.buy 第二个按钮 购买按钮
  306. * @apiSuccess {String} button.buy.status 状态 -1不显示 1为购买
  307. * @apiSuccess {String} button.buy.name 按钮上的名字
  308. * @apiSuccess {Object[]} button.share 第三个按钮 排行榜按钮
  309. * @apiSuccess {String} button.share.status 状态 -1不显示 1为排行榜
  310. * @apiSuccess {String} button.share.name 按钮上的名字
  311. */
  312. /**
  313. * @api {get} wonderful/main/?l=journal_v1.subscribe 检测小刊是否可以阅读
  314. * @apiVersion 2.0.0
  315. * @apiName journal.subscribe
  316. * @apiGroup JournalV1
  317. *
  318. * @apiDescription 检测小刊是否可以阅读
  319. *
  320. * @apiParam {String} signature signature
  321. * @apiParam {Number} id 小刊id
  322. *
  323. * @apiSuccess {String} subscribe 1为已订阅可以阅读,2为未订阅不能阅读,弹出兑换码
  324. */
  325. /**
  326. * @api {get} wonderful/main/?l=journal_v1.buy 小刊购买页
  327. * @apiVersion 2.0.0
  328. * @apiName journal.buy
  329. * @apiGroup JournalV1
  330. *
  331. * @apiDescription 小刊购买页
  332. *
  333. * @apiParam {String} signature signature
  334. * @apiParam {Number} id 小刊id
  335. *
  336. * @apiSuccess {Object[]} info 小刊详情
  337. * @apiSuccess {String} info.id 小刊id
  338. * @apiSuccess {String} info.name 名称
  339. *
  340. * @apiSuccess {String} buy_desc 购买说明
  341. * @apiSuccess {Object[]} buy_list 购买列表
  342. * @apiSuccess {String} buy_list.id 购买id 支付时使用
  343. * @apiSuccess {String} buy_list.name 名称
  344. * @apiSuccess {String} buy_list.price 标价
  345. * @apiSuccess {String} buy_list.cash 实际支付价格
  346. */
  347. /**
  348. * @api {get} wonderful/main/?l=journal_v1.star 电子刊明星列表页
  349. * @apiVersion 1.0.0
  350. * @apiName journal_v1.star
  351. * @apiGroup Journal
  352. *
  353. * @apiDescription 电子刊明星列表页,当buy_type==2时读取本接口
  354. *
  355. * @apiParam {String} signature signature
  356. * @apiParam {Number} id 电子刊id
  357. *
  358. * @apiSuccess {Object[]} info 电子刊详情
  359. * @apiSuccess {String} info.id 电子刊id
  360. * @apiSuccess {String} info.name 名称
  361. * @apiSuccess {Object[]} star 明星列表
  362. * @apiSuccess {String} star.id 明星id 支付时使用
  363. * @apiSuccess {String} star.name 明星名称
  364. * @apiSuccess {String} star.avatar 明星头像
  365. * @apiSuccess {String} star.num_ding 明星订阅数
  366. */
  367. /**
  368. * @api {get} wonderful/act/?l=order.pay 发起支付
  369. * @apiVersion 2.0.0
  370. * @apiName order.pay
  371. * @apiGroup UserActionV1
  372. *
  373. * @apiDescription 发起支付:请注意,如果是苹果支付,请在发起苹果支付之后,将苹果返回的验证数据,传入该接口
  374. *
  375. * @apiParam {String} signature signature
  376. * @apiParam {String} journal_id 小刊id
  377. * @apiParam {String} buy_id 购买本数id
  378. * @apiParam {String} star_id 明星id
  379. * @apiParam {String} receipt 当header中的source_type为ios时,请传入该参数,参数的值为苹果支付后返回的参数,即可发起支付验证。
  380. *
  381. * @apiSuccess {Object[]} pay 微信支付返回的数据
  382. * @apiSuccess {String} pay.time 服务器时间戳
  383. * @apiSuccess {String} pay.nonce_str 随机字符串
  384. * @apiSuccess {String} pay.prepay_id 统一下单接口返回的 prepay_id 参数值,通过'prepay_id=' + prepay_id 拼装成package
  385. * @apiSuccess {String} pay.sign_type 签名算法
  386. * @apiSuccess {String} pay.sign 签名
  387. * @apiSuccess {String} pay.yes 苹果支付时显示改参数,1为支付成功2为支付失败
  388. * @apiSuccess {String} pay.order_id 支付的订单id
  389. */
  390. /**
  391. * @api {get} wonderful/act/?l=order.code 兑换码兑换
  392. * @apiVersion 2.0.0
  393. * @apiName order.code
  394. * @apiGroup UserActionV1
  395. * @apiDescription 兑换码兑换
  396. *
  397. * @apiParam {String} signature signature
  398. * @apiParam {String} journal_id 小刊id
  399. * @apiParam {String} code 兑换码
  400. *
  401. * @apiSuccess {String} ok 兑换成功
  402. */
  403. /**
  404. * @api {get} wonderful/main/?l=journal_v1.top 小刊本数排行榜
  405. * @apiVersion 2.0.0
  406. * @apiName journal.top
  407. * @apiGroup JournalV1
  408. *
  409. * @apiDescription 小刊本数排行榜
  410. *
  411. * @apiParam {String} signature signature
  412. * @apiParam {Number} id 小刊id
  413. *
  414. * @apiSuccess {Object[]} info 小刊详情
  415. * @apiSuccess {String} info.id 小刊id
  416. * @apiSuccess {String} info.name 名称
  417. *
  418. * @apiSuccess {Object[]} top 本数排行
  419. * @apiSuccess {String} top.uid 用户id
  420. * @apiSuccess {String} top.num 本数
  421. * @apiSuccess {String} top.username 用户名
  422. * @apiSuccess {String} top.avatar 头像
  423. *
  424. * @apiSuccess {Object[]} active 活动说明表
  425. * @apiSuccess {String} active.name 名称
  426. * @apiSuccess {String} active.status 活动状态 1活动进行中 2活动已结束
  427. * @apiSuccess {String} active.desc 描述
  428. * @apiSuccess {String} active.invite_title 邀请好友标题
  429. * @apiSuccess {String} active.invite_desc 邀请好友描述 换行用\n隔开
  430. * @apiSuccess {String} active.content 活动说明,富文本
  431. */
  432. /**
  433. * @api {get} package/log/?api.push 日志记录
  434. * @apiVersion 1.0.0
  435. * @apiName api.push
  436. * @apiGroup Log
  437. *
  438. * @apiDescription 日志记录
  439. *
  440. * @apiParam {String} project 项目,目前有两个值:ad_show为广告曝光,就是打开页面时需要访问本接口,ad_click为广告点击,点击某个广告时需要访问本接口
  441. * @apiParam {String} source 来源,暂时写死:jingmei
  442. * @apiParam {String} system 系统,1是h5,2是安卓,3是苹果,4是微信小程序
  443. * @apiParam {String} uid 用户id,如果未登录需要传入-1
  444. * @apiParam {String} ip 用户ip,如果未登录,会通过ip识别用户
  445. * @apiParam {String} ua ua信息
  446. * @apiParam {String} os 操作系统
  447. * @apiParam {String} browser 浏览器
  448. * @apiParam {String} ck_mobile 是否手机,请写死为1
  449. * @apiParam {String} ck_wechat 是否微信,请写死为2,如果是小程序或者h5,请根据实际情况来写值,1就是微信,2不是
  450. * @apiParam {String} ad_page_id 广告页面id
  451. * @apiParam {String} ad_info_id 广告位id
  452. * @apiParam {String} ad_data_id 广告投放id
  453. */