<?php /** * @api {get} common.public 公共参数说明 * @apiVersion 1.0.0 * @apiName common.public * @apiGroup Common * * @apiDescription 介绍公共参数 * * @apiParam {Number} json 是否返回json格式的数据1为返回2为不返回 * @apiParam {Number} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 * @apiParam {Number} pg 分页数,第几页,列表页瀑布流使用该参数 * * @apiSuccess {Number} status 状态,1为有效2为无效 * @apiSuccess {String} msg 请求的数据是否成功的提示 * @apiSuccess {String} data 如果status为1,data有值 * @apiSuccess {Object[]} page 分页信息 * @apiSuccess {Number} page.total 分页总数 * @apiSuccess {Number} page.current_page 当前页 * @apiSuccess {Number} page.total_page 总页数 * @apiSuccess {Number} page.next_page 下一页 * @apiSuccess {Number} page.prev_page 上一页 * @apiSuccess {Number} page.status 是否有下一页数据,0为没有 */ /** * @api {get} common.type 类型设置说明 * @apiVersion 1.0.0 * @apiName common.type * @apiGroup Common * * @apiDescription 类型设置说明 * * @apiParam {String} source_type 请在header中定义,ios:ios | android:android | 移动h5:h5 | 小程序:applet | 公众号:service | pc网站:pc * @apiParam {Number} type 图文:1 | 视频:2 | 直播:3 | 小刊:4 | 小刊音视频:5 | 专题:6 | 小程序:7 | 商品:8 | 链接:10 | 评论: 11 || 直播评论:12 | 小刊活动页:13 * @apiParam {Number} push_ 所有带push_开头的返回参数,返回字典都是一样的,参考获取首页数据中的push_focus */ /** * @api {post} upload/upload/?save.start 上传图片接口 * @apiVersion 1.0.0 * @apiName save.start * @apiGroup Common * * @apiParam {Number} key 值为6,写死即可 * @apiParam {String} file 文件流 multipart/form-data形式 * * @apiSuccess {String} url 图片地址 */ /** * @api {get} mars/passport/?l=applet.login 用户登录 * @apiVersion 2.0.0 * @apiName applet.login * @apiGroup AppletPassport * * @apiDescription 用户登录 * * @apiParam {String} code 微信登录返回的code * @apiParam {String} nickname 用户昵称 * @apiParam {String} avatarurl 用户头像 * @apiParam {String} gender 性别 * @apiParam {String} city 城市 * @apiParam {String} province 省份 * @apiParam {String} country 县区 * @apiParam {String} iv 微信的加密参数 * @apiParam {String} encryptedData 微信的加密参数 * * @apiSuccess {Number} vid 微信id,请保存在本地 * @apiSuccess {Number} uid 用户id,请保存在本地 * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 */ /** * @api {get} wonderful/passport/?l=applet.update 更新用户信息 * @apiVersion 1.0.0 * @apiName applet.update * @apiGroup AppletPassport * * @apiDescription 更新用户信息 * * @apiParam {String} nickname 用户昵称 * @apiParam {String} avatarurl 用户头像 * @apiParam {String} gender 性别 * @apiParam {String} city 城市 * @apiParam {String} province 省份 * @apiParam {String} country 县区 * @apiParam {String} iv 微信的加密参数 * @apiParam {String} encryptedData 微信的加密参数 * @apiParam {Number} vid 微信id * @apiParam {Number} uid 用户id * @apiParam {String} signature signature * * * @apiSuccess {Number} vid 微信id,请保存在本地 * @apiSuccess {Number} uid 用户id,请保存在本地 * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 */ /** * @api {get} wonderful/passport/?l=applet.mobile 更新用户手机号-微信绑定 * @apiVersion 1.0.0 * @apiName applet.mobile * @apiGroup AppletPassport * * @apiDescription 更新用户手机号-微信绑定 * * @apiParam {String} iv 微信的加密参数 * @apiParam {String} encryptedData 微信的加密参数 * @apiParam {Number} vid 微信id * @apiParam {Number} uid 用户id * @apiParam {String} signature signature * * * @apiSuccess {Number} vid 微信id,请保存在本地 * @apiSuccess {Number} uid 用户id,请保存在本地 * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 */ /** * @api {get} wonderful/passport/?l=applet.bind_mobile 更新用户手机号-验证码绑定 * @apiVersion 1.0.0 * @apiName applet.bind_mobile * @apiGroup AppletPassport * * @apiDescription 更新用户手机号-验证码绑定 * * @apiParam {Number} uid 用户id * @apiParam {Number} mobile 手机号 * @apiParam {String} mcode 验证码 * @apiParam {String} signature signature * * @apiSuccess {Number} uid 用户id,请保存在本地 * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 */ /** * @api {get} wonderful/passport/?l=reg.getMCode 获取手机验证码 * @apiVersion 1.0.0 * @apiName reg.getMCode * @apiGroup AppletPassport * * @apiDescription 获取手机验证码 * * @apiParam {Number} mobile 手机号 * * @apiSuccess {String} msg 验证码已发送至您的手机,请注意查收,十分钟之内有效 */ /** * @api {get} wonderful/passport/?l=reg.getMCode 获取手机验证码,未登录状态 * @apiVersion 1.0.0 * @apiName reg.getMCode * @apiGroup AppPassport * * @apiDescription 获取手机验证码,未登录状态 * * @apiParam {Number} mobile 手机号 * * @apiSuccess {String} msg 验证码已发送至您的手机,请注意查收,十分钟之内有效 */ /** * @api {get} wonderful/passport/?l=reg.getMCodeLogin 获取手机验证码,已登录状态 * @apiVersion 1.0.0 * @apiName reg.getMCode * @apiGroup AppPassport * * @apiDescription 获取手机验证码,已登录状态 * * @apiParam {Number} mobile 手机号 * @apiParam {String} signature signature * * @apiSuccess {String} msg 验证码已发送至您的手机,请注意查收,十分钟之内有效 */ /** * @api {get} wonderful/passport/?l=app.login 登录与注册 * @apiVersion 1.0.0 * @apiName app.login * @apiGroup AppPassport * * @apiDescription 登录与注册 * * @apiParam {Number} mobile 手机号 * @apiParam {String} mcode 验证码 * * @apiSuccess {Number} uid 用户id,请保存在本地 * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 */ /** * @api {get} wonderful/passport/?l=app.login_uuid UUID登录 * @apiVersion 1.0.0 * @apiName app.login_uuid * @apiGroup AppPassport * * @apiDescription UUID登录 * * @apiParam {Number} uuid UUID * * @apiSuccess {Number} uid 用户id,请保存在本地 * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 */ /** * @api {get} wonderful/passport/?l=app.bind_mobile 更新用户手机号-验证码绑定 * @apiVersion 1.0.0 * @apiName app.bind_mobile * @apiGroup AppPassport * * @apiDescription 更新用户手机号-验证码绑定 * * @apiParam {Number} uid 用户id * @apiParam {Number} mobile 手机号 * @apiParam {String} mcode 验证码 * @apiParam {String} signature signature * * @apiSuccess {Number} uid 用户id,请保存在本地 * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 */ /** * @api {get} wonderful/passport/?l=app.wechat_reg 第三方登录-已经拥有openid * @apiVersion 1.0.0 * @apiName app.wechat_reg * @apiGroup AppPassport * * @apiDescription 第三方登录-已经拥有openid * * @apiParam {String} username 用户名 * @apiParam {String} avatar 头像 * @apiParam {String} sex 性别 * @apiParam {String} city 城市 * @apiParam {String} province 省份 * @apiParam {String} country 县区 * @apiParam {String} openid openid * @apiParam {String} unionid unionid * @apiParam {String} access_token access_token * @apiParam {String} refresh_token refresh_token * @apiParam {String} expires_in 失效时间 * * @apiSuccess {Number} uid 用户id,请保存在本地 * @apiSuccess {Number} mobile 手机号,判断手机号是否存在,不存在则需要进行绑定,请直接使用app.bind_mobile接口进行绑定即可 * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 */ /** * @api {get} wonderful/oauth/?l=request.callback 第三方登录 * @apiVersion 1.0.0 * @apiName request.callback * @apiGroup AppPassport * * @apiDescription 第三方登录 * * @apiParam {Number} account 第三方登录的账号,写死为2吧 * @apiParam {Number} system 系统id,写死为1,后续做ok精彩和精品时再加 * @apiParam {String} source 渠道来源,写死为1,默认1则为官网渠道 * @apiParam {String} source_type 渠道类型,写死为ios或者android * @apiParam {String} code 用户授权后返回的code * * @apiSuccess {Number} uid 用户id,请保存在本地 * @apiSuccess {Number} mobile 手机号,判断手机号是否存在,不存在则需要进行绑定,请直接使用app.bind_mobile接口进行绑定即可 * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 */ /** * @api {get} wonderful/passport/?l=app.update 更新用户信息 * @apiVersion 1.0.0 * @apiName app.update * @apiGroup AppPassport * * @apiDescription 更新用户信息 * * @apiParam {Number} signature 用户signature * @apiParam {String} username 用户昵称 * @apiParam {String} avatar 用户头像 * @apiParam {String} gender 性别 * @apiParam {String} city 城市 * @apiParam {String} province 省份 * @apiParam {String} country 县区 * * @apiSuccess {Number} uid 用户id,请保存在本地 * @apiSuccess {String} signature 用于登录后的uid验证,每次都要传入,请登录后将这个值保存在本地 */ /** * @api {get} wonderful/main/?l=view.getHtml 获取富文本内容 * @apiVersion 1.0.0 * @apiName view.getHtml * @apiGroup App * * @apiDescription 获取富文本内容 * * @apiParam {Number} signature 用户signature * @apiParam {String} type 类型1为图文、2为视频、3为直播、4为小刊内容,6为专题 * @apiParam {String} id 图文等内容id,如果为4,则为小刊的内容id,而非小刊id * * @apiSuccess {String} html 直接返回html的信息,请注意里面的协议:jstyle://live_note?id=0&live_id=1&file=test 其中有几个: jstyle://video?id=0&vod_id=1&file=test 播放视频 id=0为content_array里的数组索引,vod_id为视频id,file为视频文件地址 jstyle://live?id=0&live_id=1&file=test 播放直播 id=0为content_array里的数组索引,live_id为直播id,file为直播文件地址 jstyle://live_note?id=0&live_id=1&file=test¬e=1 设置直播提醒 id=0为content_array里的数组索引,live_id为直播id,file为直播文件地址,note值为1是已设置提醒,2为未设置提醒 jstyle://auido?id=0&file=test¬e=1 播放视频 id=0为content_array里的数组索引,file为直播文件地址 */ /** * @api {get} wonderful/main/?l=user.submit_comment 提交评论 * @apiVersion 1.0.0 * @apiName user.submit_comment * @apiGroup UserAction * * @apiDescription 提交评论 * * @apiParam {String} signature signature * @apiParam {Number} type type类型 * @apiParam {Number} id 当前的数据id * @apiParam {String} content 评论内容 * * @apiSuccess {Number} id 当前的数据id */ /** * @api {get} mars/main/?l=journal.getList 小程序小刊列表 * @apiVersion 2.0.0 * @apiName journal.getList * @apiGroup Journal * * @apiDescription 小刊列表,按照分类读取,根据获取的信息,可以直接进入到小刊详情页,无需再次请求接口。 * * @apiParam {String} signature signature * @apiParam {String} system 分类id,默认为1,传入-1就是获取全部 * * @apiSuccess {Object[]} journal 小刊数据列表 * @apiSuccess {String} journal.id 小刊id * @apiSuccess {String} journal.name 名称 * @apiSuccess {String} journal.subname 期号 * @apiSuccess {String} journal.pic_cover 列表封面图片 暂时无效 * @apiSuccess {String} journal.pic_view_cover 小刊封面图片 封面图都用这个 * @apiSuccess {String} journal.pic_view_bg 全屏背景图,多张图片,这是一个数组 * @apiSuccess {String} journal.pic_gd 小刊推广图 * @apiSuccess {String} journal.pdate 时间 * @apiSuccess {String} journal.num_ding 订阅数 * @apiSuccess {String} journal.buy 小刊是否收费 1收费 2免费 3会员 * @apiSuccess {String} journal.bgmusic 小刊背景音乐 * @apiSuccess {Object[]} journal.button 按钮判断 如果不需要这个,可以不用 * @apiSuccess {Object[]} journal.button.read 第一个按钮 阅读按钮 * @apiSuccess {String} journal.button.read.status 状态 -1不显示 1为进入阅读 2为兑换 3为预售,注意,当值为2时,必须在阅读按钮上,当用户点击按钮时,绑定一个事件,该事件的接口为journal.subscribe * @apiSuccess {String} journal.button.read.name 按钮上的名字 * @apiSuccess {Object[]} journal.button.buy 第二个按钮 购买按钮 * @apiSuccess {String} journal.button.buy.status 状态 -1不显示 1为购买 * @apiSuccess {String} journal.button.buy.name 按钮上的名字 * @apiSuccess {Object[]} journal.button.share 第三个按钮 排行榜按钮 * @apiSuccess {String} journal.button.share.status 状态 -1不显示 1为排行榜 * @apiSuccess {String} journal.button.share.name 按钮上的名字 * * @apiSuccess {Object[]} push 主推小刊 * @apiSuccess {String} push.id 小刊id * @apiSuccess {String} push.name 名称 * @apiSuccess {String} push.num_ding 订阅数 * @apiSuccess {Object[]} cate 当前分类 * @apiSuccess {String} cate.id 分类id * @apiSuccess {String} cate.name 名称 */ /** * @api {get} mars/main/?l=journal.getAppList APP小刊列表 * @apiVersion 2.0.0 * @apiName journal.getAppList * @apiGroup Journal * * @apiDescription 小刊列表,按照分类读取,根据获取的信息,可以直接进入到小刊详情页,无需再次请求接口。 * * @apiParam {String} signature signature * @apiParam {String} system 分类id,默认为1,传入-1就是获取全部 * * @apiSuccess {Object[]} journal 小刊数据列表 * @apiSuccess {String} journal.id 小刊id * @apiSuccess {String} journal.name 名称 * @apiSuccess {String} journal.subname 期号 * @apiSuccess {String} journal.pic_cover 列表封面图片 暂时无效 * @apiSuccess {String} journal.pic_view_cover 小刊封面图片 封面图都用这个 * @apiSuccess {String} journal.pic_view_bg 全屏背景图,多张图片,这是一个数组 * @apiSuccess {String} journal.pic_gd 小刊推广图 * @apiSuccess {String} journal.pdate 时间 * @apiSuccess {String} journal.num_ding 订阅数 * @apiSuccess {String} journal.buy 小刊是否收费 1收费 2免费 3会员 * @apiSuccess {String} journal.bgmusic 小刊背景音乐 * @apiSuccess {Object[]} journal.button 按钮判断 如果不需要这个,可以不用 * @apiSuccess {Object[]} journal.button.read 第一个按钮 阅读按钮 * @apiSuccess {String} journal.button.read.status 状态 -1不显示 1为进入阅读 2为兑换 3为预售,注意,当值为2时,必须在阅读按钮上,当用户点击按钮时,绑定一个事件,该事件的接口为journal.subscribe * @apiSuccess {String} journal.button.read.name 按钮上的名字 * @apiSuccess {Object[]} journal.button.buy 第二个按钮 购买按钮 * @apiSuccess {String} journal.button.buy.status 状态 -1不显示 1为购买 * @apiSuccess {String} journal.button.buy.name 按钮上的名字 * @apiSuccess {Object[]} journal.button.share 第三个按钮 排行榜按钮 * @apiSuccess {String} journal.button.share.status 状态 -1不显示 1为排行榜 * @apiSuccess {String} journal.button.share.name 按钮上的名字 * * @apiSuccess {Object[]} push 主推小刊 * @apiSuccess {String} push.id 小刊id * @apiSuccess {String} push.name 名称 * @apiSuccess {String} push.num_ding 订阅数 * @apiSuccess {Object[]} cate 当前分类 * @apiSuccess {String} cate.id 分类id * @apiSuccess {String} cate.name 名称 * @apiSuccess {Object[]} cateList 分类列表 * @apiSuccess {String} cateList.id 分类id * @apiSuccess {String} cateList.name 名称 */ /** * @api {get} mars/act/?l=order.getMyList 我的订单列表 * @apiVersion 2.0.0 * @apiName order.getMyList * @apiGroup UserActionV1 * * @apiDescription 我的订单列表 * * @apiParam {String} signature signature * @apiParam {String} system 分类id * * @apiSuccess {Object[]} order 订单信息 * @apiSuccess {String} order.name 名称 * @apiSuccess {String} order.order_id 订单id * @apiSuccess {String} order.buy_num 购买本数 * @apiSuccess {String} order.cdate 购买时间 */ /** * @api {get} mars/act/?l=order.getMyCodeList 我的兑换码列表 * @apiVersion 2.0.0 * @apiName order.getMyCodeList * @apiGroup UserActionV1 * * @apiDescription 我的兑换码列表 * * @apiParam {String} signature signature * @apiParam {String} order_id 订单id * * @apiSuccess {Object[]} code 兑换码列表 * @apiSuccess {String} code.code 兑换码 * @apiSuccess {String} code.type 类型 1为未使用 3为已使用 4为已作废 */ /** * @api {get} mars/main/?l=journal.read 小刊阅读页 * @apiVersion 2.0.0 * @apiName journal.read * @apiGroup Journal * * @apiDescription 小刊阅读页 * * @apiParam {String} signature signature * @apiParam {Number} id 小刊id * * @apiSuccess {Object[]} content 内容数据列表,每页显示10条,请在翻到第7或者第8条时,请求第2页 * @apiSuccess {String} content.id 内容id * @apiSuccess {String} content.type 内容类型1全屏图、2长图、3图文内容、11关联图文、12关联视频、13关联直播、4全屏视频、5留言视频、6留言音频|||新增:7长屏图、8横屏图、9无边框图片、10四宫格图片、21对话模板 * @apiSuccess {String} content.name 标题。type=5,6时有效 * @apiSuccess {String} content.cover 音频或者视频的封面图,type=4,5,6时有效 * @apiSuccess {String} content.video 视频地址。type=4,5时有效 * @apiSuccess {String} content.music 音频地址。type=6时有效 * @apiSuccess {String} content.pic 全屏图或者长图,type=1,2,7,8,9时有效 * @apiSuccess {String} content.pic_info 全屏图或者长图的图片信息,type=1,2,7,8,9时有效,值如1024_768_548.12_35,请用_分隔成数组使用,1024为宽度,768为高度,548.12为图片大小,35为图片id * @apiSuccess {String} content.is_button 全屏图上的保存按钮,1显示2不显示,type=1时有效 * @apiSuccess {String} content.button_name 全屏图上的保存按钮的文字,type=1时有效 * @apiSuccess {String} content.button_color 全屏图上的保存按钮的文字颜色,type=1时有效 * @apiSuccess {String} content.note 是否预约提醒1为已预约,2为未预约 * @apiSuccess {Object[]} content.text 全屏图上的九个文字位置,type=1时有效 * @apiSuccess {String} content.text.text 文字位置,1上左2上中3上右4中左5正中6中右7下左8下中9下右 * @apiSuccess {String} content.text.name 文字内容 换行用\n隔开 * @apiSuccess {String} content.text.color 文字颜色 * @apiSuccess {String} content.text.bgcolor 文字背景颜色 * @apiSuccess {String} content.text.bgcolor_type 是否设置文字背景颜色,1设置,2不设置,不设置则文字背景颜色为透明。 * @apiSuccess {String} content.text.size 文字像素大小 * @apiSuccess {Object[]} content.info type=3,11,12,13时有效,当等于11,12,13时,分别对应图文详情、视频详情、直播详情里的字段,等于3时,请查看以下字段 * @apiSuccess {String} content.info.name 标题 * @apiSuccess {String} content.info.focus 焦点图 * @apiSuccess {String} content.info.content 内容 * @apiSuccess {String} content.info.content_array 数组内容 * @apiSuccess {Object[]} content.info.author 作者 * @apiSuccess {Object[]} content.palaces 四宫格图片的四个图片,type=10时有效 * @apiSuccess {String} content.palaces.palaces 图片位置,1上左2上右3下左4下右 * @apiSuccess {String} content.palaces.pic 图片 * @apiSuccess {String} content.talk_pic 对话模板的置顶图片,为空则不显示,type=21时有效 * @apiSuccess {Object[]} content.talk 对话模板里的对话内容,type=21时有效 * @apiSuccess {String} content.talk.talk_location 对话位置,1左2右 * @apiSuccess {String} content.talk.talk_type 对话类型,1文字,2图片,3音频 * @apiSuccess {String} content.talk.avatar 头像 * @apiSuccess {String} content.talk.text 文字 * @apiSuccess {String} content.talk.pic 图片 * @apiSuccess {String} content.talk.audio 音频 */ /** * @api {get} mars/main/?l=journal.getView 小刊详情页 * @apiVersion 2.0.0 * @apiName journal.getView * @apiGroup Journal * * @apiDescription 小刊详情页,如果是分享进来的,请求这个接口来获取按钮 * * @apiParam {String} signature signature * @apiParam {Number} id 小刊id * * @apiSuccess {Object[]} info 小刊详情 * @apiSuccess {String} info.id 小刊id * @apiSuccess {String} info.name 名称 * @apiSuccess {String} journal.subname 期号 * @apiSuccess {String} info.pic_cover 列表封面图片 暂时无效 * @apiSuccess {String} info.pic_view_cover 小刊封面图片 封面图都用这个 * @apiSuccess {String} info.pic_view_bg 全屏背景图,多张图片,这是一个数组 * @apiSuccess {String} info.pic_gd 小刊推广图 * @apiSuccess {String} info.pdate 时间 * @apiSuccess {String} info.ydate 预售时间 * @apiSuccess {String} info.ytype 预售状态,1为可以阅读2显示预售弹窗,如果用button就不用判断该字段了 * @apiSuccess {String} info.num_ding 订阅数 * @apiSuccess {String} info.buy 小刊是否收费 1收费 2不收费 * @apiSuccess {String} info.subscribe 是否订阅,1为已订阅2为未订阅 * @apiSuccess {String} info.active 是否有活动,1为有2为没有,有则显示排行榜按钮 * @apiSuccess {Object[]} button 按钮判断 如果不需要这个,可以不用 * @apiSuccess {Object[]} button.read 第一个按钮 阅读按钮 * @apiSuccess {String} button.read.status 状态 -1不显示 1为进入阅读 2为兑换 3为预售,注意,当值为2时,必须在阅读按钮上,当用户点击按钮时,绑定一个事件,该事件的接口为journal.subscribe * @apiSuccess {String} button.read.name 按钮上的名字 * @apiSuccess {Object[]} button.buy 第二个按钮 购买按钮 * @apiSuccess {String} button.buy.status 状态 -1不显示 1为购买 * @apiSuccess {String} button.buy.name 按钮上的名字 * @apiSuccess {Object[]} button.share 第三个按钮 排行榜按钮 * @apiSuccess {String} button.share.status 状态 -1不显示 1为排行榜 * @apiSuccess {String} button.share.name 按钮上的名字 */ /** * @api {get} mars/main/?l=journal.getAppView APP小刊详情页 * @apiVersion 2.0.0 * @apiName journal.getAppView * @apiGroup Journal * * @apiDescription APP小刊详情页,如果是分享进来的,请求这个接口来获取按钮 * * @apiParam {String} signature signature * @apiParam {Number} id 小刊id * * @apiSuccess {Object[]} info 小刊详情 * @apiSuccess {String} info.id 小刊id * @apiSuccess {String} info.name 名称 * @apiSuccess {String} journal.subname 期号 * @apiSuccess {String} info.pic_cover 列表封面图片 暂时无效 * @apiSuccess {String} info.pic_view_cover 小刊封面图片 封面图都用这个 * @apiSuccess {String} info.pic_view_bg 全屏背景图,多张图片,这是一个数组 * @apiSuccess {String} info.pic_gd 小刊推广图 * @apiSuccess {String} info.pdate 时间 * @apiSuccess {String} info.ydate 预售时间 * @apiSuccess {String} info.ytype 预售状态,1为可以阅读2显示预售弹窗,如果用button就不用判断该字段了 * @apiSuccess {String} info.num_ding 订阅数 * @apiSuccess {String} info.buy 小刊是否收费 1收费 2不收费 * @apiSuccess {String} info.subscribe 是否订阅,1为已订阅2为未订阅 * @apiSuccess {String} info.active 是否有活动,1为有2为没有,有则显示排行榜按钮 * @apiSuccess {Object[]} button 按钮判断 如果不需要这个,可以不用 * @apiSuccess {Object[]} button.read 第一个按钮 阅读按钮 * @apiSuccess {String} button.read.status 状态 -1不显示 1为进入阅读 2为兑换 3为预售,注意,当值为2时,必须在阅读按钮上,当用户点击按钮时,绑定一个事件,该事件的接口为journal.subscribe * @apiSuccess {String} button.read.name 按钮上的名字 * @apiSuccess {Object[]} button.buy 第二个按钮 购买按钮 * @apiSuccess {String} button.buy.status 状态 -1不显示 1为购买 * @apiSuccess {String} button.buy.name 按钮上的名字 * @apiSuccess {Object[]} button.share 第三个按钮 排行榜按钮 * @apiSuccess {String} button.share.status 状态 -1不显示 1为排行榜 * @apiSuccess {String} button.share.name 按钮上的名字 */ /** * @api {get} mars/main/?l=journal.subscribe 检测小刊是否可以阅读 * @apiVersion 2.0.0 * @apiName journal.subscribe * @apiGroup Journal * * @apiDescription 检测小刊是否可以阅读 * * @apiParam {String} signature signature * @apiParam {Number} id 小刊id * * @apiSuccess {String} subscribe 1为已订阅可以阅读,2为未订阅不能阅读,弹出兑换码 */ /** * @api {get} mars/main/?l=journal.buy 小刊购买页 * @apiVersion 2.0.0 * @apiName journal.buy * @apiGroup Journal * * @apiDescription 小刊购买页 * * @apiParam {String} signature signature * @apiParam {Number} id 小刊id * * @apiSuccess {Object[]} info 小刊详情 * @apiSuccess {String} info.id 小刊id * @apiSuccess {String} info.name 名称 * * @apiSuccess {String} buy_desc 购买说明 * @apiSuccess {Object[]} buy_list 购买列表 * @apiSuccess {String} buy_list.id 购买id 支付时使用 * @apiSuccess {String} buy_list.name 名称 * @apiSuccess {String} buy_list.price 标价 * @apiSuccess {String} buy_list.cash 实际支付价格 */ /** * @api {get} mars/act/?l=order.pay 发起支付 * @apiVersion 2.0.0 * @apiName order.pay * @apiGroup UserActionV1 * * @apiDescription 发起支付:请注意,如果是苹果支付,请在发起苹果支付之后,将苹果返回的验证数据,传入该接口 * * @apiParam {String} signature signature * @apiParam {String} journal_id 小刊id * @apiParam {String} buy_id 购买本数id * @apiParam {String} receipt 当header中的source_type为ios时,请传入该参数,参数的值为苹果支付后返回的参数,即可发起支付验证。 * * @apiSuccess {Object[]} pay 微信支付返回的数据 * @apiSuccess {String} pay.time 服务器时间戳 * @apiSuccess {String} pay.nonce_str 随机字符串 * @apiSuccess {String} pay.prepay_id 统一下单接口返回的 prepay_id 参数值,通过'prepay_id=' + prepay_id 拼装成package * @apiSuccess {String} pay.sign_type 签名算法 * @apiSuccess {String} pay.sign 签名 * @apiSuccess {String} pay.yes 苹果支付时显示改参数,1为支付成功2为支付失败 * @apiSuccess {String} pay.order_id 支付的订单id */ /** * @api {get} mars/act/?l=order.code 兑换码兑换 * @apiVersion 2.0.0 * @apiName order.code * @apiGroup UserActionV1 * @apiDescription 兑换码兑换 * * @apiParam {String} signature signature * @apiParam {String} journal_id 小刊id * @apiParam {String} code 兑换码 * * @apiSuccess {String} ok 兑换成功 */ /** * @api {get} mars/main/?l=journal.top 小刊本数排行榜 * @apiVersion 2.0.0 * @apiName journal.top * @apiGroup Journal * * @apiDescription 小刊本数排行榜 * * @apiParam {String} signature signature * @apiParam {Number} id 小刊id * * @apiSuccess {Object[]} info 小刊详情 * @apiSuccess {String} info.id 小刊id * @apiSuccess {String} info.name 名称 * * @apiSuccess {Object[]} top 本数排行 * @apiSuccess {String} top.uid 用户id * @apiSuccess {String} top.num 本数 * @apiSuccess {String} top.username 用户名 * @apiSuccess {String} top.avatar 头像 * * @apiSuccess {Object[]} active 活动说明表 * @apiSuccess {String} active.name 名称 * @apiSuccess {String} active.status 活动状态 1活动进行中 2活动已结束 * @apiSuccess {String} active.desc 描述 * @apiSuccess {String} active.invite_title 邀请好友标题 * @apiSuccess {String} active.invite_desc 邀请好友描述 换行用\n隔开 * @apiSuccess {String} active.content 活动说明,富文本 */ /** * @api {get} wonderful/main/?l=user.my 获取用户信息 * @apiVersion 1.0.0 * @apiName user.my * @apiGroup User * * @apiDescription 获取用户信息 * * @apiParam {String} signature signature * * @apiSuccess {Object[]} user 用户基本信息 * @apiSuccess {String} user.id 用户id * @apiSuccess {String} user.username 用户名 * @apiSuccess {String} user.mobile 手机号 * @apiSuccess {String} user.avatar 头像 * @apiSuccess {String} user.level 等级 * @apiSuccess {String} user.score 积分 * @apiSuccess {String} user.vip_type 会员状态,-1为未开通,-2为已过期,大于0则为正式会员的过期时间戳 * @apiSuccess {String} user.vip_end 当vip_type>0时存在,正式会员的过期时间 * @apiSuccess {String} user.vip_state vip_state=1则显示购买按钮,=2则不显示 * @apiSuccess {Number} user_msg 用户新消息数 */ /** * @api {get} wonderful/main/?l=user.my_msg 获取我的消息 * @apiVersion 1.0.0 * @apiName user.my_msg * @apiGroup User * * @apiDescription 获取我的消息 * * @apiParam {String} signature signature * * @apiSuccess {Object[]} msg 消息列表 * @apiSuccess {String} msg.uid 用户id * @apiSuccess {String} msg.from_uid 消息来源uid,暂时不用管 * @apiSuccess {String} msg.name 消息标题 * @apiSuccess {String} msg.content 消息内容 * @apiSuccess {String} msg.cdate 时间戳 * @apiSuccess {String} msg.cdate_time 转换成了Y-m-d H:i:s的时间 * @apiSuccess {String} msg.status 消息已读状态1未读2已读 * @apiSuccess {String} msg.type 消息类型,暂时不用管,目前都为11 * @apiSuccess {String} msg.param 消息传入参数,这是一个数组:name消息名称,type是上述公共参数所定义的类型,id是底层页id,link是链接地址,有则跳转到该地址 */ /** * @api {get} wonderful/main/?l=user.my_comment 获取我评论的信息 * @apiVersion 1.0.0 * @apiName user.my_comment * @apiGroup User * * @apiDescription 获取我喜欢的信息 * * @apiParam {String} signature signature * * @apiSuccess {Object[]} comment 用户基本信息 * @apiSuccess {String} comment.uid 用户id * @apiSuccess {String} comment.data_id 数据id * @apiSuccess {String} comment.content 评论内容 * @apiSuccess {String} comment.time 时间:x小时前 * @apiSuccess {String} comment.cdate 时间戳 * @apiSuccess {String} comment.cdate_time 转换成了Y-m-d H:i:s的时间 * @apiSuccess {String} comment.type 类型,参考公共参数中的类型设置说明中的type说明 * @apiSuccess {Object[]} comment.info 基本信息 根据type不同,里面的字段有所不同 * @apiSuccess {String} comment.info.id 数据id * @apiSuccess {String} comment.info.name 名称 * @apiSuccess {String} comment.info.cate_id 栏目ID * @apiSuccess {String} comment.info.cate_name 栏目名称 * @apiSuccess {String} comment.info.pic_cover 4:3图片 * @apiSuccess {String} comment.info.pic_cover_169 16:9图片 * @apiSuccess {String} comment.info.pdate 发布时间 */