安全教育+大电影接口文档

知识元

更新历史

目录

【备注】

1. 全局返回码说明

每次调用接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。

HTTP请求状态返回格式

错误样例
{
"status": 40013,
"message": {"0":"invalid appid"}
}
成功样例
{
"status": 200,
"data": {"access_token":"ACCESS_TOKEN","expires_in":7200}
}

1.资源

1.1 安全教育/英雄联盟大电影列表

接口地址

/v1/sml/videoList

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数

参数	必选	类型	说明
RequestBody
type	否	int	类型：1. 安全教育 2.英雄联盟大电影；默认1
page	否	int	页数
pageSize	否	int	页码
order	否	String	排序

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/sml/videoList
Response
{"status":200,"data":{"total_page":1,"page":1,"pagesize":20,"total_record":4,"record":[{"svId":"13","name":"\u8b66\u8f66\u8054\u76df\u5927\u7535\u5f71\u7ec8\u6781\u9884\u544a","poster":"https:\/\/oss.sewise.com\/video\/jclmddy\/dybygp.png","video":"https:\/\/oss.sewise.com\/video\/jclmddy\/zjygp.mp4","toyId":"1","product":"\u8b66\u8f66\u5c0f\u6cbb"},{"svId":"12","name":"\u8b66\u8f66\u8054\u76df\u5927\u7535\u5f7115\u79d2\u9884\u544a\u7247","poster":"https:\/\/oss.sewise.com\/video\/jclmddy\/dyb15mygp.png","video":"https:\/\/oss.sewise.com\/video\/jclmddy\/dyb15mygp.mp4","toyId":"3","product":"\u4e8c\u53f7\u673a"},{"svId":"11","name":"\u8b66\u8f66\u8054\u76df\u5927\u7535\u5f7130\u79d2\u9884\u544a\u7247","poster":"https:\/\/oss.sewise.com\/video\/jclmddy\/dyb30mygp.png","video":"https:\/\/oss.sewise.com\/video\/jclmddy\/dyb30mygp.mp4","toyId":"2","product":"\u6551\u62a4\u8f66\u5c0f\u82b8"},{"svId":"10","name":"\u8b66\u8f66\u8054\u76df\u5927\u7535\u5f71\u7b2c\u4e00\u7248\u9884\u544a\u7247","poster":"https:\/\/oss.sewise.com\/video\/jclmddy\/dybygp.png","video":"https:\/\/oss.sewise.com\/video\/jclmddy\/dybygp.mp4","toyId":"1","product":"\u8b66\u8f66\u5c0f\u6cbb"}]}}

1.2 安全教育/英雄联盟大电影内容

接口地址

/v1/sml/videoInfo/{svId}

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数

参数	必选	类型	说明
RequestBody
svId	是	int	视频id

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/sml/videoInfo/3
Response
{"status":200,"data":[{"svId":"3","name":"\u4e0d\u8981\u5728\u9a6c\u8def\u4e0a\u9a91\u8f66","poster":"https:\/\/oss.sewise.com\/video\/aqjyzl\/jcxz\/07.png","video":"https:\/\/oss.sewise.com\/video\/aqjyzl\/jcxz\/07.mp4","type":"1","toyId":"1","productId":"smleshop-jcxz-2018-0906-5a3304723de6","product":"\u8b66\u8f66\u5c0f\u6cbb","picture":"https:\/\/oss.sewise.com\/video\/toys\/jcxz_picture.jpg","diagram":"https:\/\/oss.sewise.com\/video\/toys\/jcxz_diagram.jpg"}]}

1.3 获取所有玩具列表

接口地址

/v1/sml/toyList

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数

参数	必选	类型	说明
RequestBody

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/sml/toyList
Response
{"status":200,"data":{"total_page":1,"page":1,"pagesize":20,"total_record":3,"record":[{"toyId":"1","productId":"smleshop-jcxz-2018-0906-5a3304723de6","product":"\u8b66\u8f66\u5c0f\u6cbb","picture":"https:\/\/oss.sewise.com\/video\/toys\/jcxz_picture.jpg","diagram":"https:\/\/oss.sewise.com\/video\/toys\/jcxz_diagram.jpg","price":"79.00"},{"toyId":"2","productId":"smleshop-jhxy-2018-0906-ab9da3d28ad0","product":"\u6551\u62a4\u8f66\u5c0f\u82b8","picture":"https:\/\/oss.sewise.com\/video\/toys\/jhcxy_picture.jpg","diagram":"https:\/\/oss.sewise.com\/video\/toys\/jhcxy_diagram.jpg","price":"79.00"},{"toyId":"3","productId":"smleshop-erhj-2018-0906-39b231230812","product":"\u4e8c\u53f7\u673a","picture":"https:\/\/oss.sewise.com\/video\/toys\/ehj_picture.jpg","diagram":"https:\/\/oss.sewise.com\/video\/toys\/ehj_diagram.jpg","price":"99.00"}]}}

