MeBox/115doc/115开放平台/API列表/开发者商业价值转化：推广产品得收益.md at 0810bfb23461d469d68a8a679c179323c03cf30e

tcjlj/MeBox

Fork 0

mirror of https://github.com/truewhile/MeBox.git synced 2026-09-28 03:06:38 +08:00

Files

T

truewhile 0e9fb2c937 优化，添加115接口文档

2026-09-05 14:32:58 +08:00

6.3 KiB

Raw Blame History

开发者商业价值转化：推广产品得收益

基本信息

属性	内容
文档名称	开发者商业价值转化：推广产品得收益
文档版本	v1.0

一、简介

为帮助开发者实现商业价值转化，115生活开放平台推出“推广产品得收益”计划，通过“推广有奖、收益共享”的方式，与开发者共同构建可持续发展的开放生态。

开发者接入标准化服务接口后，可以在用户需要升级使用权限、扩充长期存储空间或增加云下载配额时，引导用户购买对应的 115 增值服务，并基于用户实际购买的产品获取相应推广收益。

二、服务形式说明

1. 标准化服务接口

标准化服务接口覆盖以下核心场景。

1.1. VIP 服务

适用于用户对应功能使用权限不足的场景：

视频播放权限升级：解决非 VIP 用户不支持在线预览视频、年费VIP以下用户不支持视频 4K 超轻转码等权限限制。
大文件上传权限升级：解决月费VIP以下用户不支持上传 115GB 大文件等权限限制。

开发者可以引导用户升级至更高的 VIP 类型，以获取对应使用权限。

1.2. 长期存储空间扩容服务

适用于用户存储空间不足的场景，可解决因空间容量不足导致文件上传、复制及添加云下载失败等问题。

开发者可以引导用户购买 VIP 服务以获取更多长期存储空间，或单独购买长期存储空间进行扩容。

1.3. 云下载配额

适用于用户云下载配额不足的场景，可解决因服务配额不足导致添加云下载失败等问题。

开发者可以引导用户升级至更高的 VIP 类型以获取更多云下载配额，或单独购买云下载配额。

2. 收益获取模式

用户通过开发者应用进入购买页面并成功购买以下任一服务产品后，开发者可以获得对应推广收益：

115生活 VIP 服务，包括月费VIP、年费VIP等。
长期存储空间扩容。
云下载配额。

VIP 服务购买页面示例：

长期存储空间扩容购买页面示例：

三、接入流程

1. 成为开发者

已成为 115 生活开发者的用户可以直接进行接口接入；未注册的开发者，请先参考接入流程完成注册。

2. 接口接入

开发者可以调用“获取产品列表地址”接口取得购买页面地址，并在对应业务场景中引导用户访问。

接口信息

属性	内容
接口名称	获取产品列表地址
接口版本	v1.0
接口路径	/vip/qr_url
请求方法	GET
接口状态	生产环境

接口说明

该接口用于获取 115 生活开放平台增值服务产品列表地址。

接口地址

https://proapi.115.com/open/vip/qr_url

请求方式

GET

认证方式

Authorization: Bearer access_token

请求参数

参数名	类型	必填	默认值	说明	约束/示例
default_product_id	int	否	null	打开产品列表时默认选中的产品 ID	月费：`5`；年费：`1`；尝鲜 1 天：`101`；长期VIP(至尊版)：`24072401`
open_device	string	是	-	设备号	`DEVICE_ID_PLACEHOLDER`
hide_title	int	否	0	是否隐藏购买页推荐人信息：0-不隐藏；1-隐藏	`0`

请求示例

curl -G 'https://proapi.115.com/open/vip/qr_url' \
  -H 'Authorization: Bearer ACCESS_TOKEN_PLACEHOLDER' \
  --data-urlencode 'default_product_id=1' \
  --data-urlencode 'open_device=DEVICE_ID_PLACEHOLDER' \
  --data-urlencode 'hide_title=0'

响应字段说明

字段	类型	描述
state	boolean	状态码，true 表示成功
message	string	响应信息
code	int	错误码
data	object	响应数据
data.qrcode_url	string	开放平台产品列表地址

响应示例

{
  "state": true,
  "message": "",
  "code": 0,
  "data": {
    "qrcode_url": "PRODUCT_LIST_URL_PLACEHOLDER"
  }
}

注意事项

接口根据 access_token 识别授权信息，调用方无需额外传入 115 账号和 AppID。
open_device 不能为空；未传或传入空值时，接口返回参数错误。
default_product_id 未传或为空时，服务端不指定默认产品。
hide_title 大于 0 时，服务端会将该参数传递给产品列表服务。
access_token 属于敏感凭证，不得写入公开仓库、客户端日志或公开沟通内容。

3. 场景触发与收益

完成接口接入后，开发者可以在用户使用权限不足、长期存储空间不足或云下载配额不足时触发对应引导。用户完成购买后，开发者可以获得对应推广收益。

四、收益管理与结算

1. 收益查看与提现

开发者可以登录“115生活-生活-联盟”，或直接访问115联盟，查看收益明细等推广收益情况并进行提现操作。

2. 规则说明

收益计算方式、结算方式和提现流程等详情，参见联盟规则。

修改历史

修改时间	修改说明
2025年04月01日(周二) 00:00:00	创建文档
2026年08月05日(周三) 17:30:01	恢复业务说明、接入流程及示例图片
2026年08月19日(周三) 11:00:08	长期VIP默认产品名称改为至尊版

6.3 KiB Raw Blame History Unescape Escape