[关闭]
@sewise-dev 2018-07-25T02:10:16.000000Z 字数 30969 阅读 933

大律司线上接口文档

大律司

更新历史

编号 版本 说明 作者 日期
1 v1.0 1.创建文档 Seven 2018-04-23

目录

【备注】

1. 全局返回码说明

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

返回码 说明
-1 系统繁忙，此时请开发者稍候再试
0 请求失败
1 请求成功
200 响应成功
403 禁止访问
404 异常错误
500 数据验证错误
40001 不合法的凭证，或者access_token无效。
40004 不合法请求

HTTP请求状态返回格式

返回字段 字段类型 说明
status Integer 请求返回码(详细请见状态表)
message String 返回描述
data Array 返回结果

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

1.用户

1.1 发送短信

接口地址

/v1/sms/send

HTTP Content-Type / 请求方式

application/json
POST

请求参数
参数 必选 类型 说明
RequestBody
mobile 是 String 手机号码
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.com/v1/sms/send
Response
{"status":200,"message":"\u53d1\u9001\u6210\u529f","data":{"mobile":"xxxx"}}

1.2 手机短信登录

接口地址

/v1/user/mobileAuth

HTTP Content-Type / 请求方式

application/json
POST

请求参数
参数 必选 类型 说明
RequestBody
mobile 是 String 手机号码
code 是 String 短信验证码
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.com/v1/user/mobileAuth
Response
{"status":200,"data":{"userId":"4","userType":"1","access_token":"u7SP5hgZcrUPrJJhbzCHhHodvTfcFBQXjoEovGsk","expire":"2018-05-23 16:21:37","userinfo":{"userId":"4","username":"18675577003","mobile":"18675577003","userType":"1","accountStatus":"1","access_token":"u7SP5hgZcrUPrJJhbzCHhHodvTfcFBQXjoEovGsk"}}}

1.3 设置密码

接口地址

/v1/user/reset?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户鉴权
password 是 String 密码
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.com/v1/user/reset
Response
{"status":200,"message":"\u5bc6\u7801\u91cd\u7f6e\u6210\u529f"}

1.4 关注/取消关注

接口地址

/v1/follow/change/{toUserId}?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户鉴权
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.com/v1/follow/change/3?access_token=xxx
Response
{"status":200,"data":{"status":1}}

1.5 我的关注

接口地址

/v1/follow/list?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户鉴权
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.com/v1/follow/list?access_token=xxx
Response
{"status":200,"data":[{"userId":"2","nickName":"test","avatar":"\/widgets\/assets\/images\/pic-b.png"},{"userId":"3","nickName":"test1","avatar":"\/widgets\/assets\/images\/pic-b.png"}]}

1.6 关注状态（专家）

接口地址

/v1/follow/status/{toUserId}?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户鉴权
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.com/v1/follow/status/3?access_token=xxx
Response
{"status":200,"data":{"status":-1}}

1.7 关注量(关注我的数量)

接口地址

/v1/follow/count?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户鉴权
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.com/v1/follow/count?access_token=xxx
Response
{"status":200,"data":{"count":1}}

1.8 上传证件照

接口地址

/v1/user/idCard?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户鉴权
cardPositive 是 String 正面照
cardBack 是 String 背面照
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.com/v1/user/idCard?access_token=xxx
Response
{"status":200,"message":"\u4fee\u6539\u6210\u529f"}

1.9 专家认证状态查询

接口地址

/v1/user/examineStatus?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户鉴权
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.com/v1/user/examineStatus?access_token=xxx
Response
审核状态 ：-2.未提交审核； -1.审核不通过; 0.审核中; 1.审核通过
{"status":200,"data":{"status":1,"content":"\u5ba1\u6838\u901a\u8fc7,\u4f46\u7f3a\u5c11\u8bc1\u4ef6\u7167"}}

1.10 用户详情

接口地址

/v1/user/userInfo?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户鉴权
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.com/v1/user/userInfo?access_token=xxx
Response
{"status":200,"data":{"userId":"4","username":"18675577003","mobile":"18675577003","userType":"1","vip":"1","creationDate":"2018-04-23 16:16:22","accountStatus":"1","expertRank":"0","lastLogin":"2018-05-10 17:02:53","isDelete":"N","from":null,"expireDate":"2019-05-10 17:02:53","fId":"4","nickName":"18675577003","address":null,"bindValue":null,"avatar":"","faceIn":null,"sex":"0","deviceCardId":null,"cardPositive":"http:\/\/oss.sewise.com\/sdf923xdp1320932324","cardBack":"http:\/\/oss.sewise.com\/923sd923isdofsidf1f23","poster":null,"expertVip":"0","expertVipPrice":"0.00","nickname":"18675577003","sn":"org_1_0_0_0_0","organId":"1","access_token":"u7SP5hgZcrUPrJJhbzCHhHodvTfcFBQXjoEovGsk"}}

