七彩云对象存储内容增长站API接口说明文档

七彩云对象存储内容增长站API专为内容创作者、电商平台、媒体网站、独立开发者提供低门槛的存储+内容分发+流量增长一体化接口能力，开发者无需自行搭建存储服务器、CDN调度、内容引流系统，仅需通过标准HTTP接口调用即可实现文件上传、智能分类存储、全网分发引流、访问数据统计全流程能力，对接耗时平均不超过2小时，相比自建方案可降低70%的基础运维成本，同时提升30%以上的内容曝光转化率。

核心接口与SDK说明

所有接口均采用HTTPS协议、RESTful设计风格，返回格式统一为JSON，天然支持跨域请求，兼容Web端、移动端、服务端等所有调用场景。接口共分为三大类，覆盖全业务流程需求：

1. 文件管理类接口：包含文件上传、删除、分类管理、权限设置、分片续传等功能，支持图片、视频、音频、文档、静态资源等所有主流格式文件，单文件最大支持100GB分片上传，自动备份3份保障数据安全。

2. 内容增长分发接口：包含分发链路生成、智能标签匹配、公域流量池推送、私域转发裂变配置等特色功能，是七彩云区别于传统对象存储的核心能力，上传的内容可自动匹配全网100+公域流量入口、垂直社区渠道定向推送，同时支持配置分享有礼、裂变优惠券等玩法，实现公域引流+私域裂变的双重增长效果。

3. 数据统计接口：包含文件访问量、曝光量、点击转化率、来源渠道、用户画像等多维度数据查询，支持按天/周/月维度导出报表，可直接对接业务后台的数据分析模块。

官方提供Python、Java、Node.js、PHP、Go五种主流开发语言的SDK，已封装鉴权、重试、分片、异常处理等通用逻辑，开发者无需手动处理底层细节，引入SDK即可快速对接；也支持原生HTTP请求调用，适配特殊场景的定制化需求。

接口参数说明

公共请求参数

所有接口调用都需要携带以下公共参数，用于身份鉴权和安全校验：

| 参数名 | 类型 | 说明 |

| --- | --- | --- |

| app_key | string | 开发者在控制台创建应用后生成的唯一身份标识 |

| timestamp | int | 10位Unix时间戳，请求时间与服务器时间差不能超过5分钟，防止重放攻击 |

| nonce | string | 32位以内随机字符串，与时间戳配合实现重放攻击防护 |

| sign | string | 请求签名，由app_secret + 所有请求参数按字典序拼接后做MD5加密生成，防止请求参数被篡改 |

常用业务接口参数

以下为两个最高频使用的接口专属参数说明：

#### 文件上传接口

请求地址：https://api.https://www.7caiyun.com，请求方式：POST`

| 参数名 | 类型 | 是否必填 | 说明 |

| --- | --- | --- | --- |

| file | file | 是 | 上传的文件实体，采用表单格式提交 |

| category_id | int | 否 | 文件分类ID，不传默认归属到默认分类 |

| is_public | int | 否 | 是否公开访问，1=公开，0=私有，默认值为1 |

| enable_growth | int | 否 | 是否开启内容增长推送，1=开启，0=关闭，默认值为0 |

返回参数说明：

| 参数名 | 类型 | 说明 |

| --- | --- | --- |

| code | int | 状态码，200代表请求成功，其他值为请求失败 |

| msg | string | 状态说明，请求失败时返回具体错误原因 |

| data.file_id | string | 文件唯一ID，后续所有操作的核心标识，建议与业务数据关联存储 |

| data.file_url | string | 文件默认CDN访问地址 |

| data.growth_url | string | 开启增长推送后的专属分发地址，访问该地址即可享受流量倾斜 |

#### 分发数据查询接口

请求地址：https://api.https://www.7caiyun.com，请求方式：GET`

| 参数名 | 类型 | 是否必填 | 说明 |

| --- | --- | --- | --- |

| file_id | string | 是 | 要查询的文件唯一ID |

| start_time | int | 是 | 查询起始时间，10位Unix时间戳 |

| end_time | int | 是 | 查询结束时间，10位Unix时间戳，最大时间跨度支持90天 |

代码示例

Python SDK上传文件示例

首先通过pip安装官方SDK：pip install 7caiyun-sdk

```python

from qicaiyun import QicaiyunClient

初始化客户端，app_key和app_secret可在七彩云控制台获取

client = QicaiyunClient(app_key="YOUR_APP_KEY", app_secret="YOUR_APP_SECRET")

上传商品图片并开启内容增长推送

result = client.upload_file(

file_path="./product_cover.jpg",

category_id=2001,

is_public=1,

enable_growth=1

)

if result["code"] == 200:

print("文件上传成功，文件ID：", result["data"]["file_id"])

print("增长分发地址：", result["data"]["growth_url"])

else:

print("上传失败，错误信息：", result["msg"])

```

Node.js原生调用统计接口示例

