简介
本文档提供关于防盗链接口的 API 概览以及 SDK 示例代码。
设置防盗链
功能说明
用于对存储桶添加防盗链(设置黑白名单)。
示例代码
function setRefer() {var config = {// 需要替换成您自己的存储桶信息Bucket: 'examplebucket-1250000000', /* 存储桶,必须 */Region: 'COS_REGION', /* 存储桶所在地域,必须字段 */};var host = config.Bucket + '.pic.' + config.Region + '.myqcloud.com/?hotlink';var url = 'https://' + host;var body = COS.util.json2xml({Hotlink: {Url: 'https://www.example.com', // 必须,域名地址Type: 'white', // 必须,防盗链类型,white 为白名单,black 为黑名单,off 为关闭。}});cos.request({Method: 'PUT',Url: url,Body: body,ContentType: 'application/xml',},function(err, data){console.log(err || data);});}setRefer();
参数说明
Container 类型 Hotlink 的具体数据描述如下:
节点名称 | 父节点 | 描述 | 类型 | 是否必选 |
Url | Hotlink | 域名地址。 | String | 是 |
Type | Hotlink | 防盗链类型,white 为白名单,black 为黑名单,off 为关闭。 | String | 是 |
返回结果说明
查询防盗链
功能说明
用于查询 Bucket 中防盗链详情(黑白名单)。
示例代码
function describeRefer() {var config = {// 需要替换成您自己的存储桶信息Bucket: 'examplebucket-1250000000', /* 存储桶,必须 */Region: 'COS_REGION', /* 存储桶所在地域,必须字段 */};var host = config.Bucket + '.pic.' + config.Region + '.myqcloud.com/?hotlink';var url = 'https://' + host;cos.request({Method: 'GET',Url: url,},function(err, data){console.log(err || data);});}describeRefer();
参数说明
无