2.支付

2.1 微信app下单

接口地址

/v1/wxpay/appUnifiedOrder

HTTP Content-Type / 请求方式

application/json
POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户授权签名
orderName 是 String 订单/商品描述
orderType 是 String 订单类型：normal(普通)，speech(语音识别)，course(课程)，swl(课时)，knowledge(知识点)，live(直播)，year（年卡），expert(专家vip)，gold(金卡vip)
totalFee 是 decimal 订单金额(元)
deviceInfo 否 String 设备信息
productId 否 String 商品id(如course_id)
ip 否 String 终端IP
businessUserId 否 String 商家标识，如openid、userId
business 否 String 商家名称
distributorUserId 否 String 分销商userId(多个用逗号隔开)
distributor 否 String 分销商(多个用逗号隔开)
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.cn/v1/wxpay/appUnifiedOrder
Response
{"status":200,"message":"\u4e0b\u5355\u6210\u529f","data":{"appid":"wxe1353733a25a225a",
"mch_id":"1492814002",
"nonce_str":"hjSWcBSiyfALsK0l",
"prepay_id":"wx201711251204331029b23fcd0292945536",
"result_code":"SUCCESS",
"return_code":"SUCCESS",
"return_msg":"OK",
"sign":"BDB2B3F9E897B0F87D39EA3CB3D6D31F",
"trade_type":"APP"}}

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(直播)，year（年卡），expert(专家vip)，gold(金卡vip)
totalFee 是 decimal 订单金额(元)
deviceInfo 否 String 设备信息
productId 否 String 商品id(如course_id)
ip 否 String 终端IP
businessUserId 否 String 商家标识，如openid、userId
business 否 String 商家名称
distributorUserId 否 String 分销商userId(多个用逗号隔开)
distributor 否 String 分销商(多个用逗号隔开)
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.cn/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/wxpay/rechargeOrder

HTTP Content-Type / 请求方式

application/json
POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户授权签名
orderName 是 String 充值订单描述
totalFee 是 decimal 充值金额(元)
productId 否 String 商品id(如course_id)
payMode 否 String 支付方式：WXPAY，WXPAY_APPPAY（默认）
tradeType 否 String 交易类型：JSAPI，NATIVE，WAP， APP(默认)
openid 否 String 用户openid，如果access_token没有则必须传
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.cn/v1/wxpay/rechargeOrder
Response
{"status":200,"message":"\u4e0b\u5355\u6210\u529f","data":{"appId":"wxd7b1891e25bf5a80","nonceStr":"5jaHT1Vr7Y1xGz5N","packageValue":"Sign=WXPay","partnerId":"1500771661","prepayId":"wx08134658511003b8ad03633f3162091094","timeStamp":1525758418,"sign":"AD5D18ECAC92F5904A0F9F3A7344C634"}}

2.4 企业付款到零钱

接口地址

/v1/wxpay/transfers

HTTP Content-Type / 请求方式

application/json
POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户授权签名
amount 是 double 金额(元)
password 是 String 支付密码
desc 否 String 提现描述
productId 否 String 商品ID
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://api.dlaws.cn/v1/wxpay/transfers
Response
{"status":200,"message":"\u63d0\u73b0\u6210\u529f","data":{"return_code":"SUCCESS","return_msg":[],"mch_appid":"wxac1f7451bde060d5","mchid":"1220703901","nonce_str":"qr9r13gt5k9ky050o809m7lkn58l5k2d","result_code":"SUCCESS","partner_trade_no":"1500771661201805101622175138","payment_no":"1000018301201805107628806975","payment_time":"2018-05-10 16:22:18"}}

3.账单

3.1 我的购买

接口地址

/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(直播)，year(年卡)，expert(专家vip)
payStatus 否 int 支付状态： 1.下单成功（未支付） 2.已支付
startTime 否 String 开始时间
endTime 否 String 结束时间
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
{"status":200,"data":{"total_page":1,"page":"1","pagesize":"20","total_record":1,"record":[{"orderId":"15","orderName":"\u7535\u529b\u7cfb\u7edf\u9884\u6d4b\u8bfe\u7a0b","outTradeNo":"1398036302201710181459265747","orderNo":"1398036302201710181459265747","orderType":"course","payMode":"WXPAY","totalFee":"0.01","payStatus":"2","tradeType":"NATIVE","product_id":null,"payDate":"2017-10-18 14:59:26","businessUserId":"1011","business":"\u4e01\u7ea2\u8273","creationDate":"2017-10-18 14:59:26"}]}}

3.2 我的账单

接口地址