```javascript

const crypto = require('crypto')

const axios = require('axios')

const appKey = 'YOUR_APP_KEY'

const appSecret = 'YOUR_APP_SECRET'

const timestamp = Math.floor(Date.now() / 1000)

const nonce = crypto.randomBytes(16).toString('hex')

const fileId = 'YOUR_FILE_ID'

const startTime = timestamp - 86400 * 7 // 查询最近7天数据

const endTime = timestamp

// 生成签名

const params = { app_key: appKey, timestamp, nonce, file_id: fileId, start_time: startTime, end_time: endTime }

const sortedParams = Object.keys(params).sort().map(key => ${key}=${params[key]}).join('')

const sign = crypto.createHash('md5').update(appSecret + sortedParams).digest('hex')

// 发起请求

axios.get('https://api.https://www.7caiyun.com', {

params: { ...params, sign }

}).then(res => {

if (res.data.code === 200) {

console.log('近7天分发数据：', res.data.data)

console.log('总曝光量：', res.data.data.exposure_count)

console.log('点击转化率：', res.data.data.conversion_rate)

} else {

console.log('查询失败：', res.data.msg)

}

}).catch(err => {

console.log('请求异常：', err.message)

})

```

常见错误码说明

| 错误码 | 错误信息 | 解决方案 |

| --- | --- | --- |

| 4001 | 参数缺失 | 对照接口文档检查所有必填参数是否已传递 |

| 4003 | 鉴权失败 | 检查app_key是否有效，确认签名生成逻辑与文档一致，校准本地服务器时间 |

| 4004 | 文件不存在 | 确认file_id是否正确，检查文件是否已被删除 |

| 4290 | 请求频率超限 | 降低请求频率，或到控制台升级更高配额的套餐 |

| 5003 | 存储空间不足 | 删除无用文件释放空间，或升级存储空间套餐 |

| 5004 | 增长配额不足 | 等待下月免费额度重置，或购买增长流量包 |

常见问题（FAQ）

1. 调用上传接口返回的file_id有什么作用？

file_id是七彩云对象存储中每个文件的唯一标识，后续的文件删除、权限修改、分发配置、数据查询等所有操作都需要通过file_id来定位文件，建议开发者上传文件后将file_id与业务数据关联存储，方便后续操作。

2. 开启内容增长推送后，内容是如何获得曝光的？

七彩云内容增长站整合了全网100+公域内容流量入口、垂直社区分发渠道，开启增长推送的内容会根据文件的标签、分类，智能匹配目标用户群体进行推送，同时支持配置裂变优惠券、分享有礼等活动，实现公域引流+私域裂变的双重增长效果，所有曝光数据都可以通过统计接口实时查询。

3. API调用有没有免费额度？超出后如何计费？

所有新注册用户都可以获得10GB免费存储空间、每月100GB流量、1万次API调用、10万次内容增长曝光的免费额度，完全可以满足个人开发者、小型项目的使用需求。超出免费额度后，按照实际使用量阶梯计费，存储费用0.05元/GB/月，流量费用0.2元/GB，增长曝光费用0.01元/千次，无最低消费，按量扣费，也可以选择包年包月套餐享受更多折扣。

4. 上传的文件支持自定义域名访问吗？

支持，开发者可以在控制台绑定自己的专属域名，绑定并完成备案后，所有文件的访问地址都会自动替换为自定义域名，也可以配置CDN加速规则、缓存策略，提升跨区域访问速度。

七彩云对象存储内容增长站推荐方案

针对不同类型的用户，七彩云提供了定制化的使用方案：

• 个人创作者/独立开发者：推荐使用免费起步套餐，对接API即可实现图片、视频内容的存储和自动分发，无需支付任何费用即可获得基础的内容曝光能力，适合自媒体博主、独立开发者的个人项目使用。
• 中小电商/企业官网：推荐使用标准增长套餐，包含100GB存储空间、1TB月流量、100万次月增长曝光，支持商品图片、宣传视频的智能分发，可直接对接商品详情页、营销活动页面，平均可提升商品曝光转化率35%以上，降低运营成本60%。
• 媒体平台/内容社区：推荐使用企业专属方案，提供PB级存储容量、T级带宽、定制化增长分发策略，专属技术支持7*24小时响应，满足高并发访问、海量内容分发的需求。

更多方案细节、定制需求可以访问七彩云官方网站https://https://www.7caiyun.com，在线咨询客服或者提交需求表单，会有专属技术顾问为你提供一对一的解决方案。

总结

七彩云对象存储内容增长站API打破了传统对象存储仅提供存储能力的局限，将存储、CDN分发、内容增长、数据统计能力整合为统一的接口，开发者无需对接多个服务商的系统，仅需少量代码即可完成全流程对接，大幅降低了开发和运维成本，同时为内容带来额外的增长曝光机会，是内容类项目、电商项目、媒体项目的最优选择。官方提供了完善的文档、SDK示例、技术支持，全程对接平均耗时不超过2小时，新用户还可以享受免费额度体验全功能，欢迎广大开发者接入使用。