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

### 基本信息

| 属性     | 内容                  |
|:-------|:--------------------|
| 文档名称   | 开发者商业价值转化：推广产品得收益 |
| 文档版本   | 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 服务购买页面示例：

![VIP服务购买页](图片/推广产品得收益/VIP服务购买页.png)

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

![长期存储空间购买页](图片/推广产品得收益/长期存储空间购买页.png)

## 三、接入流程

### 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/)，查看收益明细等推广收益情况并进行提现操作。

![推广收益管理页](图片/推广产品得收益/推广收益管理页.png)

### 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默认产品名称改为至尊版 |