/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(直播)，year(年卡)，expert(专家vip)
payStatus 否 int 支付状态： 1.下单成功（未支付） 2.已支付
startTime 否 String 开始时间
endTime 否 String 结束时间
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
{"status":200,"data":{"total_page":1,"page":"1","pagesize":"20","total_record":1,"total_amount":"0.01","record":[{"orderId":"15","orderName":"\u7535\u529b\u7cfb\u7edf\u9884\u6d4b\u8bfe\u7a0b","outTradeNo":"1398036302201710181459265747","orderNo":"1398036302201710181459265747","orderType":"course","payMode":"WXPAY","totalFee":"0.01","payStatus":"2","tradeType":"NATIVE","userId":"628","productId":null,"payDate":"2017-10-18 14:59:26","businessUserId":"761","business":"\u4e01\u7ea2\u8273","creationDate":"2017-10-18 14:59:26","username":"44442","nickName":"44442"}]}}

3.3 订单详情

接口地址

/v1/order/info?access_token=xxxxx

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数
参数 必选 类型 说明
RequestBody
orderId 否 String 订单号
productId 否 String 商品id
q 否 String 关键字搜索
orderType 否 int 订单类型：normal(普通)，speech(语音识别)，course(课程)，swl(课时)，knowledge(知识点)，live(直播)，year(年卡)，expert(专家vip)
payStatus 否 int 支付状态： 1.下单成功（未支付） 2.已支付
startTime 否 String 开始时间
endTime 否 String 结束时间
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
{"status":200,"data":{"orderId":"16","orderName":"\u7535\u529b\u7cfb\u7edf\u9884\u6d4b\u8bfe\u7a0b","outTradeNo":"1398036302201710181744315652","orderNo":"1398036302201710181744315652","orderType":"course","payMode":"WXPAY","totalFee":"0.01","payStatus":"1","tradeType":"NATIVE","productId":"79080a09-5147-417d-b0b6-23a8cddf29dc","payDate":null,"businessUserId":"1011","business":"\u4e01\u7ea2\u8273","creationDate":"2017-10-18 17:44:31"}}

3.4 账单导出

接口地址

/v1/order/export/{type}?access_token=xxxxx

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数
参数 必选 类型 说明
RequestBody
type 是 string 导出业务： 收入orderList、支出buyList
order 否 String 排序：orderId desc
q 否 String 关键字搜索
orderType 否 int 订单类型：normal(普通)，speech(语音识别)，course(课程)，swl(课时)，knowledge(知识点)，live(直播)，year(年卡)，expert(专家vip)
payStatus 否 int 支付状态： 1.下单成功（未支付） 2.已支付
startTime 否 String 开始时间
endTime 否 String 结束时间
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
{"status":200,"data":{"total_page":1,"page":"1","pagesize":"20","total_record":1,"total_amount":"0.01","record":[{"orderId":"15","orderName":"\u7535\u529b\u7cfb\u7edf\u9884\u6d4b\u8bfe\u7a0b","outTradeNo":"1398036302201710181459265747","orderNo":"1398036302201710181459265747","orderType":"course","payMode":"WXPAY","totalFee":"0.01","payStatus":"2","tradeType":"NATIVE","userId":"628","productId":null,"payDate":"2017-10-18 14:59:26","businessUserId":"761","business":"\u4e01\u7ea2\u8273","creationDate":"2017-10-18 14:59:26","username":"44442","nickName":"44442"}]}}

3.5 我购买了什么

接口地址

/v1/order/boughtList?access_token=xxxxx

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数
参数 必选 类型 说明
RequestBody
orderType 是 int 订单类型：normal(普通)，speech(语音识别)，course(课程)，swl(课时)，knowledge(知识点)，live(直播)，year(年卡)，expert(专家vip)
payStatus 是 int 支付状态： 1.下单成功（未支付） 2.已支付
startTime 否 String 开始时间
endTime 否 String 结束时间
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
{"status":200,"data":{"79080a09-5147-417d-b0b6-23a8cddf29dc":{"payStatus":"2"},"79080a09-5147-417d-b0b6-23a8cddf2133":{"payStatus":"2"}}}

3.6 销售量

接口地址

/v1/order/sales

HTTP Content-Type / 请求方式

application/json
POST

请求参数
参数 必选 类型 说明
RequestBody
productId 是 string 商品ids，多个用“，”隔开
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
{"status":200,"data":[{"productId":"79080a09-5147-417d-b0b6-23a8cddf29dc","sales":0},{"productId":"79080a09-5147-417d-b0b6-23a8cddf29dc","sales":0}]}

3.7 充值/提现明细

接口地址

/v1/order/accessList/{type}

HTTP Content-Type / 请求方式

application/json
POST

