mirror of
https://github.com/truewhile/MeBox.git
synced 2026-09-28 03:06:38 +08:00
truewhile
173 lines
6.3 KiB
Markdown
173 lines
6.3 KiB
Markdown
## 开发者商业价值转化：推广产品得收益
|
||
|
||
### 基本信息
|
||
|
||
| 属性 | 内容 |
|
||
|:-------|:--------------------|
|
||
| 文档名称 | 开发者商业价值转化：推广产品得收益 |
|
||
| 文档版本 | 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 生活开发者的用户可以直接进行接口接入；未注册的开发者，请先参考[接入流程](../接入指南/接入流程.md)完成注册。
|
||
|
||
### 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` |
|
||
|
||
### 请求示例
|
||
|
||
```shell
|
||
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 | 开放平台产品列表地址 |
|
||
|
||
### 响应示例
|
||
|
||
```json
|
||
{
|
||
"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联盟](https://union.115.com/)，查看收益明细等推广收益情况并进行提现操作。
|
||
|
||
|
||
|
||
### 2. 规则说明
|
||
|
||
收益计算方式、结算方式和提现流程等详情，参见[联盟规则](https://union.115.com/?ac=help&i=10)。
|
||
|
||
### 修改历史
|
||
|
||
| 修改时间 | 修改说明 |
|
||
|:-----------------------------|:-----------------|
|
||
| 2025年04月01日(周二) 00:00:00 | 创建文档 |
|
||
| 2026年08月05日(周三) 17:30:01 | 恢复业务说明、接入流程及示例图片 |
|
||
| 2026年08月19日(周三) 11:00:08 | 长期VIP默认产品名称改为至尊版 |
|