购买付费内容API
获取可分销商品列表
功能
获取可购买的商品列表(所需购买的商品,需线下与商务人员确认)
接口请求调用
/vip/product/list
HTTP请求方式:POST
授权方式:应用授权
https://open-platform-test.dushu365.com/vip/product/list?appid=fd0cac7cd6726d1111&sign=82536892cee554f566a4c45e61b573bdb43dw496&access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJBTEwiXSwiZXhwIjoxNTY2NDc2OTQ0LCJqdGkiOiI4NzYxNmMwNC1mMWI3LTRhNWEtYjY1OS05NGIwNWUyZTMwNzQiLCJjbGllbnRfaWfiOiJmZDBjYWM3Y2Q2NzI2ZDIxMWYifQ.K3zwm1NLbYe8KK4JyvueFrCcPnGTrXX1S9PelnOWLCk
参数说明
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
type | Integer | 否 | 获取商品类型:1-樊登讲书会期,2-书籍包,3-单本,4-定制会员,5 课程, 6 非凡单本,7 非凡专辑, 8-非凡会期,9-训练营 10 跨sku打包 11 课程合集 12 李蕾慢读会期,默认为1 |
pageNo | Integer | 否 | 分页参数,页数,不传默认1 |
pageSize | Integer | 否 | 分页参数,每页数,不传默认10 |
调用示例一(会期商品)
{
"type":1
}
示例返回一
{
"data": [
{
"price": 188,
"productName": "会期商品-6个月",
"productNo": 200000147,
"remark": "会期直充-6个月",
"vipUnit": 2,
"vipValue": 6,
"id":210
},
{
"price": 99,
"productName": "会期商品-3个月",
"productNo": 200000146,
"remark": "会期直充-3个月",
"vipUnit": 2,
"vipValue": 3,
"id":211
},
{
"price": 365,
"productName": "会期商品-1年",
"productNo": 200000148,
"remark": "会期直充-1年",
"vipUnit": 1,
"vipValue": 1,
"id":212
}
],
"msg": "操作成功!",
"status": "0000",
"systemMsg": "服务调用成功!",
"systemTime": 1566386261807
}
返回参数说明一
参数 | 类型 | 说明 |
---|---|---|
data | JSONArray | |
data.productNo | Integer | 会期商品编号 |
data.productName | String | 商品名称 |
data.price | decimal | 价格(单位:元) |
data.vipValue | Integer | 会期值 |
data.vipUnit | Integer | 会期单位(1:年;2:月;3:日) |
data.remark | String | 商品描述 |
data.id | Integer | 会期商品三方ID |
调用示例二(书籍包商品)
{
"type":2
}
示例返回二
{
"data": [
{
"albumThrid": "C25",
"discountPrice": 12.00,
"freeProgramCount": 0,
"intro": "111111111111111111111111111112",
"iosDiscountPrice": 16.00,
"iosPrice": 14.00,
"label": [
"2",
"标签"
],
"largeUrl": "https://cdn-ali-images-test.dushu365.com/15892764481683c9bfda27cb877a5c2c8f42ab1a5ct5k14w",
"notice": "234333",
"pay": true,
"price": 10.00,
"programCount": 72,
"publishTime": 1588971600000,
"readingCrowd": "1,renqun",
"samllUrl": "https://cdn-ali-images-test.dushu365.com/15892764385308317a5379caa8118da488cc693d4ehjj01j",
"speaker": "11111111",
"subTitle": "111111111111111111111111111112",
"title": "111111111111111111111111111112",
"type": "书籍包",
"vipReading": false
}
],
"msg": "操作成功!",
"status": "0000",
"systemMsg": "服务调用成功!",
"systemTime": 1592198767840
}
分销订单创建
功能
分销订单创建,支持手机号、openid、thrid三种账号类型
限制
需要保证购买人手机号的有效性,避免出现空号等情况。
接口请求调用
/user/order/createV2
HTTP请求方式:POST
授权方式:应用授权
http://open-platform-test.dushu365.com/user/order/createV2?sign=93dfe96f1246851ac558835b015f4bc8786740b5&appId=fd179f5ab2384290f1&access_token=fbcab833-f901-4f74-9ae9-b961a5f9e67d
参数说明
参数 | 类型 | 是否必须 | 说明 | 值示例 |
---|---|---|---|---|
tradeNo | String | 是 | 合作方订单号 | |
accountType | Integer | 是 | 账号类型 1:手机号 2:樊登openid接入 3:第三方账号接入 | |
mobile | String | 否 | 购买人手机号,当accountType为1时必填,注意:1.如果该手机号已经注册帆书账号,则会直充到该账户上;2.如果该手机号未注册帆书账号,则我方系统后台会默认给该手机号注册一个新的帆书账号,并发送注册成功短信通知; | |
areaCode | String | 否 | 手机区号 | 默认+86 |
openid | String | 否 | 帆书授权用户唯一标识 | |
thrid | String | 否 | 第三方账号,当accountType为3时必填 | |
productType | Integer | 是 | 分销商品类型 1:樊登讲书会期 2:书籍包 3:单本 4:定制会员 5:课程 6:非凡单本 7:非凡专辑 8:非凡会期 9:训练营 10 跨sku打包 11 课程合集 12 李蕾慢读会期 | |
productNo | String | 是 | 商品编号 | |
payType | String | 是 | 合作方支付方式:99-其他(无支付渠道费),1-IAP为苹果支付(支付渠道费30%),2-支付宝 3-微信(支付渠道费0.6%), | 99-其他、1-IAP、2-支付宝、3-微信、其他需要单独开通 |
payTime | Date | 否 | 支付日期 | |
promoterType | String | 否 | 推广人编号类型 | 1:站外推广人编号,2:openid,3:thrid,4:樊登用户编号 5:手机号 |
promoterNo | String | 否 | 推广人编号 | 根据不同类型需要传递不同类型的值 |
plDiscontPrice | BigDecimal | 否 | 平台优惠价(单位分) | 平台优惠价 |
externalProductNo | String | 否 | 外部产品编码 | 外部产品编码 |
调用示例
{
"accountType": 1,
"mobile":"18500000000",
"productType":2,
"productNo":"156",
"tradeNo": "12345222892",
"payType": "99",
"promoterType":"1",
"promoterNo":"ceshi1",
"plDiscontPrice": "0",
"externalProductNo": "TEST123456"
}
示例成功返回
{
"data": {
"orderNumber": 17172796992589230,
"tradeNo": "1234522289"
},
"msg": "操作成功!",
"status": "0000",
"systemMsg": "服务调用成功!",
"systemTime": 1566386498626
}
返回成功参数说明
参数 | 类型 | 说明 |
---|---|---|
orderNumber | Long | 订单编号 |
tradeNo | String | 合作方交易单号 |
状态码
状态码 | 描述 |
---|---|
0000 | 操作成功 |
2001 | 会期商品不存在 |
2006 | 已领取不可重复领取 |
2007 | 商品已下架 |
2008 | 书籍包已下线或未发布 |
2009 | 书籍包重复购买 |
2010 | 结算方式未配置 |
2007 | 商品已下架 |
示例失败返回
{
"msg": "重复提交",
"status": "9999",
"suceess": false,
"systemMsg": "服务调用失败!",
"systemTime": 1566386776919
}
返回失败参数说明
参数 | 类型 | 说明 |
---|---|---|
msg | String | 失败原因 |
status | String | 9999 |
查看订单详情
功能
通过合作方订单号获取对应订单详情
接口请求调用
/vip/order/detail
HTTP请求方式:POST
授权方式:应用授权
https://open-platform-test.dushu365.com/vip/order/detail?appid=fd0cac7cd6726d1111&sign=82536892cee554f566a4c45e61b573sad43fc996&access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJBTEwiXSwiZXhwIjoxNTY2fDc2OTQ0LCJqdGkiOiI4NzYxNmMwNC1mMWI3LTRhNWEtYjY1OS05NGIwNWUyZTMwNzQiLCJjbGllbnRfaWQiOiJmZDBjYWM3Y2Q2NzI2ZDIxMWYifQ.K3zwm1NLbYe8KK4JyvueFrCcPnGTrXX1S9PelnOWLCk
参数说明
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
tradeNo | String | 是 | 合作方订单号 |
调用示例
{
"tradeNo":"222234522289"
}
示例返回
{
"data": {
"createTime": 1566386808000,
"orderNumber": 1717280009200691422,
"orderStatus": "COMPLETE",
"payType": "test",
"productId": 200000148,
"productName": "会期商品-1年",
"totalFee": 365,
"tradeNo": "222234522289",
"updateTime": 1566386808000,
"userId": 200691422
},
"msg": "操作成功!",
"status": "0000",
"systemMsg": "服务调用成功!",
"systemTime": 1566387246054
}
返回参数说明
参数 | 类型 | 说明 |
---|---|---|
data | JSONObject | |
data.tradeNo | String | 合作方订单号 |
data.orderNumber | Long | 帆书订单号 |
data.createTime | Long | 创建时间(时间戳) |
data.updateTime | Long | 更新时间 |
data.orderStatus | String | 订单状态(NEW:新订单;COMPLETE:已完成) |
data.userId | Integer | 会员编号 |
data.totalFee | decimal | 订单总价(元) |
data.productId | Integer | 商品编号 |
data.productName | String | 商品名称 |
data.payType | String | 支付方式 |