请求参数
参数 必选 类型 说明
RequestBody
type 是 string 类型： 1. 充值 2.提现
access_token 是 string 用户鉴权码
page 否 int 页数
pageSize 否 int 页码
order 否 string 排序：默认orderId DESC
q 否 string 关键词搜索
payStatus 否 string 支付状态：1.未支付 2.已支付(默认)
startTime 否 string 开始时间（2018-05-08 15:03:29）
endTime 否 string 开始时间（2018-05-08 15:03:29）
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
{"status":200,"data":{"total_page":1,"page":1,"pagesize":20,"total_record":1,"total_amount":"28.00","record":[{"orderName":"40\u5143=28\u77e5\u8bc6\u5e01","totalFee":"28.00","label":"\u82f9\u679c\u5546\u5e97","otherId":null,"productId":"com.sewise.weilubo.KnowledgeYuan5","payDate":"2018-05-08 12:26:01"}]}}

4. App store

4.1 内购产品标识列表

接口地址

/v1/appstore/InAppProductList

HTTP Content-Type

application/json

HTTP 请求方式

GET/POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 用户access_token
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"data":[{"id":"1","productId":"com.sewise.weilubo.KnowledgeYuan2","referenceName":"1\u5143=0.7\u77e5\u8bc6\u5e01","actualObtain":"0.70","originalObtain":"1.00","creationDate":"2018-04-13 11:33:20"},{"id":"2","productId":"com.sewise.weilubo.KnowledgeYuan3","referenceName":"6\u5143=4.2\u77e5\u8bc6\u5e01","actualObtain":"4.20","originalObtain":"6.00","creationDate":"2018-04-13 11:33:20"},{"id":"3","productId":"com.sewise.weilubo.KnowledgeYuan4","referenceName":"18\u5143=12.6\u77e5\u8bc6\u5e01","actualObtain":"12.60","originalObtain":"18.00","creationDate":"2018-04-13 11:33:20"},{"id":"4","productId":"com.sewise.weilubo.KnowledgeYuan5","referenceName":"40\u5143=28\u77e5\u8bc6\u5e01","actualObtain":"28.00","originalObtain":"40.00","creationDate":"2018-04-13 11:33:20"},{"id":"5","productId":"com.sewise.weilubo.KnowledgeYuan6","referenceName":"108\u5143=75.6\u77e5\u8bc6\u5e01","actualObtain":"75.60","originalObtain":"108.00","creationDate":"2018-04-13 11:33:20"},{"id":"6","productId":"com.sewise.weilubo.KnowledgeYuan7","referenceName":"518\u5143=362.6\u77e5\u8bc6\u5e01","actualObtain":"362.60","originalObtain":"518.00","creationDate":"2018-04-13 11:33:20"}]}

4.2 验证appstore内购票据（充值）

接口地址

/v1/appstore/validateApplePay

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 用户access_token
receiptData 是 string appstore支付收据串
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"message":"\u8d2d\u4e70\u6210\u529f","data":{"status":0,"environment":"Sandbox","sandbox":"1","recharge_amount":28}}

5. 钱包

5.1 我的钱包

接口地址

/v1/wallet/my

HTTP Content-Type

application/json

HTTP 请求方式

POST/GET

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 用户access_token
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"data":{"awId":"1","userId":"5","type":"1","status":"1","freezingAmount":"0.00","activeAmount":"55.97","password":true,"creationDate":"2018-04-16 15:37:29","modifiedDate":"2018-04-17 14:59:30"}}

5.2 设置/重置支付密码

接口地址

/v1/wallet/resetPass

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 用户access_token
password 是 string 密码
oldPassword 否 string 旧密码（重置时需传）
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"message":"\u5bc6\u7801\u91cd\u7f6e\u6210\u529f"}

5.3 钱包下单支付

接口地址

/v1/wallet/pay

HTTP Content-Type / 请求方式

application/json
POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户授权签名
password 是 String 支付密码
orderName 是 String 订单/商品描述
orderType 是 String 订单类型：normal(普通)，speech(语音识别)，course(课程)，swl(课时)，knowledge(知识点)，live(直播)，year(年卡)，expert(专家vip)，gold(金卡vip)
tradeType 否 String 交易类型：（JSAPI，NATIVE，WAP, APP等）
totalFee 是 decimal 订单金额(元)
deviceInfo 否 String 设备信息
productId 否 String 商品id(如course_id)
ip 否 String 终端IP
businessUserId 否 String 商家标识，如openid、userId
business 否 String 商家名称
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://api.sewise.com/v1/wallet/pay?access_token=xxx
Response
{"status":200,"message":"\u4e0b\u5355\u6210\u529f\uff0c\u5df2\u652f\u4ed8"}

5.3 检验绑定的提现方式

接口地址

/v1/wallet/checkBindDrawMode

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 String 用户授权签名
HTTP 响应状态

