jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的全站加速缓存配置

gpt: [全站加速](https://developer.qiniu.com/dcdn) > 使用指南 > 配置管理 >缓存配置

#  缓存配置

最近更新时间: 2023-09-07 16:35:16

缓存配置是指动静态混合资源中，静态资源在 DCDN
加速节点上遵循的一套缓存过期规则。全站加速默认全局动态回源不缓存，结合缓存规则可以实现动静态混合加速的效果。您可以登录**七牛开发者平台**
选择**DCDN控制台** ，在控制台中查看域名的缓存配置信息并进行修改。  
  

# 操作说明

登录**七牛开发者平台** 后，进入**DCDN控制台** ，选择【域名管理】，点击【配置】  
![](https://dn-odum9helk.qbox.me/FkoWzzj8HeSDrTkiCnfY99AjqN7x)

进入域名配置界面，点击【修改配置】进行缓存配置的修改。  
![image.png](https://dn-odum9helk.qbox.me/Fm_E3Rgll0tdNFolV-7DfiqJEfOb)

### 1、静态缓存规则

静态缓存规则默认关闭，即没有任何缓存行为。开启后，可配置静态缓存规则针对部分资源进行缓存。

（1）推荐配置：

  * .jpg;.jpeg;.png;.bmp;.gif;.webp;.ico 图片类型缓存1天。
  * .js;.css;.txt;.xml;.shtml;.html;.htm;.csv;.bat 文本类型缓存1天。
  * .m3u8 m3u8类型缓存1小时。
  * .avi;.mkv;.mp4;.mov;.flv;.rm;.rmvb;.swf;.mp3;.wav;.wmv;.rmi;.aac 音视频类型缓存7天。
  * .exe;.deb;.ipa;.apk;.sis;.psd;.dat 大文件类型缓存7天。  
![](https://dn-odum9helk.qbox.me/FkK9p4rQT1ipIBHLRPBm4OvTaVHP)

（2）添加后缀

  * 后缀：必须以「.」(英文点)开始，多个后缀请用「;」(英文分号)隔开，例如(.png;.jpg;.gif)。
  * 缓存规则最多可配置15条。
  * 1条缓存规则中，最多10个后缀，「;」(英文分号)隔开。
  * 时间单位：分/小时/天，只能输入整数，最大值为 365 天。
  * 按从上至下顺序，采取优先匹配原则。

（3）添加目录

  * 路径：必须以「/」(英文斜杠)开始，多个路径请用「;」(英文分号)隔开，例如: (/a/b/c;/d/e/f;/h/i/j) ，路 径中不能包含「.」，也不能以「/」结尾。
  * 缓存规则最多可配置15条。
  * 1条缓存规则中，最多10个路径，「;」(英文分号)隔开。
  * 时间单位：分/小时/天，只能输入整数，最大值为 365 天。
  * 按从上至下顺序，采取优先匹配原则。

### 2\. 忽略URL参数

（1）保留所有参数：资源缓存时保留 URL「？」后的全部参数进行缓存，请确认请求的 URL 的参数值和文件有关再开启，否则会降低缓存命中率并增加 CDN
回源次数。  
![image.png](https://dn-odum9helk.qbox.me/Fl3JffPNYBYLU8Fpn30wsJzEovrV)

（2）忽略所有参数：资源缓存时去除 URL「?」后的全部参数进行缓存，忽略全部参数同时会导致图片处理等 FOP 功能失效。  
![image.png](https://dn-odum9helk.qbox.me/FqoWadHuvWh8tErwHfmZJou7S4qb)

（3）保留指定参数：资源缓存时会仅仅保留您输入的指定参数然后进行缓存。  
![image.png](https://dn-odum9helk.qbox.me/Fv2e98IocMO7YVE4jHp3LVxRInTy)

（4）忽略指定参数：资源缓存时会去除您输入的指定参数然后进行缓存。  
![image.png](https://dn-odum9helk.qbox.me/Fl_wC1264dlHbh94C45hv9maiWRh)

以上内容是否对您有帮助？
human: 如何处理七牛云的全站加速IP黑白名单

gpt: [全站加速](https://developer.qiniu.com/dcdn) > 使用指南 > 配置管理 >访问控制配置 >IP黑白名单

#  IP黑白名单

最近更新时间: 2022-02-18 14:20:54

为了解决恶意 IP 盗刷、攻击等问题，七牛云 DCDN 提供了IP黑白名单配置功能，，您可以登录**七牛开发者平台** 选择**DCDN**
控制台，进行IP黑白名单配置。  
  

# 操作说明

登录**七牛开发者平台** 后，进入**DCDN控制台** ，选择【域名管理】，点击【配置】：  
![](https://dn-odum9helk.qbox.me/FkoWzzj8HeSDrTkiCnfY99AjqN7x)

进入域名配置界面，**访问控制** 模块下的【IP黑白名单】点击【修改配置】进行IP黑白名单配置。  
![](https://dn-odum9helk.qbox.me/FsE9G7Jn2mvrP_LGLDuyPUo5iz0z)  
  

### IP黑白名单配置

IP黑白名单配置默认为关闭状态，开启后可以根据需要选择配置IP的黑白名单。

  * IP白名单：当发起请求的客户端的 IP 匹配列表中的 IP 或 IP 段时，访问能够正常返回所请求的内容，其他请求均直接返回 403。

  * IP黑名单：当发起请求的客户端的 IP 匹配列表中的 IP 或 IP 段时，访问直接返回 403，其他访问能够正常返回所请求内容。

![](https://dn-odum9helk.qbox.me/FvlkZ_xjPOkZ9Lo3u3s3a-31vfxc)

**注意事项**

  * 支持输入多个IP或网段。
  * 网段可以用来描述一个 IP 区间，含义为：例如 127.0.0.1/24，其中 24 表示采用子网掩码中的前 24 位为有效位，即 2 进制的 IP 地址中，前 32 位有效，后 8 位表达了该网段的范围。故 127.0.0.1/24 表示 IP 网段范围是：127.0.0.1~127.0.0.255。目前仅支持 “/8”，"/16"，"/24" 三种。

以上内容是否对您有帮助？
human: 如何处理七牛云的全站加速Referer防盗链

gpt: [全站加速](https://developer.qiniu.com/dcdn) > 使用指南 > 配置管理 >访问控制配置 >Referer防盗链

#  Referer防盗链

最近更新时间: 2022-02-15 16:44:50

referer防盗链是基于获取HTTP请求中的 referer header，根据 referer
跟踪来源，对来源进行识别和判断，您可以登录**七牛开发者平台** 选择**DCDN控制台** ，进行referer
黑白名单的配置，从而限制访问来源，避免恶意用户盗刷。

# 功能说明

referer防盗链默认为关闭状态，开启后可以进行referer黑白名单的配置。

  * 白名单：请求的referer字段匹配白名单设置的内容，则 DCDN 节点正常返回请求信息，若不匹配，DCDN 节点拒绝返回该请求信息，返回状态码 403。

  * 黑名单：请求的referer不匹配黑名单内设置的内容，则 DCDN 节点正常返回请求信息，若匹配，DCDN 节点拒绝返回该请求信息，返回状态码 403。

  * 是否允许空referer：当选择允许空referer时，此时若请求referer字段为空或无referer字段 DCDN 节点正常返回请求信息；若不允许，此时若请求referer字段为空或无referer字段 DCDN 节点拒绝返回该请求信息，会直接返回状态码 403。

# 操作说明

1、登录**七牛开发者平台** 后，进入**DCDN控制台** ，选择【域名管理】，点击【配置】。  
![](https://dn-odum9helk.qbox.me/FkoWzzj8HeSDrTkiCnfY99AjqN7x)

2、进入域名配置界面，**访问控制** 模块下的**referer防盗链** 点击【修改配置】进行referer防盗链的配置。  
![](https://dn-odum9helk.qbox.me/Fkb86lT5AfYJW5JvSvs1qBN3A6BL)

3、开启防盗链配置，选择黑白名单，输入访问的来源域名。  
![](https://dn-odum9helk.qbox.me/FsgiJd8jbIQaTRQVKHy9loCo9DnL)

**注意事项**

  * 域名之间请回车换行，无需填写 http://，https://；
  * 支持域名前使用通配符 ：*.example.com 可用于指代所有 example.com 下的多级子域名，比如 a.example.com 等，但是不包括 example.com，如需要请额外填写一条 example.com；
  * 防盗链个数设置不能超过100个；
  * 黑白名单生效时间为 1 小时，在此期间不能修改其它配置；
  * 不支持 IP，不支持端口号。

以上内容是否对您有帮助？
human: 如何处理七牛云的全站加速HTTPS配置

gpt: [全站加速](https://developer.qiniu.com/dcdn) > 使用指南 > 配置管理 >HTTPS配置

#  HTTPS配置

最近更新时间: 2022-02-18 14:23:16

HTTPS 是指超文本传输安全协议（Hypertext Transfer Protocol Secure，缩写：HTTPS，常称为HTTP over
TLS，HTTP over SSL或HTTP
Secure）是一种通过计算机网络进行安全通信的传输协议。HTTPS经由HTTP进行通信，但利用SSL/TLS来加密数据包。HTTPS开发的主要目的，是提供对网站服务器的身份认证，保护交换数据的隐私与完整性。配置
HTTPS 时，需要您提供域名对应的证书，实现全网数据加密传输功能。您可以登录**七牛开发者平台** 选择**DCDN控制台** ，进行HTTPS的配置。  
  

# 操作说明

登录**七牛开发者平台** 后，进入**DCDN控制台** ，选择【域名管理】，点击【配置】。

![](https://dn-odum9helk.qbox.me/FkoWzzj8HeSDrTkiCnfY99AjqN7x)

进入域名配置界面，**HTTPS配置** 模块下点击【修改配置】。  
![](https://dn-odum9helk.qbox.me/FobdThhjRYJaztKe0cxRHxqOR9iE)

### 1\. 开启 HTTPS

如需启用**HTTPS服务** 时，选择【HTTPS】即可，开启后需要选择对应的证书。  
![](https://dn-odum9helk.qbox.me/FtkGv9etD1UoLPRKLmzBkfoF_E93)

### 2\. 更换证书

如已经完成了证书的上传，选择对应的证书即可  
![](https://dn-odum9helk.qbox.me/Fi0DOyOW9_S_BpbtM-bw3FTT2PWs)

注意：

  * 证书筛选框只显示对应域名可用的所有证书，证书剩余有效期必须大于7天。
  * 如未上传证书或此域名当前无可用证书，点击**七牛云证书服务** 进入SSL证书服务控制台进行自有证书上传或购买证书操作。

![](https://dn-odum9helk.qbox.me/FrpmZdfGistDJQF5w8VSpfjMlmsn)

### 3\. 强制HTTPS

如果您的加速域名开启了HTTPS配置，您可以设置【强制HTTPS】，开启后即使用户发起 HTTP 请求，也会强制跳转为 HTTPS
请求进行访问。此项默认为关闭状态，此时同时支持HTTP和HTTPS方式的请求。

![](https://dn-odum9helk.qbox.me/FmvlUt7NHN76RqBIsqFH_Tr4nJ7X)

### 4\. 开启HTTP/2

如果您的加速域名开启了HTTPS配置，您可以设置【开启HTTP/2】，HTTP/2可以兼容HTTP/1.1的访问，优化网络延迟，提升网络速度，优化用户的网络使用体验。目前，Chrome、
Firefox、Safari 等主流浏览器已经支持 HTTP/2协议。  
![](https://dn-odum9helk.qbox.me/FrQ3PYJ6c9ET3q_fZ-SdMz3s5Umh)

以上内容是否对您有帮助？
human: 如何处理七牛云的全站加速HTTP响应头配置

gpt: [全站加速](https://developer.qiniu.com/dcdn) > 使用指南 > 配置管理 >HTTP响应头配置

#  HTTP响应头配置

最近更新时间: 2022-02-18 14:25:12

HTTP 消息头是指，在超文本传输协议（ Hypertext Transfer Protocol，HTTP）的请求和响应消息中，协议头部的组件。在 HTTP
消息头中，按其出现的上下文环境，分为通用头、请求头、响应头等。

其中 HTTP
响应头向客户端提供一些额外信息，比如谁在发送响应、响应者的功能，甚至与响应相关的一些特殊指令。这些头部有助于客户端处理响应，并在将来发起更好的请求。

当您的网站接入 DCDN 后，由于客户端和源站会根据 HTTP 响应头的字段信息进行相关的行为处理，所以会有修改 HTTP 响应头的需求。由于 HTTP
响应头配置是针对域名，因此一旦配置生效，对该域名下任意一个资源的响应消息中均会加入所配置头部。配置 HTTP
响应头仅影响客户端（如浏览器）的响应行为，不会影响到节点的缓存行为。

# 操作说明

您可以登录七牛开发者平台，并进入[**DCDN控制台**
__](https://portal.qiniu.com/dcdn/overview)，选择【域名管理】，点击【配置】。  
![](https://dn-odum9helk.qbox.me/FkoWzzj8HeSDrTkiCnfY99AjqN7x)  
进入域名配置界面，点击【修改配置】对 HTTP 响应头进行配置。  
![](https://dn-odum9helk.qbox.me/FjdnXEy0O8hfn1qB2liA-d36WkJ0)  
响应头支持【删除】【设置】操作。  
![](https://dn-odum9helk.qbox.me/Ft6srrqb5o6kHcty8Om3FJPv_qid)  
  
  
请根据实际情况选择 HTTP 响应头、响应头操作并配置相应的值。  
目前七牛云CDN提供11个 HTTP 响应头参数可供您自定义取值，解释如下表所示。 如果您有其他 HTTP 头设置需求，请[提交工单
__](https://support.qiniu.com/tickets/new/form?category=%E9%85%8D%E7%BD%AE%E9%97%AE%E9%A2%98&space=CDN)处理。

HTTP 响应头 | 描述 | 示例  
---|---|---  
Access-control-allow-origin | 指定允许的跨域请求的来源。 | * （*表示全部域名；也可填写完整域名，例如 http://www.qiniu.com 、http://*.qiniu.com )  
Access-Control-Allow-Headers | 指定允许的跨域请求的字段。 | X-Custom-Header  
Access-Control-Allow-Methods | 指定允许的跨域请求方法。 | POST,GET,OPTIONS  
Content-Type | 指定客户端程序响应对象的内容类型。 | Content-Type  
Cache-Control | 指定客户端程序请求和响应遵循的缓存机制。 | no-cache,no-store  
Content-Disposition | 指定客户端程序把请求所得的内容存为一个文件时提供的默认的文件名。 | attachment; filename=“filename.jpg”  
Content-Language | 指定客户端程序响应对象的语言。 | zh-CN,en-US  
Expires | 指定客户端程序响应对象的过期时间。 | Wed, 21 Oct 2015 07:28:00 GMT  
Access-Control-Max-Age | 指定跨域请求时，对特定资源的预请求返回结果的缓存时间。 | 600（单位为秒，600表示10分钟）  
Access-Control-Expose-Headers | 指定允许访问的自定义头信息。 | Content-Length（可以输入多个头部时，需用 “,” 隔开。）  
Access-Control-Allow-Credentials | 指定是否允许跨域请求携带验证信息，验证信息可以是cookies。 | true  
      
    
    注：跨域是指某一个域名，如 www.aaa.com 下的某资源，向另一个域名 www.bbb.com 下的某资源发起请求，此时由于资源所属域名不同，即出现 跨域，不同的协议、不同的端口均会造成跨域访问的出现。此时必须在 Response Header 中增加跨域相关配置，才能让前者成功拿到数据。
    

以上内容是否对您有帮助？
human: 如何处理七牛云的全站加速批量复制

gpt: [全站加速](https://developer.qiniu.com/dcdn) > 使用指南 > 配置管理 >批量复制

#  批量复制

最近更新时间: 2023-08-11 15:31:35

批量复制可以实现复制已有域名的配置完成批量添加域名，支持调整基础配置批量复制，也支持自定义勾选Referer 防盗链、IP 黑白名单、HTTP
响应头等配置项批量复制。

  

# 操作说明

### 1.登录**七牛开发者平台** 后，进入**CDN控制台** ，选择【域名管理】，点击目标域名**操作** 项下的**复制** 进入配置界面：

![image.png](https://dn-odum9helk.qbox.me/FvNO488DMLUm2FIKlShP83y8tcYG)  
注意：只有**成功** 状态的域名支持批量复制

### 2.添加域名&确认配置

在**加速域名** 输入框中输入需要批量添加的域名，并确认**基本信息、源站配置和缓存配置** ，若非预期配置可以修改。

![image.png](https://dn-odum9helk.qbox.me/FkHcJWk7CqMlKWN6-ZzOVktJa_ba)

注意：  
a. 添加域名中存在未备案域名，加速范围只能选择海外；  
b. 完整域名和泛域名需要分开添加，不能混在一起批量复制；  
c. **源站测试** 需要点击并显示测试通过后，才可以点击**下一步** ，否则会报错提示“源站待测试”。

### 3.选择复制配置

**配置项** ：支持自定义勾选的批量复制配置项，包含Referer 防盗链、IP 黑白名单、HTTP 响应头等配置批。  
**配置状态** ：配置项的配置状态，包含开启和关闭两种。  
**操作** ：点击**详情** 可以查看配置项的配置详情。

![image.png](https://dn-odum9helk.qbox.me/Fpe5K1V9OO3LVVBwyej2rgjs8cvu)

注意：  
a. 若被复制域名存在后端特殊配置（非控制台配置），该特殊配置无法复制，若需要请联系客服补充配置。  
b. 因 HTTPS 证书配置需要重新绑定当前域名，不支持复制此配置，若需要请自助补充配置。  
c. 配置状态为关闭的配置项勾选和不勾选，实际配置效果均为关闭。

### 4.确认提交

确认无误，点击**确认** 即可，否则点击**取消** 返回上一步。

![image.png](https://dn-odum9helk.qbox.me/Fg8aMMufhlBRAOw2VjXykYHLvj2j)

### 5.创建完成

![image.png](https://dn-odum9helk.qbox.me/Fli5Rzr28TKif6IsmtXf_v7IJa7v)  
注意：  
a. 域名的状态若为“创建完成”，仅表示创建域名的任务提交成功，不表示域名配置下发完成；  
b. 域名的状态若为“域名所有权待验证”，需要点击**操作** 项下的**所有权验证** 逐个域名进行所有权验证，否则无法成功添加域名。

以上内容是否对您有帮助？
human: 如何处理七牛云的全站加速接入方式

gpt: [全站加速](https://developer.qiniu.com/dcdn) > API 文档 > 接入方式

#  接入方式

最近更新时间: 2022-02-09 18:41:48

# 对外域名

Host: `api.qiniu.com`

# 授权

Authorization: `QBox <AccessToken>`

详细描述见[文档
__](http://developer.qiniu.com/docs/v6/api/overview/security.html#accesstoken)。

# API 请求格式

  * RESTful api, 具体格式参考每个API定义
  * `POST方法，需要带请求头 Content-Type:application/json，请留意`

# API 响应格式

  * 响应成功的格式

    
    
    HTTP/1.1 200 OK
    {
        // 如果API下面包含有body的响应，会列出body的结构，否则说明响应不包含body
    }
    
    

  * 响应错误的格式

    
    
    HTTP/1.1 4xx/5xx
    {
    	"code":<Code>, // 错误码在每个API下面都有列出, code为6位数字码，前三位与http code一致
    	"error":<ErrorMessage>
    }
    
    

以上内容是否对您有帮助？
human: 如何处理七牛云的全站加速域名归属校验

gpt: [全站加速](https://developer.qiniu.com/dcdn) > API 文档 > 域名归属校验

#  域名归属校验

最近更新时间: 2022-08-02 17:18:16

# 获取域名验证信息

    
    
    用户获取域名所有权验证信息接口
    

## 请求包

    
    
    GET /domain/<Name>/verify/info?product=<Product>
    Authorization: QBox <QBoxToken>
    Content-Type: application/x-www-form-urlencoded
    

### 参数解释

参数 | 类型 | 必填 | 含义  
---|---|---|---  
Name | string | 是 | 需要验证的域名  
Product | string | 是 | 产品类型: `cdn`(静态加速)/`dcdn`(全站加速)  
  
## 返回包

    
    
    {
        domain: <Domain>,
        dns: <OwnerVerifyDnsInfo>,
        file: <OwnerVerifyFileInfo>,
        state: <State>
    }
    

### 参数解释

参数 | 类型 | 含义  
---|---|---  
Domain | string | 用户需要验证的主域名,比如创建加速域名cdn.qiniu.com,需要验证主域名qiniu.com的所有权  
Dns | object | DNS验证信息,用户需要在域名所属的DNS服务商上配置DNS解析完成验证  
File | object | 文件验证信息,用户需要在主域名所在服务器的根目录下配置验证文件  
State | string | 验证状态: `no_need`(不需要验证)/`doing`(待验证)/`success`(验证通过)  
  
### DNS验证信息

参数 | 类型 | 含义  
---|---|---  
Host | string | 主机记录  
RecordType | string | 记录类型  
RecordValue | string | 记录值  
  
### 文件验证信息

参数 | 类型 | 含义  
---|---|---  
FileName | string | 文件名称  
FileValue | string | 文件内容  
  
**错误码**

错误码 | 含义  
---|---  
400079 | 未知的顶级域名  
500005 | 数据查询内部出错  
  
# 验证域名所有权

    
    
    用户验证域名所有权接口
    

## 请求包

    
    
    POST /domain/<Name>/verify/check HTTP/1.1
    Content-Type: application/json
    Authorization: QBox <QBoxToken>
    
    {
    	"type": <Type>,
    	"product": <Product>
    }
    

### 参数解释

参数 | 类型 | 必填 | 含义  
---|---|---|---  
Name | string | 是 | 域名, 如果是泛域名，必须以点号 . 开头  
Product | string | 是 | 产品类型: `cdn`(静态加速)/`dcdn`(全站加速)  
Type | string | 是 | 验证类型: `dns`(DNS验证)/`file`(文件验证)  
  
## 返回包

    
    
    {}
    

**错误码**

错误码 | 含义  
---|---  
400000 | 未知的输入参数  
400079 | 未知的顶级域名  
400937 | 尚未查看域名验证值(未调用获取域名验证信息接口的情况下，直接调用验证域名所有权接口，会返回该错误码)  
400932 | 域名所有权验证失败  
500004 | 更新数据内部出错  
500005 | 数据查询内部出错  
  
## 请求示例

    
    
    POST /domain/testqiniu.qbox.net/verify/check HTTP/1.1
    Authorization: QBox 0tf5awMVxwf8WrEvrjtbiZrdRZRJU-91JgCqTOC8:6oxDOtOXVEfcR8PPuAscmWjVRS8=
    Host: api.qiniu.com
    
    {
        "type": "dns"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的全站加速证书相关

gpt: [全站加速](https://developer.qiniu.com/dcdn) > API 文档 > 证书相关

#  证书相关

最近更新时间: 2024-07-01 15:33:42

# 上传证书

    
    
    用户上传证书的接口, 注意我们不会自动补全证书链，需要用户自己补全
    
    

## 请求包

    
    
    POST /sslcert
    Content-Type: application/json
    Authorization: QBox <AccessToken>
    
    {
    		"name": <Name>,
    		"common_name": <CommonName>,
    		"pri": <Pri>,
    		"ca": <Ca>
    }
    
    

### 参数解释

参数 | 类型 | 含义  
---|---|---  
Name | string | 证书名称  
CommonName | string | 通用名称  
Pri | string | 证书私钥  
Ca | string | 证书内容  
  
## 返回包

    
    
    	{
    		"certID": <CertID>
    		
    	}
    
    

### 参数解释

参数 | 类型 | 含义  
---|---|---  
CertID | string | 证书ID  
  
**错误码**

错误码 | 含义  
---|---  
400500 | 超过用户绑定证书最大额度  
404906 | https证书解码失败  
400323 | 验证https证书链失败  
400322 | https证书有效期太短  
400329 | https证书过期  
  
# 删除证书

    
    
    用户删除证书的接口
    
    

## 请求包

    
    
    DELETE /sslcert/<CertID>
    Content-Type: application/json
    Authorization: QBox <AccessToken>
    
    

### 参数解释

参数 | 类型 | 含义  
---|---|---  
CertID | string | 证书ID  
  
## 返回包

    
    
    {}
    
    

**错误码**

错误码 | 含义  
---|---  
400401 | 无此证书  
404908 | 无权操作该证书  
400611 | 证书已绑定CDN域名  
400911 | 证书已绑定存储域名  
  
# 获取证书

    
    
    用户获取单个证书的接口
    
    

## 请求包

    
    
    GET /sslcert/<CertID>
    Content-Type: application/x-www-form-urlencoded
    Authorization: QBox <QBoxToken>
    
    

### 参数解释

参数 | 类型 | 含义  
---|---|---  
CertID | string | 证书ID  
  
## 返回包

    
    
    {
    	"name": <Name>,
        	"common_name": <CommonName>,
            "dnsnames": <DNSNames>,  
        	"not_before": <NotBefore>,
         	"not_after": <NotAfter>,
    	"pri": <Pri>,
    	"ca": <Ca>,
            "create_time": <CreateTime>
    }
    
    

### 参数解释

参数 | 类型 | 含义  
---|---|---  
Name | string | 证书名称  
CommonName | string | 通用名称  
DNSNames | []string | DNS域名  
NotBefore | int | 生效时间  
NotAfter | int | 过期时间  
Pri | string | 证书私钥  
Ca | string | 证书内容  
CreateTime | int | 创建时间  
  
**错误码**

错误码 | 含义  
---|---  
400401 | 无此证书  
404908 | 无权操作该证书  
  
# 获取证书列表

    
    
    用户获取证书列表的接口
    
    

## 请求包

    
    
    GET /sslcert?product=<Product>&marker=<Marker>&limit=<Limit>
    Content-Type: application/x-www-form-urlencoded
    Authorization: QBox <QBoxToken>
    
    

### 参数解释

参数 | 类型 | 含义  
---|---|---  
Product | string | 全站加速证书列表固定传参"dcdn"  
Marker | string | 用于标示从哪个位置开始获取证书列表。不填或空表示从头开始  
Limit | int | 返回的最大证书个数。默认 100  
  
## 返回包

    
    
    {
    	marker: <Marker>,
    	"certs":[{
                "certid": <CertID>,
                "name": <Name>,
        	    "common_name": <CommonName>,
                "dnsnames": <DNSNames>,  
        	    "not_before": <NotBefore>,
         	    "not_after": <NotAfter>,
                "create_time": <CreateTime>
        	}]
    }
    
    

### 参数解释

参数 | 类型 | 含义  
---|---|---  
Marker | string | 用于标示下一次从哪个位置开始获取证书列表  
CertID | string | 证书ID  
Name | string | 证书名称  
CommonName | string | 通用名称  
DNSNames | []string | DNS域名  
NotBefore | int | 生效时间  
NotAfter | int | 过期时间  
CreateTime | int | 创建时间  
  
**错误码**

错误码 | 含义  
---|---  
404908 | 无权操作该证书  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的低代码互动直播

gpt: [低代码](https://developer.qiniu.com/lowcode) > 使用文档 > 互动直播

#  互动直播

最近更新时间: 2022-07-11 10:22:12

介绍低代码互动直播使用。

以上内容是否对您有帮助？
human: 如何处理七牛云的低代码产品简介

gpt: [低代码](https://developer.qiniu.com/lowcode) > 产品简介 > 产品简介

#  产品简介

最近更新时间: 2022-09-09 09:21:24

# 基本描述

基于七牛云的音视频、直播，IM，AI 智能算法和网络等先进技术，通过低代码方式接入，帮助企业快速完成在自有
APP、小程序、网站等平台的私域电商直播间的搭建。具有接入方便，扩展性强等特性，既可以满足企业定制需求，又可以降低时间成本，快速验证直播卖货商业模式。

# 产品架构

![低代码架构.png](https://dn-odum9helk.qbox.me/FiWzeUO6E85LTkfuHbY13hD4VRvZ)

# 交付方式

![低代码交付方式.png](https://dn-odum9helk.qbox.me/FiKv0P08G1n_AJE_UiakMJWahbuj)

# 产品优势

## 低成本接入

降低音视频开发门槛，助力企业以更低成本、更高效率搭建更高质量的专属音视频应用。  
支持低代码集成，最快3步对接，10行代码上线自有品牌的互动直播间。

## 拓展性强

开源所有UI组件，客户可以按自己的需求快速个性化改造。  
低代码SDK对音视频、实时消息、直播管理、PK连麦、弹幕等模块和近百个 API 接口进行封装，开发者可按需选择模块和接口轻松进行功能组装，灵活强大

## 全场景支持

覆盖泛娱乐互动直播，电商直播带货，语聊房，互动课堂，在线监考，连麦 PK，视频交友，FM 电台，在线 KTV，一起看视频等多应用场景

## 保障业务数据安全

低代码服务端代码完全开源，客户可自主决定业务数据的存储地方，如：本地IDC机房、任意指定云服务器等。

# 解决的核心痛点

企业自建电商直播业务板块通常会有2种选择，但都会遇到一些问题：

## 对接SaaS平台直播或者使用第三方直播平台

  * 直播平台无法与既有业务系统深度融合。如原有商品、用户系统与直播系统无法对接，导致重要数据缺失或者难以形成后续的有效跟踪。
  * 功能依赖第三方或SaaS平台能力升级，难以满足业务需求。

## 搭建团队自建平台

  * 音视频能力开发难度大，研发时间长达1-2个月，传统企业音视频开发人力储备不足，无法快速上线自有电商直播产品。

以上内容是否对您有帮助？
human: 如何处理七牛云的低代码产品接入

gpt: [低代码](https://developer.qiniu.com/lowcode) > 产品简介 > 产品接入

#  产品接入

最近更新时间: 2022-09-09 09:20:09

# 系统对接流程

![低代码对接流程.png](https://dn-odum9helk.qbox.me/Fto-SQcx-3QMP207zwqWrEpluBPq)

  * 第一步：应用创建
  * 第二步：应用配置
  * 第三步：低代码接入，快速上线

# 低代码接入举例

    
    
    import com.qlive.sdk.QLive
    
    val config = QLiveConfig("serverURL")
    QLive.init(appContext, config, tokenGetter)
    QLive.auth(callback)
    QLive.setUser(QUserInfo("your avatar", "your nick", extraInfo), callback)
    QLive.getLiveUIKit().launch(context)
    

以上内容是否对您有帮助？
human: 如何处理七牛云的低代码方案推荐

gpt: [低代码](https://developer.qiniu.com/lowcode) > 产品简介 > 方案推荐

#  方案推荐

最近更新时间: 2022-09-09 09:20:02

# 互动直播方案

七牛低代码互动直播方案是基于七牛云音视频、AI智能算法和网络等先进技术，提供易接入、强扩展、高效部署和覆盖多场景的音视频服务，助力企业快速搭建高品质的互动直播，娱乐直播业务平台。

## 落地效果

![互动直播落地效果.png](https://dn-odum9helk.qbox.me/Fkp37zmHnz9PBxmyTKhnakHYGtvK)

# 电商直播方案

七牛低代码电商直播方案是基于七牛云音视频、AI智能算法和网络等先进技术，提供易接入、强扩展、高效部署和覆盖多场景的音视频服务，助力企业快速搭建高品质的专属电商直播业务平台。  
适用于以下行业的直播带货场景。

  * 平台类电商
  * 品牌类电商
  * 社区类电商

## 落地效果

![电商直播落地效果.png](https://dn-odum9helk.qbox.me/FtbrOgTTJNH4WrCp_6JuCKpNmUrI)

以上内容是否对您有帮助？
human: 如何处理七牛云的低代码互动直播

gpt: [低代码](https://developer.qiniu.com/lowcode) > API 文档 > 互动直播

#  互动直播

最近更新时间: 2022-07-11 10:15:29

互动直播低代码API 参考。

以上内容是否对您有帮助？
human: 如何处理七牛云的低代码服务端API参考

gpt: [低代码](https://developer.qiniu.com/lowcode) > API 文档 >
[互动直播](https://developer.qiniu.com/lowcode/api/12007/qlive-api) > 服务端API参考

#  服务端API参考

最近更新时间: 2022-07-21 16:07:43

介绍互动直播低代码服务端API 参考。

以上内容是否对您有帮助？
human: 如何处理七牛云的低代码服务端鉴权

gpt: [低代码](https://developer.qiniu.com/lowcode) > API 文档 >
[互动直播](https://developer.qiniu.com/lowcode/api/12007/qlive-api) >
[服务端API参考](https://developer.qiniu.com/lowcode/api/12008/qlive-server-api-
reference) > 服务端鉴权

#  服务端鉴权

最近更新时间: 2022-07-21 16:07:50

服务端接口，使用AK/SK 方式进行鉴权。

# 请求认证

## API 域名

    
    
    https://live-api.qiniu.com
    

  * 私有部署时，使用自己的域名。
  * 私有部署时，可以选择不鉴权，具体配置方式参考 [项目说明文档 __](https://github.com/pili-engineering/QNLiveKit_Server)

每一个请求均需在 HTTP 请求头部增加一个 Authorization 字段，其值为符合管理凭证的字符串，形式如下：

    
    
    Authorization: <QiniuToken>
    

## 生成管理凭证

`<QiniuToken>`: 管理凭证，用于鉴权。以golang 为例，生成方式如下：

    
    
    // golang
    
    // 构造待签名的 Data
    // 1. 添加 Path
    data = "<Method> <Path>"
    
    // 2. 添加 Query，前提: Query 存在且不为空
    if "<RawQuery>" != "" {
            data += "?<RawQuery>"
    }
    
    // 3. 添加 Host
    data += "\nHost: <Host>"
    
    // 4. 添加 Content-Type，前提: Content-Type 存在且不为空
    if "<Content-Type>" != "" {
            data += "\nContent-Type: <Content-Type>"
    }
    
    // 5. 添加回车
    data += "\n\n"
    
    // 6. 添加 Body，前提: Content-Length 存在且 Body 不为空，同时 Content-Type 存在且不为空或 "application/octet-stream"
    bodyOK := "<Content-Length>" != "" && "<Body>" != ""
    contentTypeOK := "<Content-Type>" != "" && "<Content-Type>" != "application/octet-stream"
    if bodyOK && contentTypeOK {
            data += "<Body>"
    }
    
    // 计算 HMAC-SHA1 签名，并对签名结果做 URL 安全的 Base64 编码
    sign = hmac_sha1(data, "Your_Secret_Key")
    encodedSign = urlsafe_base64_encode(sign)
    
    // 将 Qiniu 标识与 AccessKey、encodedSign 拼接得到管理凭证
    <QiniuToken> = "Qiniu " + "Your_Access_Key" + ":" + encodedSign
    
    

## 请求示例

    
    
    GET /server/auth/token HTTP/1.1
    Host: live-api.qiniu.com
    Authorization: Qiniu 7O7hf7Ld1RrC_fpZdFvU8aCgOPuhw2K4eapYOdII:PGTUV-oRxWAIl6mdneJPSJieyyQ=
    Content-Type: application/json
    

以上内容是否对您有帮助？
human: 如何处理七牛云的低代码客户端用户Token

gpt: [低代码](https://developer.qiniu.com/lowcode) > API 文档 >
[互动直播](https://developer.qiniu.com/lowcode/api/12007/qlive-api) >
[服务端API参考](https://developer.qiniu.com/lowcode/api/12008/qlive-server-api-
reference) > 客户端用户Token

#  客户端用户Token

最近更新时间: 2022-07-25 10:14:47

# 获取用户访问token

互动直播客户端，需要访问互动直播服务时，需要使用jwt 鉴权token。  
该接口用于颁发访问token。

## 路径

GET /server/auth/token

## 请求头

参数 | 说明 | 举例  
---|---|---  
Authorization | AK/SK 鉴权token | Qiniu AK:sign  
  
## Query 参数

参数 | 类型 | 必填 | 说明 | 举例  
---|---|---|---|---  
app_id | string | 是 | 互动直播的应用ID | live_app_1  
user_id | string | 是 | 客户端用户ID，唯一标识一个用户 | user_1  
device_id | string | 否 | 客户端设备ID | device_1  
expires_at | int64 | 否 | token 过期时间，秒级时间戳。默认7 天过期 | 1655882609  
  
## 返回

该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "request_id":"xxxxx", //请求ID
        "code": 0,            //错误码：0，成功；其他，失败
        "message": "success", //code 非0 时，错误原因描述
        "data": {
            "access_token":"xxx",   //客户端访问token
    		"expires_at":1655882609 //过期时间，秒级时间戳
        }
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的低代码客户端交互接口

gpt: [低代码](https://developer.qiniu.com/lowcode) > API 文档 >
[互动直播](https://developer.qiniu.com/lowcode/api/12007/qlive-api) >
[服务端API参考](https://developer.qiniu.com/lowcode/api/12008/qlive-server-api-
reference) > 客户端交互接口

#  客户端交互接口

最近更新时间: 2022-09-07 17:15:21

提供给互动直播客户端的接口。

互动直播SDK 使用这部分接口与互动直播服务进行通信。

业务APP可以使用这部分接口，进行客户端业务扩展。

# 认证方式

客户端接口，使用在请求头部，携带鉴权token的方式，来进行认证。

参数 | 说明 | 举例  
---|---|---  
Authorization | 鉴权token |   
  
## 鉴权token 获取

鉴权token，由业务服务根据用户身份来生成。

业务服务生成鉴权token，参考 [获取用户访问token
__](https://developer.qiniu.com/lowcode/12010/qlive-server-api-user-token)

# 返回结果

API 的返回结果，格式如下。

    
    
    {
        "request_id":"",  //请求ID
        "code": 0,        //错误码：0，成功；其他，失败
        "message": "",    //错误原因，当 code 非 0 时，错误原因必须携带。
        "data":{          //返回结果，具体参考每个API 定义
        }
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的低代码应用全局模块

gpt: [低代码](https://developer.qiniu.com/lowcode) > API 文档 >
[互动直播](https://developer.qiniu.com/lowcode/api/12007/qlive-api) >
[服务端API参考](https://developer.qiniu.com/lowcode/api/12008/qlive-server-api-
reference) > [客户端交互接口](https://developer.qiniu.com/lowcode/api/12188/client-
apis) > 应用全局模块

#  应用全局模块

最近更新时间: 2022-09-07 17:15:36

描述应用相关的接口。

# 获取应用配置信息

客户端请求互动直播服务相关的应用信息。

## 路径

GET /client/app/config

## 请求头

参数 | 说明 | 举例  
---|---|---  
Authorization | 鉴权token |   
  
## 返回

    
    
    {
        "request_id":"xxxxx", //请求ID
        "code": 0,            //错误码：0，成功；其他，失败
        "message": "success"  //code 非0 时，错误原因描述
        "data": {
            "im_app_id": "<im app id>"   //对应的IM 应用ID
        }
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的低代码管理员交互接口

gpt: [低代码](https://developer.qiniu.com/lowcode) > API 文档 >
[互动直播](https://developer.qiniu.com/lowcode/api/12007/qlive-api) >
[服务端API参考](https://developer.qiniu.com/lowcode/api/12008/qlive-server-api-
reference) > 管理员交互接口

#  管理员交互接口

最近更新时间: 2022-12-15 17:33:34

# 管理员登录

## 路径

GET /manager/login

## Query 参数

参数 | 类型 | 必填 | 说明 | 举例  
---|---|---|---|---  
user_name | string | 是 | 用户名 |   
password | string | 是 | 密码 |   
  
## 返回

该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "request_id":"xxxxx", //请求ID
        "code": 0,            //错误码：0，成功；其他，失败
        "message": "success", //code 非0 时，错误原因描述
        "data": {
            "access_token":"xxx",   //客户端访问token
    		"expires_at":1655882609 //过期时间，秒级时间戳
        }
    }
    

# 服务端获取管理员token

互动直播客户端，需要访问三鉴服务等，需要使用jwt 鉴权token。  
该接口用于颁发管理员访问token。

## 路径

GET /server/auth/admin/token

## 请求头

参数 | 说明 | 举例  
---|---|---  
Authorization | AK/SK 鉴权token | Qiniu AK:sign  
  
## Query 参数

参数 | 类型 | 必填 | 说明 | 举例  
---|---|---|---|---  
app_id | string | 是 | 互动直播的应用ID | live_app_1  
user_id | string | 是 | 客户端用户ID，唯一标识一个用户 | user_1  
device_id | string | 否 | 客户端设备ID | device_1  
expires_at | int64 | 否 | token 过期时间，秒级时间戳。默认7 天过期 | 1655882609  
  
## 返回

该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "request_id":"xxxxx", //请求ID
        "code": 0,            //错误码：0，成功；其他，失败
        "message": "success", //code 非0 时，错误原因描述
        "data": {
            "access_token":"xxx",   //客户端访问token
    	    "expires_at":1655882609 //过期时间，秒级时间戳
        }
    }
    

以上内容是否对您有帮助？