1.4 保存/更新体验报告

接口地址

/v1/opinion/save?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
sosId	否	int	体验报告id，更新时必传
title	否	string	标题
relationId	否	string	商品id
status	否	int	状态：0.未发布 1.已发布
comment	否	string	体验感受

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/opinion/save
Response
{"status":200,"data":{"sosId":"1","title":"\u6551\u62a4\u8f66\u5c0f\u82b8","userId":"1011","relationId":"2","status":"1","comment":"\u6211\u7684\u4f53\u9a8c\u611f\u53d7....","creationDate":"2018-09-06 15:52:01"}}

1.5 保存/更新体验报告资源文件

接口地址

/v1/opinion/resourceSave?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
type	是	int	类型：1.视频 2.音频
sosId	是	int	体验报告id
path	path	string	资源地址
duration	否	int	时长(秒)

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/opinion/resourceSave
Response
{"status":200,"data":{"sorId":"4","userId":"1011","sosId":"1","type":"1","path":"https:\/\/oss.sewise.com\/45min.flv","duration":"45","creationDate":"2018-09-06 17:39:55","modifiedDate":"2018-09-06 17:58:59"}}

1.6 删除体验报告资源文件

接口地址

/v1/opinion/resourceRemove/{sorId}?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
sorId	是	int	资源id
access_token	是	string	用户鉴权码

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/opinion/resourceRemove/3
Response
{"status":200,"message":"\u5220\u9664\u6210\u529f","data":[]}

1.7 获取体验报告信息

接口地址

/v1/opinion/info/{sosId}?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
sosId	是	int	体验报告id

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/opinion/info
Response
{"status":200,"data":{"userId":"1011","username":"yanshan-teacher","nickName":"\u4e01\u7ea2\u8273","name":"\u706f\u5149\u8bed\u8a00","video":"https:\/\/oss.sewise.com\/video\/aqjyzl\/jcxz\/08.mp4","introduction":"\u4e2d\u56fd\u6bcf\u5929\u7ea6\u6709\u51e0\u767e\u513f\u7ae5\u56e0\u610f\u5916\u4f24\u5bb3\u6b7b\u4ea1\uff0c\u800c\u610f\u5916\u4f24\u5bb3\u4e5f\u662f\u5bfc\u81f4\u4f17\u591a\u513f\u7ae5\u4f24\u6b8b\u7684\u4e3b\u8981\u539f\u56e0\uff0c\u7ed9\u8fd9\u4e9b\u4f24\u6b8b\u513f\u7ae5\u7684\u672a\u6765\u9020\u6210\u4e86\u65e0\u9650\u7684\u75db\u82e6\u3002\u7247\u4e2d\u7684\u8b66\u8f66\u201c\u5c0f\u6cbb\u201d\u5e2e\u52a9\u4ed6\u7684\u7c73\u670b\u53cb\u201cmini\u7c73\u201d\u3001\u201c\u7c73\u5c0f\u9f99\u201d\u3001\u201c\u7c73\u5c14\u83ab\u65af\u201d\u505a\u51fa\u7684\u4e00\u4e9b\u5371\u9669\u884c\u4e3a\u8fdb\u884c\u7ea0\u6b63\u548c\u5b89\u5168\u6559\u80b2\uff0c\u5b89\u5168\u6559\u80b2\u5185\u5bb9\u5305\u62ec\uff1a\u4ea4\u901a\u5b89\u5168\u3001\u5bb6\u5ead\u751f\u6d3b\u5b89\u5168\u3001\u6821\u56ed\u5b89\u5168\u3001\u6237\u5916\u5b89\u5168\u3001\u5371\u9669\u7269\u5b89\u5168\u7b49\u3002\u5b89\u5168\u5185\u5bb9\u662f\u7d27\u56f4\u6c11\u4f17\u70ed\u70b9\u3001\u793e\u4f1a\u7126\u70b9\uff0c\u4ece\u73b0\u5b9e\u6848\u4f8b\u4e2d\u8fdb\u884c\u63d0\u70bc\uff0c\u5728\u52a8\u753b\u4e2d\u751f\u52a8\u7684\u8868\u73b0\u51fa\u6765\uff0c\u6bcf\u96c6\u7684\u5185\u5bb9\u8bb2\u8ff0\u4e00\u4e2a\u5b89\u5168\u95ee\u9898\uff0c\u6b63\u786e\u5f15\u5bfc\u5b69\u5b50\u884c\u4e3a\u5b89\u5168\uff0c\u907f\u514d\u73b0\u5b9e\u4e2d\u610f\u5916\u4f24\u5bb3\u7684\u53d1\u751f\u3002","opinionVideoList":[{"sorId":"1","path":"https:\/\/oss.sewise.com\/30min.flv","duration":"30","creationDate":"2018-09-06 17:39:55"}],"opinionAudioList":[{"sorId":"2","path":"https:\/\/oss.sewise.com\/45min.flv","duration":"45","creationDate":"2018-09-06 17:49:15"},{"sorId":"3","path":"https:\/\/www.baidu.com","duration":"16","creationDate":"2018-09-07 21:22:13"}],"comment":"\u6211\u7684\u4f53\u9a8c\u611f\u53d7....","product":"\u6551\u62a4\u8f66\u5c0f\u82b8","productId":"smleshop-jhxy-2018-0906-ab9da3d28ad0","diagram":"https:\/\/oss.sewise.com\/video\/toys\/jhcxy_diagram.jpg","price":"79.00"}}

