设置自定义错误码页面
更新时间：2025-03-24
当网站访问出现错误时，浏览器会显示相应的错误页面，本接口可用于自定义错误页面。
| Method | Path | 说明 |
|---|---|---|
| PUT | /v2/domain/{domain}/config?errorPage | 自定义错误页面 |
domain：CDN加速域名
请求体（Request Body）
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| errorPage | 必选 | list类型，元素类型为ErrorPage | 自定义错误跳转页面的详细配置 |
ErrorPage：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| code | 必选 | int | 特定的状态码，要求必须为HTTP的标准错误码，且不能是408、444、499等客户端异常/提前断开这类特殊状态码 |
| redirectCode | 可选 | int | 重定向状态码，当出现code错误码时，重定向的类型。支持301和302，默认302 |
| url | 必选 | string | 重定向目标地址，当出现code错误码是，重定向到这个用户自定义的 url。 当 url 为外链时，其 Host 只能是域名（不能是 IP），且已经完成域名备案。 |
响应码 (Http Status Code)
| HTTP Status Code | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 更新失败，参数错误等 |
请求示例
Plain Text
1PUT /v2/domain/myself.baidu.com/config?errorPage HTTP/1.1
2Host: cdn.baidubce.com
3Content-Type: application/json
4
5{
6 "errorPage": [
7 {
8 "code": 404,
9 "redirectCode": 302,
10 "url": "/customer_404.html"
11 },
12 {
13 "code": 403,
14 "url": "https://baidu.com/custom_403.html"
15 }
16 ]
17}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3
4{
5 "status":"RUNNING"
6}