设置Referer防盗链
更新时间 2026-04-10 10:43:26
最近更新时间: 2026-04-10 10:43:26
通过本接口向云点播的存储桶配置Referer防盗链。
接口功能介绍
用户可通过本接口向云点播的存储桶配置Referer防盗链。
注意自2025年5月7日零时起,云点播对资源分配方式进行了升级,原【点播区域】更名为【点播实例】。新开通客户将以实例化方式提供媒资存储、媒体处理等服务,不再以资源池方式进行命名和资源划分。接口中regionCode参数将被替换成InstanceID。
接口约束
本接口的单用户QPS限制为20次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
URI
POST /accessControl/referer/set
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| instanceId | 是 | Integer | 实例ID。该接口仅主账号权限可用。 | 306456816628 | |
| enable | 是 | Boolean | 是否启用:true-启用;false-禁用。(1)true:表示设置防盗链,下面的字段均为必填;(2)false:表示删除防盗链,下面的字段均不用填。 | true | |
| type | 否 | String | 类型,包含 WHITE-LIST/BLACK-LIST。 | BLACK-LIST | |
| allowEmpty | 否 | Boolean | 是否允许为空 | false | |
| referers | 否 | Arrayof Strings | 设置的防盗链名单。 | [“http://www.ctyun.cn”,“http://*.ctyunapi.com”] |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| code | 是 | String | 本次请求的结果码 | "0" | |
| message | 是 | String | 错误文本信息,创建成功时,为空字符串。 | “” |
请求示例
请求体body
{
"instanceId": 306456816628,
"enable": true,
"type": "WHITE-LIST",
"allowEmpty": true,
"referers": [
"http://127.0.0.1:8080"
]
}
响应示例
{
"code": "0",
"message": ""
}
状态码
| Http 状态码 | 状态码信息 | 状态码描述 |
|---|---|---|
| 0 | 表示业务成功 | 表示业务成功 |
| 400 | 请求参数有误 | 请求参数有误 |
| 403 | 用户鉴权失败,用户无操作权限 | 用户鉴权失败,用户无操作权限 |
| 404 | 请求的资源不存在,输入错误的URL | 请求的资源不存在,输入错误的URL |
| 500 | 业务执行异常 | 业务执行异常 |
错误码
OpenAPI错误码请参考 错误码说明。