200

返回字段 字段类型 说明
status int 返回状态码
message String 返回错误信息
data Array 返回结果
接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://api.sewise.com/v1/wallet/checkBindDrawMode?access_token=xxx
Response
{"status":200,"data":{"weixin":1,"alipay":0}}

6. 银行卡

6.1 通过卡号获取银行卡信息

接口地址

/v1/bank/info

HTTP Content-Type

application/json

HTTP 请求方式

POST/GET

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 用户access_token
encBankNo 是 string 银行卡号
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"data":{"encValidated":true,"encBankNo":"6217007200010095282","encBankShort":"CCB","encBankName":"\u4e2d\u56fd\u5efa\u8bbe\u94f6\u884c","encBankImg":"https:\/\/apimg.alipay.com\/combo.png?d=cashier&t=CCB","encCardType":"DC","encCardTypeName":"\u50a8\u84c4\u5361"}}

6.2 绑定银行卡

接口地址

/v1/bank/bind

HTTP Content-Type

application/json

HTTP 请求方式

POST/GET

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 用户access_token
encBankNo 是 string 银行卡号
encTrueName 是 string 银行卡号
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"data":{"encId":"1","encBankNo":"6217007200010095282","encBankShort":"CCB","encBankName":"\u4e2d\u56fd\u5efa\u8bbe\u94f6\u884c","encTrueName":"\u8521\u98de","encCardType":"DC","encValidated":"1","userId":"4","creationDate":"2018-05-09 11:20:55","modifiedDate":"2018-05-09 11:20:55"}}

6.3 绑定银行卡列表

接口地址

/v1/bank/list

HTTP Content-Type

application/json

HTTP 请求方式

POST/GET

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 用户access_token
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"data":{"total_page":1,"page":1,"pagesize":20,"total_record":1,"record":[{"encBankNo":"6217007200010095282","encBankShort":"CCB","encBankName":"\u4e2d\u56fd\u5efa\u8bbe\u94f6\u884c","encTrueName":"\u8521\u98de","encCardType":"DC","encValidated":"1"}]}}

6.4 提现到银行卡

接口地址

/v1/wxpay/payBank

HTTP Content-Type

application/json

HTTP 请求方式

POST/GET

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 用户access_token
amount 是 double 提现金额（元）
encId 是 int 银行卡在平台的编号
password 是 string 钱包支付密码
desc 否 string 提现描述
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":404,"message":"\u63d0\u73b0\u7533\u8bf7\u5931\u8d25","data":{"return_code":"SUCCESS","return_msg":"\u4ea7\u54c1\u6743\u9650\u9a8c\u8bc1\u5931\u8d25,\u8bf7\u67e5\u770b\u60a8\u5f53\u524d\u662f\u5426\u5177\u6709\u8be5\u4ea7\u54c1\u7684\u6743\u9650","result_code":"FAIL","err_code":"NO_AUTH","err_code_des":"\u4ea7\u54c1\u6743\u9650\u9a8c\u8bc1\u5931\u8d25,\u8bf7\u67e5\u770b\u60a8\u5f53\u524d\u662f\u5426\u5177\u6709\u8be5\u4ea7\u54c1\u7684\u6743\u9650","mch_id":"1220703901"}}

7. 私人专家服务

7.1 是否购买该私人专家服务

接口地址

/v1/expert/ticket/{toUserId}?access_token={access_token}

HTTP Content-Type

application/json

HTTP 请求方式

POST/GET

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 用户access_token
toUserId 是 int 专家userId
type 否 int 专家服务类型： 1. 银卡 2.金卡
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"message":"\u5df2\u8d2d\u4e70","data":{"userId":"2","toUserId":"1001","expireDate":"2019-05-15 14:13:41"}}

7.2 我的私人专家服务

接口地址

/v1/expert/myList?access_token={access_token}

HTTP Content-Type

application/json

HTTP 请求方式

POST/GET

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 用户access_token
page 否 int 页数
pageSize 否 int 页码
order 否 string 排序：默认aes.userId DESC
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"data":{"total_page":1,"page":1,"pagesize":20,"total_record":1,"record":[{"userId":"1","nickName":"\u8d85\u7ea7\u7ba1\u7406\u5458","avatar":"\/widgets\/assets\/images\/pic-b.png","expireDate":"2019-05-15 14:13:41"}]}}

7.3 检查专家vip状态

接口地址

/v1/expert/checkVipStatus/{toUserId}?access_token={access_token}

HTTP Content-Type

application/json

HTTP 请求方式

POST/GET

请求参数
参数 必选 类型 说明
RequestBody
toUserId 是 int 专家userId
access_token 是 string 用户access_token
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"data":{"expertVip":"0","expertVipPrice":"0.00"}}