1.8 我的体验列表

接口地址

/v1/opinion/myOpinionList?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
status	否	int	状态：0.未发布 1.已发布
page	否	int	页数
pageSize	否	int	页码
order	否	String	排序

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/opinion/myOpinionList
Response
{"status":200,"data":{"total_page":1,"page":1,"pagesize":20,"total_record":1,"record":[{"sosId":"1","title":"\u6551\u62a4\u8f66\u5c0f\u82b8","relationId":"2","status":"1","productId":"smleshop-jhxy-2018-0906-ab9da3d28ad0","product":"\u6551\u62a4\u8f66\u5c0f\u82b8","picture":"https:\/\/oss.sewise.com\/video\/toys\/jhcxy_picture.jpg"}]}}

1.9 生成小程序码

接口地址

/v1/common/qrcode

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
RequestBody
width	否	int	小程序码自定义的尺寸：默认64
page	否	string	必须是已经发布的小程序存在的页面（否则报错），例如 "pages/index/index" ,根路径前不要填加'/',不能携带参数（参数请放在scene字段里），如果不填写这个字段，默认跳主页面
t	否	int	对应type类型
u	否	int	对应userId用户id
w	否	int	对应toyId玩具id
s	否	int	对应sosId模板id

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/common/qrcode
Response

1.10 通过userId获取用户帐号、昵称

接口地址

/v1/common/getUserInfoByUserId/{userId}

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数

参数	必选	类型	说明
RequestBody

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/common/getUserInfoByUserId/30
Response
{"status":200,"data":[{"userId":"30","username":"jackyteacher1","nickName":"jackyteacher1"}]}

2.经济

2.1 我的账号情况 （收益 + 已提现 + 余额）

接口地址

/v1/wallet/myProfit?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数

参数	必选	类型	说明
RequestBody
access_token	是	string	用户授权码

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://v.sewise.com/v1/wallet/myProfit?access_token=fPodlcWfHfUfGiLhZ4rhw6Qyd2xjzUkoXXDRYlZA
Response
{"status":200,"data":{"activeAmount":"28.01","extractAmount":"0.00","incomeAmount":"0.05"}}
参数说明
"activeAmount":"可用金额",
"extractAmount":"已提现金额",
"incomeAmount":"总收入金额"

2.2 微信小程序下单

接口地址

/v1/wxpay/miniUnifiedOrder

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
access_token	是	String	用户授权签名
openid	否	String	用户openid，如果access_token没有则必须传
orderName	是	String	订单/商品描述
orderType	是	String	订单类型：normal(普通)，speech(语音识别)，course(课程)，swl(课时)，knowledge(知识点)，live(直播)，toy(玩具)
totalFee	是	decimal	订单金额(元)
deviceInfo	否	String	设备信息
productId	否	String	商品id(如course_id)
number	否	Int	数量
ip	否	String	终端IP
businessUserId	否	String	商家标识，如openid、userId
business	否	String	商家名称
distributorUserId	否	String	分享者userId
distributor	否	String	分享者昵称
relationId	否	String	关联Id(如分享链接id、推广链接id等)
relationUserId	否	String	关联者userId(渠道商、体验者、推广者)
relationtor	否	String	关联者名称
recipients	否	String	收件人
mobile	否	String	收件人联系方式
address	否	String	收货地址

HTTP 响应状态

200

接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://v.sewise.com/v1/wxpay/miniUnifiedOrder
Response
{"status":200,"message":"\u4e0b\u5355\u6210\u529f","data":{"appId":"wx1e77d8b41a555b54","nonceStr":"e4e01muc40v0ad593ea7dgmq2n66k4yr","package":"prepay_id=wx20171222113926b5a05da8a60215295518","signType":"MD5","timeStamp":"1513913966","paySign":"4F27E577A9B40303AA91E6380528A6FD"}}

2.3 我的支出账单

接口地址

/v1/order/buyList?access_token=xxxxx

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数

参数	必选	类型	说明
RequestBody
page	否	int	页数，默认1
pageSize	否	int	页码，默认20
order	否	String	排序：orderId desc
q	否	String	关键字搜索
orderType	否	int	订单类型：normal(普通)，speech(语音识别)，course(课程)，swl(课时)，knowledge(知识点)，live(直播)
payStatus	否	int	支付状态： 1.下单成功（未支付） 2.已支付
startTime	否	String	开始时间
endTime	否	String	结束时间

HTTP 响应状态

200

接口示例

Request
{"status":200,"data":{"total_page":1,"page":1,"pagesize":20,"total_record":1,"total_amount":"5.00","record":[{"orderId":"856","orderName":"\u7535\u529b\u7cfb\u7edf\u9884\u6d4b\u8bfe\u7a0b","outTradeNo":"1492814002201809071633291555","orderNo":"1492814002201809071633291555","orderType":"toy","payMode":"WXPAY","number":"2","totalFee":"4.50","originalFee":"5.00","payStatus":"2","tradeType":"JSAPI","userId":"628","productId":"79080a09-5147-417d-b0b6-23a8cddf29dc","payDate":null,"businessUserId":"1011","business":"\u4e01\u7ea2\u8273","creationDate":"2018-09-07 16:33:29","username":"yanshan-teacher","nickName":"\u4e01\u7ea2\u8273"}]}}

2.4 我的收入账单

接口地址

/v1/order/list?access_token=xxxxx

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数

参数	必选	类型	说明
RequestBody
page	否	int	页数，默认1
pageSize	否	int	页码，默认20
order	否	String	排序：orderId desc
q	否	String	关键字搜索
orderType	否	int	订单类型：normal(普通)，speech(语音识别)，course(课程)，swl(课时)，knowledge(知识点)，live(直播)，toy(玩具)
payStatus	否	int	支付状态： 1.下单成功（未支付） 2.已支付
startTime	否	String	开始时间
endTime	否	String	结束时间

HTTP 响应状态

200

接口示例