7.4 vip价格列表

接口地址

/v1/expert/viplist

HTTP Content-Type

application/json

HTTP 请求方式

GET

HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status": 200,"data": [{"name": "开通VIP，一年全免费","price": "10"}]}

8. 小程序

8.1 小程序绑定手机

接口地址

/v1/weixin/bindAccount

HTTP Content-Type

application/json

HTTP 请求方式

POST/GET

请求参数
参数 必选 类型 说明
RequestBody
access_token 是 string 小程序当前用户access_token
mobile 是 int 手机号
code 是 int 短信验证码
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"message":"\u7ed1\u5b9a\u6210\u529f"}

9. 位置

9.1 全国城市列表

接口地址

/v1/city/list

HTTP Content-Type

application/json

HTTP 请求方式

POST/GET

请求参数
参数 必选 类型 说明
RequestBody
keyword 否 string 搜索关键词
HTTP 响应状态

200

返回字段 字段类型 说明
status int 状态码
data array 当前提交的内容

返回示例
{"status":200,"data":{"A":["\u963f\u575d","\u963f\u62c9\u5584","\u963f\u91cc","\u5b89\u5eb7","\u5b89\u5e86","\u978d\u5c71","\u5b89\u987a","\u5b89\u9633","\u6fb3\u95e8"],"B":["\u5317\u4eac","\u767d\u94f6","\u4fdd\u5b9a","\u5b9d\u9e21","\u4fdd\u5c71","\u5305\u5934","\u5df4\u4e2d","\u5317\u6d77","\u868c\u57e0","\u672c\u6eaa","\u6bd5\u8282","\u6ee8\u5dde","\u767e\u8272","\u4eb3\u5dde"],"C":["\u91cd\u5e86","\u6210\u90fd","\u957f\u6c99","\u957f\u6625","\u6ca7\u5dde","\u5e38\u5fb7","\u660c\u90fd","\u957f\u6cbb","\u5e38\u5dde","\u5de2\u6e56","\u6f6e\u5dde","\u627f\u5fb7","\u90f4\u5dde","\u8d64\u5cf0","\u6c60\u5dde","\u5d07\u5de6","\u695a\u96c4","\u6ec1\u5dde","\u671d\u9633"],"D":["\u5927\u8fde","\u4e1c\u839e","\u5927\u7406","\u4e39\u4e1c","\u5927\u5e86","\u5927\u540c","\u5927\u5174\u5b89\u5cad","\u5fb7\u5b8f","\u5fb7\u9633","\u5fb7\u5dde","\u5b9a\u897f","\u8fea\u5e86","\u4e1c\u8425"],"E":["\u9102\u5c14\u591a\u65af","\u6069\u65bd","\u9102\u5dde"],"F":["\u798f\u5dde","\u9632\u57ce\u6e2f","\u4f5b\u5c71","\u629a\u987a","\u629a\u5dde","\u961c\u65b0","\u961c\u9633"],"G":["\u5e7f\u5dde","\u6842\u6797","\u8d35\u9633","\u7518\u5357","\u8d63\u5dde","\u7518\u5b5c","\u5e7f\u5b89","\u5e7f\u5143","\u8d35\u6e2f","\u679c\u6d1b"],"H":["\u676d\u5dde","\u54c8\u5c14\u6ee8","\u5408\u80a5","\u6d77\u53e3","\u547c\u548c\u6d69\u7279","\u6d77\u5317","\u6d77\u4e1c","\u6d77\u5357","\u6d77\u897f","\u90af\u90f8","\u6c49\u4e2d","\u9e64\u58c1","\u6cb3\u6c60","\u9e64\u5c97","\u9ed1\u6cb3","\u8861\u6c34","\u8861\u9633","\u6cb3\u6e90","\u8d3a\u5dde","\u7ea2\u6cb3","\u6dee\u5b89","\u6dee\u5317","\u6000\u5316","\u6dee\u5357","\u9ec4\u5188","\u9ec4\u5357","\u9ec4\u5c71","\u9ec4\u77f3","\u60e0\u5dde","\u846b\u82a6\u5c9b","\u547c\u4f26\u8d1d\u5c14","\u6e56\u5dde","\u83cf\u6cfd"],"J":["\u6d4e\u5357","\u4f73\u6728\u65af","\u5409\u5b89","\u6c5f\u95e8","\u7126\u4f5c","\u5609\u5174","\u5609\u5cea\u5173","\u63ed\u9633","\u5409\u6797","\u91d1\u660c","\u664b\u57ce","\u666f\u5fb7\u9547","\u8346\u95e8","\u8346\u5dde","\u91d1\u534e","\u6d4e\u5b81","\u664b\u4e2d","\u9526\u5dde","\u4e5d\u6c5f","\u9152\u6cc9"],"K":["\u6606\u660e","\u5f00\u5c01"],"L":["\u5170\u5dde","\u62c9\u8428","\u6765\u5bbe","\u83b1\u829c","\u5eca\u574a","\u4e50\u5c71","\u51c9\u5c71","\u8fde\u4e91\u6e2f","\u804a\u57ce","\u8fbd\u9633","\u8fbd\u6e90","\u4e3d\u6c5f","\u4e34\u6ca7","\u4e34\u6c7e","\u4e34\u590f","\u4e34\u6c82","\u6797\u829d","\u4e3d\u6c34","\u516d\u5b89","\u516d\u76d8\u6c34","\u67f3\u5dde","\u9647\u5357","\u9f99\u5ca9","\u5a04\u5e95","\u6f2f\u6cb3","\u6d1b\u9633","\u6cf8\u5dde","\u5415\u6881"],"M":["\u9a6c\u978d\u5c71","\u8302\u540d","\u7709\u5c71","\u6885\u5dde","\u7ef5\u9633","\u7261\u4e39\u6c5f"],"N":["\u5357\u4eac","\u5357\u660c","\u5357\u5b81","\u5b81\u6ce2","\u5357\u5145","\u5357\u5e73","\u5357\u901a","\u5357\u9633","\u90a3\u66f2","\u5185\u6c5f","\u5b81\u5fb7","\u6012\u6c5f"],"P":["\u76d8\u9526","\u6500\u679d\u82b1","\u5e73\u9876\u5c71","\u5e73\u51c9","\u840d\u4e61","\u8386\u7530","\u6fee\u9633"],"Q":["\u9752\u5c9b","\u9ed4\u4e1c\u5357","\u9ed4\u5357","\u9ed4\u897f\u5357","\u5e86\u9633","\u6e05\u8fdc","\u79e6\u7687\u5c9b","\u94a6\u5dde","\u9f50\u9f50\u54c8\u5c14","\u6cc9\u5dde","\u66f2\u9756","\u8862\u5dde"],"R":["\u65e5\u5580\u5219","\u65e5\u7167"],"S":["\u4e0a\u6d77","\u6df1\u5733","\u82cf\u5dde","\u6c88\u9633","\u77f3\u5bb6\u5e84","\u4e09\u95e8\u5ce1","\u4e09\u660e","\u4e09\u4e9a","\u5546\u6d1b","\u5546\u4e18","\u4e0a\u9976","\u5c71\u5357","\u6c55\u5934","\u6c55\u5c3e","\u97f6\u5173","\u7ecd\u5174","\u90b5\u9633","\u5341\u5830","\u6714\u5dde","\u56db\u5e73","\u7ee5\u5316","\u9042\u5b81","\u968f\u5dde","\u5bbf\u8fc1","\u5bbf\u5dde"],"T":["\u5929\u6d25","\u592a\u539f","\u6cf0\u5b89","\u6cf0\u5dde","\u53f0\u5dde","\u5510\u5c71","\u5929\u6c34","\u94c1\u5cad","\u94dc\u5ddd","\u901a\u5316","\u901a\u8fbd","\u94dc\u9675","\u94dc\u4ec1","\u53f0\u6e7e"],"W":["\u6b66\u6c49","\u4e4c\u9c81\u6728\u9f50","\u65e0\u9521","\u5a01\u6d77","\u6f4d\u574a","\u6587\u5c71","\u6e29\u5dde","\u4e4c\u6d77","\u829c\u6e56","\u4e4c\u5170\u5bdf\u5e03","\u6b66\u5a01","\u68a7\u5dde"],"X":["\u53a6\u95e8","\u897f\u5b89","\u897f\u5b81","\u8944\u6a0a","\u6e58\u6f6d","\u6e58\u897f","\u54b8\u5b81","\u54b8\u9633","\u5b5d\u611f","\u90a2\u53f0","\u65b0\u4e61","\u4fe1\u9633","\u65b0\u4f59","\u5ffb\u5dde","\u897f\u53cc\u7248\u7eb3","\u5ba3\u57ce","\u8bb8\u660c","\u5f90\u5dde","\u9999\u6e2f","\u9521\u6797\u90ed\u52d2","\u5174\u5b89"],"Y":["\u94f6\u5ddd","\u96c5\u5b89","\u5ef6\u5b89","\u5ef6\u8fb9","\u76d0\u57ce","\u9633\u6c5f","\u9633\u6cc9","\u626c\u5dde","\u70df\u53f0","\u5b9c\u5bbe","\u5b9c\u660c","\u5b9c\u6625","\u8425\u53e3","\u76ca\u9633","\u6c38\u5dde","\u5cb3\u9633","\u6986\u6797","\u8fd0\u57ce","\u4e91\u6d6e","\u7389\u6811","\u7389\u6eaa","\u7389\u6797"],"Z":["\u90d1\u5dde","\u6742\u591a\u53bf","\u8d5e\u7687\u53bf","\u67a3\u5f3a\u53bf","\u67a3\u9633\u5e02","\u67a3\u5e84","\u6cfd\u5e93\u53bf","\u589e\u57ce\u5e02","\u66fe\u90fd\u533a","\u6cfd\u666e\u53bf","\u6cfd\u5dde\u53bf","\u672d\u8fbe\u53bf","\u624e\u8d49\u7279\u65d7","\u624e\u5170\u5c6f\u5e02","\u624e\u9c81\u7279\u65d7","\u624e\u56ca\u53bf","\u5f20\u5317\u53bf","\u5f20\u5e97\u533a","\u7ae0\u8d21\u533a","\u5f20\u5bb6\u6e2f","\u5f20\u5bb6\u754c","\u5f20\u5bb6\u53e3","\u6f33\u5e73\u5e02","\u6f33\u6d66\u53bf","\u7ae0\u4e18\u5e02","\u6a1f\u6811\u5e02","\u5f20\u6e7e\u533a","\u5f70\u6b66\u53bf","\u6f33\u53bf","\u5f20\u6396","\u6f33\u5dde","\u957f\u5b50\u53bf","\u6e5b\u6cb3\u533a","\u6e5b\u6c5f","\u7ad9\u524d\u533a","\u6cbe\u76ca\u53bf","\u8bcf\u5b89\u53bf","\u53ec\u9675\u533a","\u662d\u5e73\u53bf","\u8087\u5e86","\u662d\u901a","\u8d75\u53bf","\u662d\u9633\u533a","\u62db\u8fdc\u5e02","\u8087\u6e90\u53bf","\u8087\u5dde\u53bf","\u67de\u6c34\u53bf","\u67d8\u57ce\u53bf","\u6d59\u6c5f","\u9547\u5b89\u53bf","\u632f\u5b89\u533a","\u9547\u5df4\u53bf","\u6b63\u5b89\u53bf","\u6b63\u5b9a\u53bf","\u6b63\u5b9a\u65b0\u533a","\u6b63\u84dd\u65d7","\u6b63\u5b81\u53bf","\u84b8\u6e58\u533a","\u6b63\u9576\u767d\u65d7","\u6b63\u9633\u53bf","\u9547\u6d77\u533a","\u9547\u6c5f","\u6d48\u6c5f\u533a","\u9547\u5eb7\u53bf","\u9547\u8d49\u53bf","\u9547\u5e73\u53bf","\u632f\u5174\u533a","\u9547\u96c4\u53bf","\u9547\u539f\u53bf","\u5fd7\u4e39\u53bf","\u6cbb\u591a\u53bf","\u829d\u7f58\u533a","\u679d\u6c5f\u5e02","\u82b7\u6c5f\u4f97\u65cf\u81ea\u6cbb\u53bf","\u7ec7\u91d1\u53bf","\u4e2d\u65b9\u53bf","\u4e2d\u6c5f\u53bf","\u949f\u697c\u533a","\u4e2d\u725f\u53bf","\u4e2d\u5b81\u53bf","\u4e2d\u5c71","\u4e2d\u5c71\u533a","\u949f\u5c71\u533a","\u949f\u5c71\u53bf","\u4e2d\u536b","\u949f\u7965\u5e02","\u4e2d\u9633\u53bf","\u4e2d\u539f\u533a","\u5468\u6751\u533a","\u5468\u53e3","\u5468\u5b81\u53bf","\u821f\u66f2\u53bf","\u821f\u5c71","\u5468\u81f3\u53bf","\u5e84\u6cb3\u5e02","\u8bf8\u57ce\u5e02","\u73e0\u6d77","\u73e0\u6656\u533a","\u8bf8\u66a8\u5e02","\u9a7b\u9a6c\u5e97","\u51c6\u683c\u5c14\u65d7","\u6dbf\u9e7f\u53bf","\u5353\u5c3c","\u6dbf\u5dde\u5e02","\u5353\u8d44\u53bf","\u73e0\u5c71\u533a","\u7af9\u5c71\u53bf","\u7af9\u6eaa\u53bf","\u682a\u6d32","\u682a\u6d32\u53bf","\u6dc4\u535a","\u5b50\u957f\u53bf","\u6dc4\u5ddd\u533a","\u81ea\u8d21","\u79ed\u5f52\u53bf","\u7d2b\u91d1\u53bf","\u81ea\u6d41\u4e95\u533a","\u8d44\u6eaa\u53bf","\u8d44\u5174\u5e02","\u8d44\u9633"]}}

添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注