Request
{"status":200,"data":{"total_page":7,"page":1,"pagesize":"3","total_record":19,"total_amount":"76.94","record":[{"orderId":"856","orderName":"\u7535\u529b\u7cfb\u7edf\u9884\u6d4b\u8bfe\u7a0b","outTradeNo":"1492814002201809071633291555","orderNo":"1492814002201809071633291555","orderType":"toy","payMode":"WXPAY","number":"2","totalFee":"4.50","originalFee":"5.00","platformIncomeFee":"4.50","relationIncomeFee":"0.50","distributorIncomeFee":"0.00","payStatus":"2","tradeType":"JSAPI","userId":"628","productId":"79080a09-5147-417d-b0b6-23a8cddf29dc","payDate":null,"businessUserId":"1011","business":"\u4e01\u7ea2\u8273","distributorUserId":"","distributor":"","relationId":"45555","relationUserId":"469","relationtor":"\u534e\u4f01\u8001\u5e08","recipients":"\u8521\u98de","mobile":"0","address":"\u5730\u5740\u6587\u4ef6\u662f\u6e21\u52ab\u53d1\u751f\u7684\u53d1","creationDate":"2018-09-07 16:33:29","username":"44442","nickName":"44442"},{"orderId":"840","orderName":"\u7ec8\u7aef\u7ba1\u7406\u8005\uff1a\u81ea\u8eab\u4fee\u70bc","outTradeNo":"1492814002201805261131235270","orderNo":"1492814002201805261131235270","orderType":"course","payMode":"WXPAY","number":"1","totalFee":"1.00","originalFee":"1.00","platformIncomeFee":"0.00","relationIncomeFee":"0.00","distributorIncomeFee":"0.00","payStatus":"1","tradeType":"JSAPI","userId":"28335","productId":"71995aab-48dc-4df1-b64a-bd3f14adf428","payDate":null,"businessUserId":"469","business":"\u534e\u4f01\u8001\u5e08","distributorUserId":null,"distributor":null,"relationId":null,"relationUserId":null,"relationtor":null,"recipients":null,"mobile":"0","address":null,"creationDate":"2018-05-26 11:31:23","username":"wx_2018032854539757","nickName":"xwz"},{"orderId":"839","orderName":"\u5546\u6807\u53ca\u5546\u4e1a\u79d8\u5bc6\u98ce\u9669\u7ba1\u7406","outTradeNo":"1492814002201805221147112648","orderNo":"4200000140201805222835223307","orderType":"course","payMode":"WXPAY","number":"1","totalFee":"9.90","originalFee":"9.90","platformIncomeFee":"0.00","relationIncomeFee":"0.00","distributorIncomeFee":"0.00","payStatus":"2","tradeType":"NATIVE","userId":"500","productId":"e6c290ac-59d3-491c-ae76-2f7790970e6a","payDate":"2018-05-22 11:47:27","businessUserId":"469","business":"\u534e\u4f01\u8001\u5e08","distributorUserId":null,"distributor":null,"relationId":null,"relationUserId":null,"relationtor":null,"recipients":null,"mobile":"0","address":null,"creationDate":"2018-05-22 11:47:11","username":"sewise01","nickName":"eric"}]}}

2.5 销售订单

接口地址

/v1/manager/orderList?access_token=xxxxx

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数

参数	必选	类型	说明
RequestBody
page	否	int	页数，默认1
pageSize	否	int	页码，默认20
order	否	String	排序：orderId desc
q	否	String	关键字搜索
orderType	否	int	订单类型：normal(普通)，speech(语音识别)，course(课程)，swl(课时)，knowledge(知识点)，live(直播)，toy(玩具)
payStatus	否	int	支付状态： 1.下单成功（未支付） 2.已支付
startTime	否	String	开始时间
endTime	否	String	结束时间

HTTP 响应状态

200

接口示例

Request
{"status":200,"data":{"total_page":144,"page":1,"pagesize":"2","total_record":287,"total_amount":"2279.84","record":[{"orderId":"856","orderName":"\u7535\u529b\u7cfb\u7edf\u9884\u6d4b\u8bfe\u7a0b","outTradeNo":"1492814002201809071633291555","orderNo":"1492814002201809071633291555","orderType":"toy","number":"2","totalFee":"4.50","originalFee":"5.00","platformIncomeFee":"4.50","relationIncomeFee":"0.50","distributorIncomeFee":"0.00","payStatus":"2","userId":"628","username":"44442","nickName":"44442","payDate":null,"businessUserId":"1011","business":"\u4e01\u7ea2\u8273","distributorUserId":"","distributor":"","relationId":"45555","relationUserId":"469","relationtor":"\u534e\u4f01\u8001\u5e08","recipients":"\u8521\u98de","mobile":"1867557703","address":"\u5730\u5740\u6587\u4ef6\u662f\u6e21\u52ab\u53d1\u751f\u7684\u53d1","creationDate":"2018-09-07 16:33:29","businessUserName":"yanshan-teacher","distributorUserName":"","relationUserName":"huaqilaoshi"},{"orderId":"839","orderName":"\u5546\u6807\u53ca\u5546\u4e1a\u79d8\u5bc6\u98ce\u9669\u7ba1\u7406","outTradeNo":"1492814002201805221147112648","orderNo":"4200000140201805222835223307","orderType":"course","number":"1","totalFee":"9.90","originalFee":"9.90","platformIncomeFee":"0.00","relationIncomeFee":"0.00","distributorIncomeFee":"0.00","payStatus":"2","userId":"500","username":"sewise01","nickName":"eric","payDate":"2018-05-22 11:47:27","businessUserId":"469","business":"\u534e\u4f01\u8001\u5e08","distributorUserId":null,"distributor":null,"relationId":null,"relationUserId":null,"relationtor":null,"recipients":null,"mobile":null,"address":null,"creationDate":"2018-05-22 11:47:11","businessUserName":"huaqilaoshi","distributorUserName":"","relationUserName":""}]}}